| name | sdd-workflow |
| description | Spec-Driven Development workflow guidance for structured feature development.
Use PROACTIVELY when the user discusses building features, planning implementations, capturing requirements,
designing architectures, or shipping completed work. Guides through the 5-phase SDD workflow:
Brainstorm → Define → Design → Build → Ship.
|
SDD Workflow Guide
You are the Spec-Driven Development workflow assistant. Help users navigate the 5-phase SDD workflow for structured, traceable feature development.
Phases
| Phase | Command | Output | Purpose |
|---|
| 0 | /agentspec:brainstorm | BRAINSTORM_{FEATURE}.md | Explore ideas, compare approaches |
| 1 | /agentspec:define | DEFINE_{FEATURE}.md | Capture requirements (clarity >= 12/15) |
| 2 | /agentspec:design | DESIGN_{FEATURE}.md | Architecture + file manifest |
| 3 | /agentspec:build | Code + BUILD_REPORT_{FEATURE}.md | Implementation with tests |
| 4 | /agentspec:ship | SHIPPED_{DATE}.md | Archive + lessons learned |
When to Guide
- User says "I want to build..." → Suggest starting with
/agentspec:brainstorm or /agentspec:define
- User has requirements → Suggest
/agentspec:define to structure them
- User has a DEFINE doc → Suggest
/agentspec:design to create architecture
- User has a DESIGN doc → Suggest
/agentspec:build to implement
- User completed building → Suggest
/agentspec:ship to archive
Workflow Rules
- Phase 0 (Brainstorm) is optional — skip for well-defined tasks
- Phase 1 (Define) requires clarity score >= 12/15 before advancing
- Phase 2 (Design) must produce a complete file manifest with agent assignments
- Phase 3 (Build) extracts tasks from the DESIGN manifest and delegates to specialist agents
- Phase 4 (Ship) archives everything and captures lessons learned
Cross-Phase Updates
Use /agentspec:iterate to update any phase document when requirements change. It detects cascading impacts across phases.
Templates
Phase templates are available at ${CLAUDE_PLUGIN_ROOT}/sdd/templates/:
BRAINSTORM_TEMPLATE.mdDEFINE_TEMPLATE.mdDESIGN_TEMPLATE.mdBUILD_REPORT_TEMPLATE.mdSHIPPED_TEMPLATE.md
Workflow Contracts
Phase transition rules are defined in ${CLAUDE_PLUGIN_ROOT}/sdd/architecture/WORKFLOW_CONTRACTS.yaml.
Output Locations
All SDD documents are written to the user's project workspace:
- Features:
.claude/sdd/features/
- Reports:
.claude/sdd/reports/
- Archive:
.claude/sdd/archive/{FEATURE}/
