Metadata-Version: 2.4
Name: sdd-kit
Version: 1.0.1
Summary: Spec-Driven Development toolkit — AI builds from your spec, inside VS Code chat (@sdd).
Author: SDD Kit contributors
License: Apache-2.0
Project-URL: Homepage, https://github.com/dpfam27/sdd-kit
Project-URL: Repository, https://github.com/dpfam27/sdd-kit
Project-URL: Issues, https://github.com/dpfam27/sdd-kit/issues
Keywords: spec-driven,ai,vscode,copilot,scaffold,agent
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: Plugins
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.12.0
Requires-Dist: rich>=13.0.0

# 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)

```bash
pipx install sdd-kit
sdd version
sdd commands
```

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

```bash
brew install pipx
pipx ensurepath
pipx install sdd-kit
```

### Alternative (venv)

```bash
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

```bash
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):

```bash
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
