ai-sdd: AI-Assisted Spec-Driven Development

AI multiplies whatever you feed it. Feed it structure — specs, designs, tasks — and it multiplies your velocity. Feed it chaos, and it multiplies your mistakes.

ai-sdd.com · Get the Book · npm

The Problem

Every AI coding agent shares the same fundamental weakness: it cannot infer what you actually meant. It will confidently build the wrong thing, in the wrong way, at the wrong layer — unless you give it a contract first.

That contract is a specification.

The Methodology

AI-Assisted Spec-Driven Development (AI-SDD) is a structured collaboration model built on three roles:

• Director — You define intent, constraints, and approve each phase
• Executor — The AI implements within the boundaries you set
• Contract — Specs (requirements, design, tasks) are the shared language that keeps both aligned

The methodology covers the complete development lifecycle: Requirements → Design → Tasks → Implementation → Validation — with human approval gates between each phase.

The complete methodology is documented at ai-sdd.com.

The Tool

ai-sdd is the NPM package that operationalizes the AI-SDD methodology across 7 AI coding agents: Claude Code, Cursor, Gemini CLI, Codex CLI, GitHub Copilot, Qwen Code, and Windsurf.

# Install in your project (30 seconds)
cd your-project
npx ai-sdd

Once installed, /sdd: slash commands guide you and your AI agent through each phase of the spec-driven workflow.

Supports 7 agents × 12 languages.

npx ai-sdd --claude         # Claude Code [default]
npx ai-sdd --cursor         # Cursor IDE
npx ai-sdd --gemini         # Gemini CLI
npx ai-sdd --codex          # Codex CLI
npx ai-sdd --copilot        # GitHub Copilot
npx ai-sdd --qwen           # Qwen Code
npx ai-sdd --windsurf       # Windsurf IDE

npx ai-sdd --lang pt        # Portuguese (default: en)
npx ai-sdd --dry-run        # Preview without writing files

Supported languages: en, ja, zh-TW, zh, es, pt, de, fr, ru, it, ko, ar

Learn More

The full methodology, rationale, and step-by-step guidance — including how to apply SDD to brownfield projects, how to structure EARS-format requirements, and how to run multi-agent workflows — is covered in the book.

AI-Assisted SDD: Spec-Driven Development with Gemini, Claude, and ai-sdd Available in English, Portuguese, and Japanese on Amazon, Apple Books, Google Play, Kobo, and 4+ other stores worldwide.

Author

Leonardo Sampaio — Principal Architect, Computer Scientist with 20+ years of experience.

LinkedIn · ai-sdd.com

License

AI-SDD is an independent framework maintained by its author.

See LICENSE.md for full details.