Document Templates
Single source of truth for pipeline artifact structure. Every artifact the pipeline produces follows its template exactly — downstream agents parse these structures by section name and ID convention (FR-XXX, TEST-XXX, CHK###, REV-XXX), so a missing or renamed section breaks the chain, not just the style.
Usage
- Pick the template for the artifact you are about to generate (table below).
- Read it from
references/at the stage start — not all templates upfront. - Fill every section. Never invent, rename, or drop sections. Placeholders in
[BRACKETS]are replaced;MODEL INSTRUCTIONblocks guide filling and are removed from output.
Template Index
| Template | Produces | Primary consumer |
|---|---|---|
references/spec-template.md |
ai-docs/features/[name]/spec.md |
/feature, /clarify |
references/features-template.md |
ai-docs/FEATURES.md |
/feature |
references/ux-template.md |
ai-docs/features/[name]/ux.md |
feature-docs agent |
references/ui-template.md |
ai-docs/features/[name]/ui.md |
feature-docs agent |
references/plan-template.md |
ai-docs/features/[name]/plan.md |
feature-docs agent |
references/tasks-template.md |
ai-docs/features/[name]/tasks.md |
feature-docs agent |
references/checklist-template.md |
ai-docs/features/[name]/validation/[domain]-checklist.md |
/validation |
references/resolutions-template.md |
ai-docs/features/[name]/validation/resolutions.md |
/validation |
references/feedback-template.md |
ai-docs/features/[name]/feedback.md |
feature-review agent |
references/design-setup-template.md |
ai-docs/references/design-system.md, style-guide.md |
design-setup agent |
Rules
- Template structure is a contract: traceability IDs defined here are referenced across spec → tasks → validation → feedback. Keep ID formats intact.
- When an artifact is regenerated, regenerate from the template — never by mutating the previous artifact's structure.
- Existing artifacts with the old structure are updated in place only for content, never restructured mid-feature.