/spec-design#

Generate a technical design document for your feature.

Usage#

Claude Code:

/spec-design user-authentication

Antigravity:

/spec-design user-authentication
# or
@spec-design user-authentication

Description#

/spec-design reads:

• .specs/[feature-name]/spec.json
• .specs/[feature-name]/requirements.md

It then generates:

• .specs/[feature-name]/design.md
• .specs/[feature-name]/research.md (when discovery/research is needed)

What the Design Covers#

• Architecture and boundaries
• Component responsibilities and interfaces
• Data models and contracts
• System flows (Mermaid where needed)
• Error handling strategy
• Testing strategy
• Security and performance considerations (when applicable)

Output Example#

✅ Updated: .specs/user-authentication/design.md
✅ Updated: .specs/user-authentication/research.md

Notes#

• Converts requirements (what) into implementation design (how)
• Should be reviewed before task generation
• Updates phase metadata in spec.json

Next Steps#

• /spec-tasks - Generate actionable implementation tasks