Phase 3: Design
The Design phase blocks implementation until a spec exists. No coding without a plan.
What happens
Section titled “What happens”- Brainstorm approaches — Generate multiple options, weigh tradeoffs
- Write a spec — Document the chosen approach with rationale
- Get approval — Present the spec for review before proceeding
Where the spec lives
Section titled “Where the spec lives”- Issue body — Lightweight, no extra files
.agents/plans/— On the branch, deleted after mergespecs/directory — For repos using OpenSpec conventions
hs-design