{"id":50591817,"url":"https://github.com/zhijunio/sdd-lite","last_synced_at":"2026-06-05T11:01:16.448Z","repository":{"id":356440992,"uuid":"1232542071","full_name":"zhijunio/sdd-lite","owner":"zhijunio","description":"Lightweight SDD for developers — spec it, test it, ship it.","archived":false,"fork":false,"pushed_at":"2026-06-03T09:26:20.000Z","size":437,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-03T11:14:08.733Z","etag":null,"topics":["cursor","javascript","sdd","spec","spec-driven-development"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zhijunio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-08T03:13:24.000Z","updated_at":"2026-06-03T09:26:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zhijunio/sdd-lite","commit_stats":null,"previous_names":["zhijunio/sdd-lite"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zhijunio/sdd-lite","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhijunio%2Fsdd-lite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhijunio%2Fsdd-lite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhijunio%2Fsdd-lite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhijunio%2Fsdd-lite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zhijunio","download_url":"https://codeload.github.com/zhijunio/sdd-lite/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhijunio%2Fsdd-lite/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33939227,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-05T02:00:06.157Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cursor","javascript","sdd","spec","spec-driven-development"],"created_at":"2026-06-05T11:01:15.101Z","updated_at":"2026-06-05T11:01:16.435Z","avatar_url":"https://github.com/zhijunio.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sdd-lite\n\n\u003e **Lightweight SDD — spec it, test it, ship it.**\n\nSmall **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.\n\n**Core loop:** `sdd-plan` → `sdd-build` → `sdd-ship`  \n**Satellites:** `sdd-ideate` · `sdd-brainstorm` · `sdd-review` · `sdd-simplify` (optional — not a “fourth phase”)\n\n## Design stance (vs. large all-in-one packs)\n\n- **Small, forkable, composable** — one skill per directory; customize in your own repo.  \n- **Pain-driven** — pick skills where you actually slip, not after memorizing a full methodology.  \n- **Explicit handoffs** — the next phase loads only when a human or the chat says so; no black-box pipeline pacing.\n\n## Quick start\n\n1. **Install for Cursor** (pick one option under [Install](#install) below) — local plugin directory is recommended, or copy `skills/` only.  \n2. 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/`**.\n3. For one increment, **`Read`** in order: **`sdd-plan`** (Markdown only) → **`sdd-build`** → **`sdd-ship`**.\n\n## When things go wrong → which skill\n\n| Situation | What to do |\n|-----------|------------|\n| Phase unclear / first `docs/sdd` | **`Read`** [`use-sdd`](./skills/use-sdd/SKILL.md) |\n| Need to choose a direction | **`Read`** [`sdd-ideate`](./skills/sdd-ideate/SKILL.md) |\n| 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) |\n| 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 |\n| Terms keep drifting | Add **`docs/sdd/CONTEXT.md`** only when drift keeps repeating |\n\n**Note:** **`sdd-review`** can run without a plan file; **`sdd-ship` requires** `docs/sdd/plans/YYYY-MM-DD-\u003cshort-slug\u003e.md`.\n\n## Install\n\n| Method | Steps |\n|--------|--------|\n| **A Plugin (recommended)** | Clone or symlink this repo to **`~/.cursor/plugins/local/sdd-lite/`**. Reload Cursor after install. |\n| **B Skills only** | Copy each folder under `skills/` to **`~/.cursor/skills/\u003cname\u003e/`** or **`\u003crepo\u003e/.cursor/skills/`**. |\n\n```bash\nmkdir -p .cursor/skills\nfor 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\n```\n\nMore detail: **[`extension/README.md`](./extension/README.md)**\n\n## Codex\n\n- The Codex plugin manifest lives at **[`.codex-plugin/plugin.json`](./.codex-plugin/plugin.json)**.\n- It reuses the shared **`skills/`** tree.\n- **`hooks/`** stays in the repo for local plugin flows; Codex hook runtime support may vary.\n\n## Skills\n\n| Skill | Summary |\n|-------|---------|\n| [`use-sdd`](./skills/use-sdd/SKILL.md) | Meta router: priority, first-time **`docs/sdd`**, phase unclear |\n| [`sdd-ideate`](./skills/sdd-ideate/SKILL.md) | Filter vague goals into qualified directions with basis + rejection reasons |\n| [`sdd-plan`](./skills/sdd-plan/SKILL.md) | Increment plan: Markdown only + Risks/Dependencies + Test-first checklist → **STOP** |\n| [`sdd-build`](./skills/sdd-build/SKILL.md) | Strict TDD: red → green → refactor; idempotent checklist items |\n| [`sdd-ship`](./skills/sdd-ship/SKILL.md) | **Requires a plan file**; Acceptance audit, tests, commit, Ship Report |\n| [`sdd-brainstorm`](./skills/sdd-brainstorm/SKILL.md) | Brainstorm → `docs/sdd/brainstorms/` → **STOP**; never writes `docs/sdd/plans/` |\n| [`sdd-review`](./skills/sdd-review/SKILL.md) | Read-first review; fixed Review Summary with evidence strength and doc consistency |\n| [`sdd-simplify`](./skills/sdd-simplify/SKILL.md) | Behavior-preserving refactor |\n\nMaintainers: **[`AGENTS.md`](./AGENTS.md)** · **[`CONTRIBUTING.md`](./CONTRIBUTING.md)**\n\n## References\n\nBased 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).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhijunio%2Fsdd-lite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhijunio%2Fsdd-lite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhijunio%2Fsdd-lite/lists"}