A Claude Code plugin that takes a one-sentence feature description and autonomously produces a reviewed pull request. It breaks the feature into a spec, plan, tasks, implementation, verification, and code review — each handled by a dedicated AI agent — so you get structured, repeatable feature development without managing the process yourself.
Claude Code is great for ad-hoc coding tasks, but building a complete feature — with a spec, architecture decisions, task breakdown, implementation, tests, and review — requires you to drive every step. SDD Autopilot automates that entire ceremony. You describe what you want, it handles the how, and you review the PR.
# Install from Claude Code marketplace
# Search for "sdd-autopilot" and install
# Or from source:
git clone https://github.com/rubenzarroca/sdd-autopilot.git ~/.claude/plugins/local/sdd-autopilot
cd ~/.claude/plugins/local/sdd-autopilot/engine && npm install && npm run build
# Run a feature:
/sdd-auto:run health-check "Add a health check endpoint that returns server status"- Triage classifies your feature by complexity and picks the right execution mode (Express, Light, Standard, or Full)
- Spec/Plan/Tasks phases generate structured artifacts that each subsequent phase builds on
- Implementation runs one agent per task, with automatic parallelization for independent tasks
- Verification + Review catch issues before the PR — with automated fix loops if something fails
- Adaptive learning records metrics from every run and uses them to improve future runs
For the full architecture, see docs/architecture.md.
| Command | Description |
|---|---|
/sdd-auto:run [name] ["brief"] |
Run the full pipeline: triage through PR |
/sdd-auto:init |
Initialize a project (creates .sdd/state.json, scaffolds docs) |
/sdd-auto:status |
Show feature states, task progress, and score history |
The pipeline selects an execution mode automatically based on feature complexity:
| Mode | When | What runs |
|---|---|---|
| Express | Trivial changes | triage -> implement -> PR |
| Light | Low complexity | triage -> specify -> implement -> verify -> PR |
| Standard | Medium complexity | All 8 phases |
| Full | High/critical | All 8 phases + optional Opus review (--opus-review) |
Headless mode lets an external orchestrator (CI script, autonomous agent, cron job) run the SDD pipeline without human interaction, PRs, or pushes.
How to activate: pass --headless flag and set the SDD_MODE=headless environment variable.
Output contract:
- Exit code
0= success. A single atomic commit is ready on the worktree branch. - Exit code
1= failure (escalated or awaiting_input — cannot proceed without human). - Last line of stdout:
TLDR: {one sentence summary of what was done}
The external orchestrator is responsible for merge, push, and branch cleanup.
Example:
SDD_MODE=headless claude -p "/sdd-auto:run my-feature 'Add rate limiting to API'" --dangerously-skip-permissions--headless is compatible with all execution modes (Express, Light, Standard, Full) and with --skip-worktree. It implies --skip-pr — do not pass both.
- Claude Code CLI with plugin support
- Node.js 18+
gitandgh(GitHub CLI) for PR creation
- Architecture — pipeline phases, state machine, file structure
- Tools Reference — all 38 MCP tools across 4 categories
- Observability & Metacognition — learning loop, analytics, anomaly detection
- Memory Intelligence — two-layer memory model
- Changelog
MIT