Shared context templates
This directory is the only editable template library. It is copied with the
starter beside .agents/skills/. Do not duplicate templates inside individual
skills or infer approved context from templates themselves.
Documents and research sources
Plain setup selects every document below once. For a named consumer, read its
required-context declaration, including any linked reference that owns that
declaration, and select its required and conditional documents once. Do not
maintain a second consumer dependency map here. Users can also name documents
directly. This entrypoint is not itself a context document.
Source groups identify research ownership. design-system and product select
the six shared intake questions in setup-skills' references/source-workflow.md.
The repository group selects automatic, bounded, read-only research of the
current consumer checkout under that workflow, not a source/permission question.
Repository-only selection needs no intake answers. Missing repository answers or
file registrations do not block this local scope. Other groups' research is not
automatically authorized by a file being local.
Collect each applicable question once across selected documents. Preserve all
restrictions and explicit skips, including legacy repository opt-outs, and honor
content exclusions. Volunteered docs add leads, not a new required question.
Bounded proposals live in PRODUCT-DESIGN.md and apply only
where permitted, never as researched product policy.
An empty source registry does not disable automatic local research. Excluded,
missing or inaccessible evidence must produce specific limitations, not fictional
facts or replacement research against a skip.
Optional owner topics
Keep all seven root identities. Authors may keep a document whole or move
task-specific detail into directly linked owner topics when supported tasks can
skip genuinely irrelevant detail. Choose boundaries by task applicability and
cohesion: keep a decision's requirements, conditions, exceptions, examples and
citations together. Keep short, cohesive guidance whole when splitting would
only add navigation. Check evidenced consumer constraints, such as incoming
anchors or a parser that requires a particular structure, before moving content;
do not assume one consumer's constraints apply to others.
Observed oversized or truncated reads can motivate review, but file size,
consistency with other owners or a fixed topic count does not justify a split.
Splitting alone does not establish faster discovery or better task outcomes.
Preserve correct existing text and its authority and historical qualifications;
relocation is not permission to rewrite policy or claim fresh verification.
Do not physically split every template or add new owners, intake or authors.
Roots retain authority, common rules, universal obligations, known gaps and
direct links to every topic with concrete applicability conditions. New topics
use the owner's exclusive topics/<DOCUMENT-STEM>/ directory within active
context; existing linked paths need preservation and explicit inventory.
Each trigger covers normal successful work and readiness as well as relevant
failure/recovery work. For example, supported component selection, opening and
checking an ordinary preview, and adding valid fixtures must select their
applicable details before a failure occurs. Avoid read-all lists and topic chains.
Each topic keeps complete usable rules, examples, conditions, exceptions and
citations. Shared-owner links transfer ownership, not duplicate policy.
Apply setup's complete-set authoring, preservation and approval contract to
roots and topics together. Library templates are research prompts, not approved
consumer guidance or permission to activate extra files.
Location
Setup reads this library from .agents/context-templates/ in the current
prototype repository. It does not fetch or install another copy. Context
documents become active only after separate explicit approval.