| name | design |
| description | Use when the user wants epic-level technical design at .agency/work/{epic}/design.md, walking-skeleton or TDD design, or design review before tasks. Pass epic slug or ID (CHK01). Cite solution.md — do not re-narrate architecture. Do NOT use for product backlog or epics (backlog), task Gherkin (tasks), system-wide architecture (solution), ADR write (adr), code implementation (implement), or doc-only sprint-end pass (docs refine).
|
| license | MIT |
| allowed-tools | ["Read","Write","Glob","Grep"] |
| argument-hint | <mode: write|review> <epic> [--mode walking-skeleton|tdd] [--context <notes>] |
Design
Conventions
Read ../../references/web-development-conventions.md
when resolving {epic} or checking artefact boundaries.
Artefact
.agency/work/{epic}/design.md — implementation specification for one epic (walking-skeleton or TDD).
Path resolution
Default: .agency/work/{epic}/design.md. User-named paths under .agency/work/ override.
Gotchas
- Do not copy solution.md — cite
solution.md §{N.M} instead.
- Task Gherkin belongs in
tasks.md, not design (gates/slice scope only).
walking-skeleton is 2–4 pages; tdd is 5–10 — do not mix section sets.- §4 Out of scope must list what this epic explicitly did not ship.
Supporting files
Router
- Mode:
write or review.
- Resolve
{epic}.
- prompts/write.prompt.md | prompts/review.prompt.md.
write — --mode walking-skeleton|tdd.
