Cursor SDD - Spec Driven Development Framework

Spec-driven development framework for Cursor AI IDE with intelligent agents, automated planning, and systematic execution

Overview

Cursor SDD (Spec Driven Development) is a production-ready framework for Cursor AI IDE that implements spec-first development methodology. Transform specifications into working code through intelligent agents, automated planning, and systematic execution.

What is Spec Driven Development?

1. Plan First - Create detailed implementation plans before coding
2. Research - Gather technical insights with parallel researcher agents
3. Execute - Implement with fullstack-developer agents (parallel/sequential)
4. Simplify - Auto-refine code for clarity (mandatory step)
5. Test - Comprehensive testing before code review
6. Review - Quality gate with security/performance checks

Key Features

Intelligent Agent System

• 12+ Specialized Agents: Planner, Researcher, Developer, Tester, Code Reviewer, Debugger, and more
• Parallel Execution: Run multiple agents simultaneously for independent tasks
• Sequential Chaining: Complex workflows with dependent tasks handled automatically

Automation Hooks

• Privacy Protection: Automatic blocking of sensitive file access (.env, credentials)
• Context Optimization: Smart token management for efficient AI responses
• Pre-commit Guards: Security scanning and validation before file operations

Custom Commands

• /plan - Create structured implementation plans
• /code - Execute plans with parallel/sequential phases
• /fix - Intelligent bug detection and routing
• /test - Automated testing and reporting
• /debug - Systematic debugging workflow
• /review - Comprehensive code review

Structured Planning

• Timestamped plan directories with phases
• Research reports and documentation
• Progress tracking and milestones
• Integration with project docs

Quick Start

# Clone this repository
git clone https://github.com/Build-From-Zero/cursor-sdd.git
cd cursor-sdd

# Copy to your Cursor project root
cp -r .cursor/ /path/to/your-project/

# Or use as template for new projects

Project Structure

.cursor-sdd/
├── .cursor/
│   ├── agents/          # Agent definitions (12+ specialized agents)
│   ├── commands/        # Custom slash commands
│   ├── hooks/           # Automation hooks (privacy, optimization, security)
│   ├── hooks.json       # Hooks configuration
│   └── plans/           # Implementation plans with timestamps
├── docs/                # Project documentation
└── README.md            # This file

Core Workflows

1. Planning Phase

User Request → Planner Agent → Research Agents → Implementation Plan

2. Development Phase

Plan → Developer Agents → Code Simplifier → Test Suite

3. Quality Phase

Simplified Code → Tester Agent → Code Reviewer → Integration

Development Rules

• YAGNI: Build only what you need
• KISS: Keep solutions simple
• DRY: Don't repeat yourself
• File size under 200 lines for optimal context
• Kebab-case naming for self-documenting files
• Mandatory code review after testing

SEO Keywords

Spec driven development, SDD, Cursor AI IDE, specification-first development, AI development tools, automated planning, intelligent agents, code review automation, AI-assisted programming, Cursor AI configuration, development framework, AI IDE customization, software development automation, plan-driven development

Documentation

• Development Rules
• Agent Documentation
• Command Reference
• Hooks Guide

Contributing

Contributions welcome! Please read our development rules before submitting PRs.

License

MIT License - feel free to use in your projects

Links

• Cursor AI IDE
• IDE SDD Org

---

Built with Cursor AI for spec-driven developers who ship quality code.