spec-driven
Installation
SKILL.md
SpecDriven
Structured alignment before action. Capture intent, interview for gaps, produce a verifiable spec — so you build the right thing the first time.
Core Principles
- Alignment before action — Never build until "done" is defined. Vague requests produce wrong outputs.
- The user knows the WHAT, the AI finds the gaps — Brain dumps capture intent. The interview extracts what was forgotten.
- Verifiable over vague — Every requirement must have a way to check it. "Make it good" fails. "Tests pass" succeeds.
- The spec is the contract — Once agreed, the spec is the single source of truth for all downstream work.
- Spec before code — This skill runs BEFORE implementation. The spec's success criteria become your implementation checklist.
Workflow Routing
| Workflow | Trigger | File |
|---|---|---|
| BrainDump | User wants to capture raw thoughts, start a new spec, or says "brain dump" / "spec" / "scope this" | Workflows/BrainDump.md |
| SpecInterview | User has a brain dump or draft spec and wants gaps filled, or says "interview me" / "refine the spec" | Workflows/SpecInterview.md |
| GenerateSpec | User confirms interview is complete and wants the final spec written, or says "generate spec" / "write the spec" | Workflows/GenerateSpec.md |