Spec-Driven Implementation
Quick Start
- •Read the spec —
specs/NNN-feature-name.mdor the spec referenced in the task - •Implement only what it says — no extra features, no adjacent refactors
- •Modify only listed files — see "Files to Create/Modify" in the spec
- •Do not change tests — fix implementation, not tests
Constraints
- •Only modify files listed in the spec's "Files to Create/Modify" section
- •Do not add docs, READMEs, or refactors unless the spec requires them
- •Only escalate with
needs_decisionwhen truly stuck after research; prefer fixing in-scope - •Follow API Contract and Data Model from the spec exactly
Spec Format Reference
Specs follow specs/TEMPLATE.md:
- •Purpose, Requirements, API Contract, Data Model
- •Files to Create/Modify (the allowed set)
- •Acceptance Tests, Out of Scope, Decision Gates
When Tests Fail
Fix the implementation. Do NOT modify tests to make them pass.