https://github.com/zhijunio/sdd-lite
Lightweight SDD for developers — spec it, test it, ship it.
https://github.com/zhijunio/sdd-lite
cursor javascript sdd spec spec-driven-development
Last synced: 17 days ago
JSON representation
Lightweight SDD for developers — spec it, test it, ship it.
- Host: GitHub
- URL: https://github.com/zhijunio/sdd-lite
- Owner: zhijunio
- License: mit
- Created: 2026-05-08T03:13:24.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-03T09:26:20.000Z (19 days ago)
- Last Synced: 2026-06-03T11:14:08.733Z (19 days ago)
- Topics: cursor, javascript, sdd, spec, spec-driven-development
- Language: JavaScript
- Homepage:
- Size: 427 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# sdd-lite
> **Lightweight SDD — spec it, test it, ship it.**
Small **Markdown skills** for Cursor and other agents: they do not take over your workflow — **`Read` the right `SKILL.md` when needed**. Each vertical increment gets a **`docs/sdd/plans/`** contract → **`sdd-build`** (strict TDD) → **`sdd-ship`** (verify and commit). No heavy ceremony and no second mega `plan.md` to maintain by default.
**Core loop:** `sdd-plan` → `sdd-build` → `sdd-ship`
**Satellites:** `sdd-ideate` · `sdd-brainstorm` · `sdd-review` · `sdd-simplify` (optional — not a “fourth phase”)
## Design stance (vs. large all-in-one packs)
- **Small, forkable, composable** — one skill per directory; customize in your own repo.
- **Pain-driven** — pick skills where you actually slip, not after memorizing a full methodology.
- **Explicit handoffs** — the next phase loads only when a human or the chat says so; no black-box pipeline pacing.
## Quick start
1. **Install for Cursor** (pick one option under [Install](#install) below) — local plugin directory is recommended, or copy `skills/` only.
2. In your **application repo**, **`Read`** [`skills/use-sdd/SKILL.md`](./skills/use-sdd/SKILL.md), then add **`docs/sdd/README.md`** and **`docs/sdd/plans/`**.
3. For one increment, **`Read`** in order: **`sdd-plan`** (Markdown only) → **`sdd-build`** → **`sdd-ship`**.
## When things go wrong → which skill
| Situation | What to do |
|-----------|------------|
| Phase unclear / first `docs/sdd` | **`Read`** [`use-sdd`](./skills/use-sdd/SKILL.md) |
| Need to choose a direction | **`Read`** [`sdd-ideate`](./skills/sdd-ideate/SKILL.md) |
| Need a design doc | **`Read`** [`sdd-brainstorm`](./skills/sdd-brainstorm/SKILL.md) → `docs/sdd/brainstorms/` then **STOP**; then **`Read`** [`sdd-plan`](./skills/sdd-plan/SKILL.md) |
| Need to implement, review, ship, or clean up | **`Read`** [`sdd-build`](./skills/sdd-build/SKILL.md), **`sdd-review`**, **`sdd-simplify`**, or **`sdd-ship`** as needed |
| Terms keep drifting | Add **`docs/sdd/CONTEXT.md`** only when drift keeps repeating |
**Note:** **`sdd-review`** can run without a plan file; **`sdd-ship` requires** `docs/sdd/plans/YYYY-MM-DD-.md`.
## Install
| Method | Steps |
|--------|--------|
| **A Plugin (recommended)** | Clone or symlink this repo to **`~/.cursor/plugins/local/sdd-lite/`**. Reload Cursor after install. |
| **B Skills only** | Copy each folder under `skills/` to **`~/.cursor/skills//`** or **`/.cursor/skills/`**. |
```bash
mkdir -p .cursor/skills
for s in use-sdd sdd-plan sdd-build sdd-ship sdd-review sdd-simplify sdd-brainstorm sdd-ideate; do cp -R "skills/$s" ".cursor/skills/"; done
```
More detail: **[`extension/README.md`](./extension/README.md)**
## Codex
- The Codex plugin manifest lives at **[`.codex-plugin/plugin.json`](./.codex-plugin/plugin.json)**.
- It reuses the shared **`skills/`** tree.
- **`hooks/`** stays in the repo for local plugin flows; Codex hook runtime support may vary.
## Skills
| Skill | Summary |
|-------|---------|
| [`use-sdd`](./skills/use-sdd/SKILL.md) | Meta router: priority, first-time **`docs/sdd`**, phase unclear |
| [`sdd-ideate`](./skills/sdd-ideate/SKILL.md) | Filter vague goals into qualified directions with basis + rejection reasons |
| [`sdd-plan`](./skills/sdd-plan/SKILL.md) | Increment plan: Markdown only + Risks/Dependencies + Test-first checklist → **STOP** |
| [`sdd-build`](./skills/sdd-build/SKILL.md) | Strict TDD: red → green → refactor; idempotent checklist items |
| [`sdd-ship`](./skills/sdd-ship/SKILL.md) | **Requires a plan file**; Acceptance audit, tests, commit, Ship Report |
| [`sdd-brainstorm`](./skills/sdd-brainstorm/SKILL.md) | Brainstorm → `docs/sdd/brainstorms/` → **STOP**; never writes `docs/sdd/plans/` |
| [`sdd-review`](./skills/sdd-review/SKILL.md) | Read-first review; fixed Review Summary with evidence strength and doc consistency |
| [`sdd-simplify`](./skills/sdd-simplify/SKILL.md) | Behavior-preserving refactor |
Maintainers: **[`AGENTS.md`](./AGENTS.md)** · **[`CONTRIBUTING.md`](./CONTRIBUTING.md)**
## References
Based on [`superpowers`](https://github.com/obra/superpowers), [`agent-skills`](https://github.com/addyosmani/agent-skills), and [`andrej-karpathy-skills`](https://github.com/multica-ai/andrej-karpathy-skills).