SDD ToolSpec-Driven Development CLI

AI-Powered Specification Workflow with Claude Code

Get Started

View on GitHub

📋

Specification First

Write specifications before code. Specs are the source of truth, code is just an expression of specs.

🤖

AI Collaboration

Automate your workflow with Claude Code slash commands. AI assists in writing specs and implementing features.

✅

RFC 2119 Keywords

Use standard keywords (SHALL, MUST, SHOULD, MAY) to clearly define requirement levels.

🎯

GIVEN-WHEN-THEN

Define requirements using scenario-based approach for better clarity and testability.

📊

Sync Verification

Track alignment between specifications and code. Measure and improve your sync rate.

🔄

Reverse Extraction

Extract specifications from existing codebases. Perfect for brownfield projects.

Quick Start

bash

# Install
npm install -g sdd-tool

# Initialize project
sdd init

# Create your first spec
sdd new user-authentication

# Validate specs
sdd validate

Slash Commands & Skills 2.0

Use these commands in Claude Code:

Command	Description
`/sdd.start`	Start SDD workflow
`/sdd.spec`	Create/modify specification
`/sdd.plan`	Generate implementation plan
`/sdd.tasks`	Break down into tasks
`/sdd.implement`	Implement with AI assistance
`/sdd.validate`	Validate specifications

View all commands →

Each slash command (sdd.foo) also has a matching Skills 2.0 definition (sdd-foo) under .claude/skills/sdd-*/SKILL.md, generated by sdd init. Skills 2.0 are authored in English and include advanced frontmatter (allowed-tools, context, etc.) for model-routing accuracy.