sdd

SDD CLI — Spec-Driven Development with AI.

Scaffolds Node.js/TypeScript projects following Clean Architecture + DDD, generates structured specs in Markdown, and uses opencode as engine to produce consistent, high-quality code.

Install

npm install -g sdd

Usage

# Create a new project
sdd init

# Add a feature (wizard → spec → opencode generates code)
sdd feature create-order

# Refactor an existing feature
sdd refactor order-service

# Fix a bug (spec + code + regression test)
sdd bugfix "login fails with special chars"

# Validate project integrity
sdd validate

# List all specs and their status
sdd list --status

# Show development backlog — what is missing and what to do next
sdd backlog

Commands

| Command | Description | |---------|-------------| | init | Initialize a new SDD project (6-phase wizard) | | feature | Create a new feature with spec + implementation | | refactor | Refactor existing feature via spec update | | bugfix | Fix a bug following SDD workflow | | validate | Validate project integrity — spec vs code | | list | List all specs and their status | | tasks | List and manage pending/failed tasks | | backlog | Show development backlog — what is missing and what to do next |

How it works

1. Wizard — interactive prompts gather requirements
2. Spec — structured Markdown spec is generated (source of truth)
3. Opencode — pre-configured prompts call opencode to implement
4. Guardrails — AGENTS.md, skills, husky hooks prevent bad code

License

MIT