SDD Cursor Commands v4.1

Spec-Driven Development for Cursor IDE

Create specifications before code. Plan-approve-execute for all operations.

Quick Start • Commands • Subagents & Skills • Contributing

---

What's New in v4.1

• Native Subagents - 6 specialized agents for parallel execution (no MCP required)
• Folder-Based Skills - Progressive loading with references, scripts, and assets
• Automatic Verification - sdd-verifier runs after every implementation
• Cursor 2.4+ Optimized - Full subagent and skill support

---

Quick Start

# Clone
git clone https://github.com/madebyaris/spec-kit-command-cursor.git

# Quick planning (80% of features)
/brief user-auth JWT authentication with login/logout

# Full project roadmap with parallel execution
/sdd-full-plan blog-platform Full-featured blog with CMS

# Execute tasks in parallel
/execute-parallel blog-platform

---

Commands

Planning

Command	Purpose	Output
/brief	30-min quick planning	feature-brief.md
/research	Pattern investigation	research.md
/specify	Detailed requirements	spec.md
/plan	Technical architecture	plan.md
/tasks	Task breakdown	tasks.md
/generate-prd	PRD via Socratic questions	full-prd.md
/sdd-full-plan	Complete project roadmap	roadmap.json + tasks

Execution

Command	Purpose
/implement	Execute implementation with todo tracking
/execute-task	Run single task from roadmap
/execute-parallel	Parallel execution via native subagents

Maintenance

Command	Purpose
/evolve	Update specs with discoveries
/refine	Iterate on specs through discussion
/upgrade	Brief → Full SDD planning
/audit	Compare implementation against specs
/generate-rules	Auto-generate coding rules

---

Subagents & Skills

Subagents (.cursor/agents/)

Specialized agents with isolated context for parallel execution:

Subagent	Model	Purpose
sdd-explorer	fast	Codebase discovery
sdd-planner	inherit	Architecture design
sdd-implementer	inherit	Code generation
sdd-verifier	fast	Validation after implementation
sdd-reviewer	fast	Security & performance review
sdd-orchestrator	inherit	Parallel task coordination

Skills (.cursor/skills/)

Auto-invoked domain knowledge packages:

Skill	Auto-Invoke When
sdd-research	Technical approach unclear
sdd-planning	Spec exists, need plan
sdd-implementation	Plan ready for execution
sdd-audit	Code review requested
sdd-evolve	Discoveries during development

Each skill folder contains:

sdd-[name]/
├── SKILL.md          # Core instructions
├── references/       # Loaded on demand
├── scripts/          # Executable helpers
└── assets/           # Templates

---

Workflows

Quick Planning (80% of features)

/brief → /evolve → /refine

Full Planning (complex features)

/research → /specify → /plan → /tasks → /implement

Project Roadmap with Parallel Execution

/sdd-full-plan → /execute-parallel

Automated Execution

# Execute until complete
/execute-task epic-001 --until-finish

# Create and execute entire project
/sdd-full-plan my-project --until-finish

---

Project Structure

.cursor/
├── agents/           # Subagents (6 specialized)
├── skills/           # Skills (5 with progressive loading)
├── commands/         # Slash commands
└── rules/            # Always-applied rules

specs/
├── active/           # Features in development
├── todo-roadmap/     # Project roadmaps with DAG
└── completed/        # Delivered features

---

Contributing

• Report bugs
• Suggest features
• Submit PRs

Acknowledgments

Thanks to ClavixDev for valuable ideas and suggestions!

License

MIT License - see LICENSE

---

Made with ❤️ by Aris

/brief hello-world Create a simple hello world feature