Open Source · MIT Licensed

A framework for
Spec-Driven
Development.

Enhance your AI coding tool with a structured, spec-driven delivery workflow. Move through ordered phases — specification, clarification, planning, task generation — and only then implementation. Quality built in, not bolted on.

Get Started View on GitHub
Works with: GitHub Copilot Claude Code Windsurf Antigravity OpenCode
sdd-pilot
# Initialize project governance
❯ /sddp-init Initialize project governance using attached PRD
# Walk through the SDD lifecycle
❯ /sddp-specify Build user auth with email/password
❯ /sddp-clarify
❯ /sddp-plan
❯ /sddp-checklist
❯ /sddp-tasks
❯ /sddp-analyze
❯ /sddp-implement
✓ All 24 tasks completed. Feature implemented.
❯

Built for Structured Delivery

Every feature moves through enforced phases. Each phase has a dedicated AI agent, structured artifacts, and quality gates.

Phase-Gated Workflow

Enforced order prevents skipping steps. You can't plan without a spec, can't implement without tasks. Gates keep you honest.

Specialized AI Agents

Each phase has a dedicated persona — Product Manager, Architect, QA Engineer, Project Manager — plus 14 sub-agents for delegation.

Requirement Traceability

Tasks link to functional requirements ({FR-###}) and user stories ([US#]). Nothing gets lost between spec and code.

Ambiguity Detection

Five pattern-based strategies (Adverb Trap, Passive Voice, Unspecified Scale, Missing Failure Mode, Scope Creep Detector) catch vagueness before it becomes bugs.

Quality Checklists

"Unit Tests for English" — checklists that test requirements quality, not code behavior. Auto-evaluated with PASS / RESOLVE / ASK outcomes.

Resumable Implementation

Interrupted? Re-run /sddp-implement — completed tasks are automatically skipped. Pick up where you left off.

Multi-Tool Architecture

Shared, tool-agnostic skill files power GitHub Copilot, Claude Code, Windsurf, Antigravity, and OpenCode through thin wrapper layers.

Compliance Analysis

Cross-artifact consistency checks: spec vs. plan alignment, plan vs. tasks alignment, project instructions compliance — up to 50 findings with severity levels.

Online Research

A dedicated Technical Researcher agent fetches best practices, official docs, and industry standards from the web — then distills findings into a concise research.md so your plan is evidence-backed.

How It Works

Every feature follows a strict, phase-gated lifecycle. Each phase produces structured artifacts and must pass quality gates before the next phase can begin.

0 · Init 1 · Specify 2 · Clarify 3 · Plan 4 · Checklist 5 · Tasks 6 · Analyze 7 · Implement
%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#BB86FC', 'primaryTextColor': '#121212', 'primaryBorderColor': '#985EFF', 'lineColor': '#6A6A6A', 'secondaryColor': '#1E1E1E', 'tertiaryColor': '#03DAC6', 'background': '#1E1E1E', 'mainBkg': '#1E1E1E', 'nodeBorder': '#333', 'clusterBkg': '#121212', 'titleColor': '#E0E0E0', 'edgeLabelBackground': '#1E1E1E' }}}%% graph LR A["🚀 /sddp-init"] --> B["📋 /sddp-specify"] B --> C["🔍 /sddp-clarify"] C --> D["🏗 /sddp-plan"] D --> E["✅ /sddp-checklist"] E --> F["📝 /sddp-tasks"] F --> G["📊 /sddp-analyze"] G --> H["⚡ /sddp-implement"] H --> I(("✓ Working Code")) style A fill:#7C4DFF,stroke:#BB86FC,color:#fff style B fill:#448AFF,stroke:#82B1FF,color:#fff style C fill:#FF6E40,stroke:#FFAB91,color:#fff style D fill:#00897B,stroke:#03DAC6,color:#fff style E fill:#8E24AA,stroke:#CE93D8,color:#fff style F fill:#E53935,stroke:#CF6679,color:#fff style G fill:#0288D1,stroke:#80D8FF,color:#fff style H fill:#37474F,stroke:#B0BEC5,color:#fff style I fill:#00C853,stroke:#69F0AE,color:#121212
Specify

Product Manager agent captures WHAT users need and WHY. Produces spec.md with prioritized user stories and functional requirements.

Clarify

Business Analyst agent detects ambiguity using 5 pattern-based strategies. Asks targeted questions and encodes answers directly into the spec.

Plan

Software Architect agent designs the technical approach. Produces plan.md, research.md, data models, and API contracts.

Implement

Software Engineer agent executes tasks phase-by-phase. Completed tasks marked [X] are skipped on re-run. Fully resumable.

Structured Artifacts,
Full Traceability

Every feature produces a complete set of traceable documents. Requirements link to tasks, tasks link to code. Nothing falls through the cracks.

  • spec.md — User stories, functional requirements, success criteria
  • plan.md — Architecture decisions, data models, API contracts
  • tasks.md — Phased task list with FR links and parallelism flags
  • checklists/ — "Unit Tests for English" quality verification 
specs/00001-user-auth/
├── spec.md          # Feature specification
├── plan.md          # Implementation plan
├── tasks.md         # Phased task list
├── research.md      # Technology research
├── data-model.md    # Entity definitions
├── quickstart.md    # Integration guide
├── contracts/       # API contracts
│   └── auth-api.md
└── checklists/      # Quality checklists
    ├── spec-quality.md
    └── plan-quality.md

Getting Started

Up and running in under 5 minutes. Choose your preferred AI tool and start building features the spec-driven way.

1

Install the framework

Use the GitHub template or download the release for your AI tool.

# Option A: Use the GitHub template
# Click "Use this template" at github.com/attilaszasz/sdd-pilot

# Option B: Download a tool-specific release
gh release download --repo attilaszasz/sdd-pilot \
  --pattern "sdd-pilot-copilot-*.zip" --dir .
unzip sdd-pilot-copilot-*.zip -d my-project
2

Initialize project governance

Define the non-negotiable principles that all downstream agents will enforce.

# Set up project-instructions.md with your principles
/sddp-init My project is a Node.js monorepo using TypeScript.
Principles:
  1. Test-Driven Development is mandatory.
  2. All APIs must be RESTful.
  3. No direct database access from controllers.
3

Create a feature branch and specify

Start the SDD lifecycle with a natural-language feature description.

# Create a feature branch
git checkout -b 00001-user-auth

# Specify what you want to build
/sddp-specify Build user authentication with email/password,
  including registration, login, and password reset.

# Clarify any ambiguity
/sddp-clarify
4

Plan, task, and implement

Walk through the remaining phases. Each command produces structured artifacts and enforces quality gates.

# Design the technical approach
/sddp-plan

# Generate quality checklists (optional but recommended)
/sddp-checklist

# Decompose into dependency-ordered tasks
/sddp-tasks

# Run compliance analysis (optional but recommended)
/sddp-analyze

# Execute implementation — fully resumable
/sddp-implement

Commands at a Glance

Eight commands. One structured lifecycle. Every command maps to a specialized AI agent.

Command Agent Produces
/sddp-init Project Initializer project-instructions.md
/sddp-specify Product Manager spec.md
/sddp-clarify Business Analyst Updated spec.md
/sddp-plan Software Architect plan.md, research.md
/sddp-checklist QA Engineer checklists/*.md
/sddp-tasks Project Manager tasks.md
/sddp-analyze Compliance Auditor Markdown report
/sddp-implement Software Engineer Source code