Problem
The speckit strategy Phase 2 and Phase 3 outputs write to a hand-authored \specs/{feature}/spec.md\ and \specs/{feature}/plan.md. On the \phase2/vbrief-cutover\ branch, \�brief/specification.vbrief.json\ is the source of truth and \SPECIFICATION.md\ is a rendered output via \ ask spec:render. The \specs/\ folder should never be created.
Expected Behavior
- speckit Phase 2 (WHAT/WHY) writes narratives directly to \�brief/specification.vbrief.json\
- speckit Phase 3 (HOW) enriches the same \�brief/specification.vbrief.json\ with architecture/plan narratives
- \ ask spec:render\ produces \SPECIFICATION.md\ as a rendered read-only export
- The \specs/\ directory is never created by speckit
Actual Behavior
\deft/strategies/speckit.md\ Phase 2 and Phase 3 instruct the agent to create \specs/{feature}/spec.md\ and \specs/{feature}/plan.md\ as hand-authored artifacts, bypassing \�brief/specification.vbrief.json\ entirely.
Fix
Update \deft/strategies/speckit.md:
- Phase 2 output: write WHAT/WHY content as narratives to \�brief/specification.vbrief.json\
- Phase 3 output: enrich \�brief/specification.vbrief.json\ with HOW narratives (Architecture, TechDecisions, etc.)
- Remove all references to creating \specs/\ directory or \spec.md/\plan.md\ files
- After Phase 3, instruct agent to run \ ask spec:render\ to produce \SPECIFICATION.md\ for human review
Branch
Targets: \phase2/vbrief-cutover
Related: #361 (speckit Phase 1 same pattern — project.md vs PROJECT-DEFINITION.vbrief.json), #336
Problem
The speckit strategy Phase 2 and Phase 3 outputs write to a hand-authored \specs/{feature}/spec.md\ and \specs/{feature}/plan.md. On the \phase2/vbrief-cutover\ branch, \�brief/specification.vbrief.json\ is the source of truth and \SPECIFICATION.md\ is a rendered output via \ ask spec:render. The \specs/\ folder should never be created.
Expected Behavior
Actual Behavior
\deft/strategies/speckit.md\ Phase 2 and Phase 3 instruct the agent to create \specs/{feature}/spec.md\ and \specs/{feature}/plan.md\ as hand-authored artifacts, bypassing \�brief/specification.vbrief.json\ entirely.
Fix
Update \deft/strategies/speckit.md:
Branch
Targets: \phase2/vbrief-cutover
Related: #361 (speckit Phase 1 same pattern — project.md vs PROJECT-DEFINITION.vbrief.json), #336