// 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.
Generate beautiful, self-contained HTML pages that visually explain systems, code changes, plans, and data. Use when the user asks for a diagram, architecture overview, diff review, plan review, project recap, comparison table, or any visual explanation of technical concepts. Also use proactively when you are about to render a complex ASCII table (4+ rows or 3+ columns) — present it as a styled HTML page instead.
Generate beautiful, self-contained HTML pages that visually explain systems, code changes, plans, and data. Use when the user asks for a diagram, architecture overview, diff review, plan review, project recap, comparison table, or any visual explanation of technical concepts. Also use proactively when you are about to render a complex ASCII table (4+ rows or 3+ columns) — present it as a styled HTML page instead.
Intelligent agent routing -- automatically matches tasks to the best specialist agent based on file patterns, intent keywords, and domain context. Loaded every session to give Claude explicit routing rules for all 58 AgentSpec agents.
Intelligent agent routing -- automatically matches tasks to the best specialist agent based on file patterns, intent keywords, and domain context. Loaded every session to give Claude explicit routing rules for all 58 AgentSpec agents.
Create Excalidraw diagram JSON files that make visual arguments. Use when the user wants to visualize workflows, architectures, or concepts.
Data engineering expertise for pipelines, schemas, data quality, SQL, lakehouse, and streaming. Use PROACTIVELY when the user discusses data pipelines, ETL/ELT, schema design, dimensional modeling, data quality checks, SQL optimization, dbt models, Spark jobs, Airflow DAGs, streaming pipelines, lakehouse architecture, or data contracts.
| 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. |
You are the Spec-Driven Development workflow assistant. Help users navigate the 5-phase SDD workflow for structured, traceable feature development.
| 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 |
/agentspec:brainstorm or /agentspec:define/agentspec:define to structure them/agentspec:design to create architecture/agentspec:build to implement/agentspec:ship to archiveUse /agentspec:iterate to update any phase document when requirements change. It detects cascading impacts across phases.
Phase templates are available at ${CLAUDE_PLUGIN_ROOT}/sdd/templates/:
BRAINSTORM_TEMPLATE.mdDEFINE_TEMPLATE.mdDESIGN_TEMPLATE.mdBUILD_REPORT_TEMPLATE.mdSHIPPED_TEMPLATE.mdPhase transition rules are defined in ${CLAUDE_PLUGIN_ROOT}/sdd/architecture/WORKFLOW_CONTRACTS.yaml.
All SDD documents are written to the user's project workspace:
.claude/sdd/features/.claude/sdd/reports/.claude/sdd/archive/{FEATURE}/