Package Exports
- ai-sdd/dist/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ai-sdd) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
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-sddOnce 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 filesSupported 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.
License
AI-SDD is an independent framework maintained by its author.
See LICENSE.md for full details.