sdd-kit 1.0.1

Spec-Driven Development toolkit — AI builds from your spec, inside VS Code chat (@sdd).

sdd-kit

Spec-Driven Development for any Next.js project. Drive your entire dev process — from constitution through deploy — with high-quality .md files and AI agents.

Install

Recommended (pipx)

pipx install sdd-kit
sdd version
sdd commands

If you don't have pipx yet (macOS/Homebrew):

brew install pipx
pipx ensurepath
pipx install sdd-kit

Alternative (venv)

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U pip
python -m pip install -U sdd-kit
sdd version

Then reload VS Code: Cmd+Shift+P → Developer: Reload Window

New project

sdd init my-app
cd my-app
npx create-next-app@latest . --typescript --tailwind --app --no-src-dir --import-alias '@/*'
code .

In VS Code Copilot Chat, run in Copilot Chat:

/sdd.init

Then run the core flow:

/sdd.constitution
/sdd.specify a task manager with categories
/sdd.data-model
/sdd.plan
/sdd.tasks
/sdd.implement all

Existing project

Open your existing project in VS Code, then start the same way in Copilot Chat:

/sdd.init

*If Copilot doesn't recognize /sdd.* commands, run this once in the project root (terminal):

cd my-existing-project
sdd onboard

Then run the same core flow as above.

Commands

Core (run in this order)

Command	Produces
/sdd.constitution	.sdd/CONSTITUTION.md — governing principles, locked stack, quality bar
/sdd.specify <desc>	.sdd/SPEC.md — user stories, pages, acceptance criteria
/sdd.data-model	.sdd/DATA-MODEL.md — full Prisma schema
/sdd.plan	.sdd/PLAN.md — files to create, server actions, traceability
/sdd.tasks	.sdd/TASKS.md — atomic, ordered task checklist
/sdd.taskstoissues	.github/SDD-ISSUES.md or GitHub issues
/sdd.implement	Project files written

Optional

Command	Produces
/sdd.ux	.sdd/UX.md — user flows, states, copy
/sdd.design	.sdd/DESIGN.md — tokens, typography, responsive rules
/sdd.security	.sdd/SECURITY.md — threat model, auth rules
/sdd.test	.sdd/TEST.md — unit + integration + E2E test plan
/sdd.review	.sdd/REVIEW.md — code review against the spec
/sdd.deploy	.sdd/DEPLOY.md — env vars, migrations, rollback

How it works

Two folders ship with the kit:

• .sdd/skills/ — agent skill files. Copilot reads to know how to execute each command.
• .sdd/templates/ — blank .md templates. Copied into .sdd/ and filled in when commands run.

Plus .github/copilot-instructions.md — the router that tells Copilot which skill to load for each slash command.

Locked stack

• Next.js 14 (app router) · TypeScript strict
• Tailwind + shadcn/ui
• NextAuth v5 · Prisma · SQLite dev / Postgres prod
• Server actions · react-hook-form + zod
• Deploy on Vercel

Requirements

• Python 3.10+
• Node.js 18+
• VS Code with GitHub Copilot