{"_id":"@dariomazzitelli/sdd-skills","_rev":"5-91133825abe5a1a8b40426c5ea6ece91","name":"@dariomazzitelli/sdd-skills","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@dariomazzitelli/sdd-skills","version":"0.1.0","keywords":["claude","claude-code","skills","sdd","spec-driven-development","agent","workflow"],"author":{"name":"Dario Mazzitelli"},"license":"MIT","_id":"@dariomazzitelli/sdd-skills@0.1.0","maintainers":[{"name":"dariomazz","email":"dariomazzitelli.replik@gmail.com"}],"homepage":"https://github.com/dariomazzitellireplik-coder/sdd-skills#readme","bugs":{"url":"https://github.com/dariomazzitellireplik-coder/sdd-skills/issues"},"bin":{"sdd-skills":"bin/cli.js"},"dist":{"shasum":"a7a13780d031e7263e644b42c273b9d68655aa2c","tarball":"https://registry.npmjs.org/@dariomazzitelli/sdd-skills/-/sdd-skills-0.1.0.tgz","fileCount":28,"integrity":"sha512-BgOsvQkQXZCDGruQNflI63dM1j/9iICkNk84sL5jcvdCX/3X8cFtwTNrqndISqolJw3MECSAZhCJQw7ewhDQCg==","signatures":[{"sig":"MEYCIQDD1aj3sxRmeGI3KiWqhMmQ7JS/ooGgMGyAxfBspo9nwgIhAOe1NtQV6IkOfXetuTr+QZ6lTpR7DXsZH3AykrV85Psr","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":91589},"engines":{"node":">=18"},"gitHead":"0f46e337817daab5655f834c127d8f8223f8c5a2","scripts":{"test":"node bin/cli.js help > /dev/null && echo OK"},"_npmUser":{"name":"dariomazz","email":"dariomazzitelli.replik@gmail.com"},"repository":{"url":"git+https://github.com/dariomazzitellireplik-coder/sdd-skills.git","type":"git"},"_npmVersion":"11.6.2","description":"A 9-phase Spec-Driven Development workflow for Claude Code, distributed as installable skills.","directories":{},"_nodeVersion":"24.12.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sdd-skills_0.1.0_1777158817874_0.6460663185355024","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@dariomazzitelli/sdd-skills","version":"0.1.1","keywords":["claude","claude-code","skills","sdd","spec-driven-development","agent","workflow"],"author":{"name":"Dario Mazzitelli"},"license":"MIT","_id":"@dariomazzitelli/sdd-skills@0.1.1","maintainers":[{"name":"dariomazz","email":"dariomazzitelli.replik@gmail.com"}],"homepage":"https://github.com/dariomazzitellireplik-coder/sdd-skills#readme","bugs":{"url":"https://github.com/dariomazzitellireplik-coder/sdd-skills/issues"},"bin":{"sdd-skills":"bin/cli.js"},"dist":{"shasum":"e300f8eb52a8717994989472214aaf4807ce9b27","tarball":"https://registry.npmjs.org/@dariomazzitelli/sdd-skills/-/sdd-skills-0.1.1.tgz","fileCount":28,"integrity":"sha512-cYv6vxYyHBAbWnUfaU7W844j16w+blwIn/kInzo8BPL/9J1OUdOIvH0s1sqIRIuA55R6oSz7d/mlRhHQ931isA==","signatures":[{"sig":"MEUCIQDcWomd21APLb0jIP1edyOOscVxY+Ezm6hROXphsCzt4AIgHIxPG1PeR3zJld2Aq+NCUkUCB+/wHtptb1IPNFmcD6k=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@dariomazzitelli%2fsdd-skills@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":91589},"engines":{"node":">=18"},"gitHead":"06b5d741b165db49c66277a79c3c171583bf84f3","scripts":{"test":"node bin/cli.js help > /dev/null && echo OK"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:b37d8137-5ab4-4409-a81c-64379a94c4b8"}},"repository":{"url":"git+https://github.com/dariomazzitellireplik-coder/sdd-skills.git","type":"git"},"_npmVersion":"11.5.2","description":"A 9-phase Spec-Driven Development workflow for Claude Code, distributed as installable skills.","directories":{},"_nodeVersion":"22.22.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sdd-skills_0.1.1_1777160695075_0.5960276452315032","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@dariomazzitelli/sdd-skills","version":"0.2.0","keywords":["claude","claude-code","skills","sdd","spec-driven-development","agent","workflow"],"author":{"name":"Dario Mazzitelli"},"license":"MIT","_id":"@dariomazzitelli/sdd-skills@0.2.0","maintainers":[{"name":"dariomazz","email":"dariomazzitelli.replik@gmail.com"}],"homepage":"https://github.com/dariomazzitellireplik-coder/sdd-skills#readme","bugs":{"url":"https://github.com/dariomazzitellireplik-coder/sdd-skills/issues"},"bin":{"sdd-skills":"bin/cli.js"},"dist":{"shasum":"89527fcb68855184209777a46a46ae1d27c8047e","tarball":"https://registry.npmjs.org/@dariomazzitelli/sdd-skills/-/sdd-skills-0.2.0.tgz","fileCount":33,"integrity":"sha512-B8elDtlojaay5+nkqOLN9/ziTe0oQuQHGEdCVPdjIdfrgAcpDT/7A3ftfJ7z0hhHut3aItdebcEDdrP5N1T8CQ==","signatures":[{"sig":"MEQCIGB2yjg48KJwH3RaWSCQVPEXfqj/1yZ0cj2rJNG2VSDlAiASOuCIAgrkqmceRq7WqoXGrQLEnsT+ZLZ8VphuXnQrdw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@dariomazzitelli%2fsdd-skills@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":103459},"engines":{"node":">=18"},"gitHead":"6953f455ea74c71d0b7967a88cbb107f58fc167a","scripts":{"test":"node bin/cli.js help > /dev/null && echo OK"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:b37d8137-5ab4-4409-a81c-64379a94c4b8"}},"repository":{"url":"git+https://github.com/dariomazzitellireplik-coder/sdd-skills.git","type":"git"},"_npmVersion":"11.5.2","description":"A 9-phase Spec-Driven Development workflow for Claude Code, distributed as installable skills.","directories":{},"_nodeVersion":"22.22.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sdd-skills_0.2.0_1777320644495_0.49014530916380705","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@dariomazzitelli/sdd-skills","version":"0.2.1","keywords":["claude","claude-code","skills","sdd","spec-driven-development","agent","workflow"],"author":{"name":"Dario Mazzitelli"},"license":"MIT","_id":"@dariomazzitelli/sdd-skills@0.2.1","maintainers":[{"name":"dariomazz","email":"dariomazzitelli.replik@gmail.com"}],"homepage":"https://github.com/dariomazzitellireplik-coder/sdd-skills#readme","bugs":{"url":"https://github.com/dariomazzitellireplik-coder/sdd-skills/issues"},"bin":{"sdd-skills":"bin/cli.js"},"dist":{"shasum":"5f5296b5126e7760c183dcfe3aaf14bdaaf69edb","tarball":"https://registry.npmjs.org/@dariomazzitelli/sdd-skills/-/sdd-skills-0.2.1.tgz","fileCount":34,"integrity":"sha512-VAg2KH1cBOHr9J41iqfdaqkUjePYWWCNAyCwZUW31pALg/KlPOCEBt9Tm58klrZuiUSapoJRlxkLmOS/Puo4eg==","signatures":[{"sig":"MEUCIDDaeKapV0FBkmLADzuYyzjCU61HOQTzPvocpAoXk0qzAiEA0Prj/yIILHqDOfBWekz8cuKH3Mp4L711SonZdnNTQnY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@dariomazzitelli%2fsdd-skills@0.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":108189},"engines":{"node":">=18"},"gitHead":"9cafa0c78184c14b45f5dd64c9be9b3094c2cf41","scripts":{"test":"node bin/cli.js help > /dev/null && echo OK"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:b37d8137-5ab4-4409-a81c-64379a94c4b8"}},"repository":{"url":"git+https://github.com/dariomazzitellireplik-coder/sdd-skills.git","type":"git"},"_npmVersion":"11.5.2","description":"A 9-phase Spec-Driven Development workflow for Claude Code, distributed as installable skills.","directories":{},"_nodeVersion":"22.22.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sdd-skills_0.2.1_1777323169483_0.4585297155740431","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@dariomazzitelli/sdd-skills","version":"0.2.2","description":"A 9-phase Spec-Driven Development workflow for Claude Code, distributed as installable skills.","bin":{"sdd-skills":"bin/cli.js"},"scripts":{"test":"node bin/cli.js help > /dev/null && echo OK"},"keywords":["claude","claude-code","skills","sdd","spec-driven-development","agent","workflow"],"author":{"name":"Dario Mazzitelli"},"license":"MIT","engines":{"node":">=18"},"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/dariomazzitellireplik-coder/sdd-skills.git"},"homepage":"https://github.com/dariomazzitellireplik-coder/sdd-skills#readme","bugs":{"url":"https://github.com/dariomazzitellireplik-coder/sdd-skills/issues"},"_id":"@dariomazzitelli/sdd-skills@0.2.2","gitHead":"529a30a26ffac3d2dbcc2aadfe09b79036370d3e","_nodeVersion":"22.22.2","_npmVersion":"11.5.2","dist":{"integrity":"sha512-dVaGgHFan/zHsh77ySHXp/3kJkOtW4darh48PXwIQMvAu8NvNdFYqBd1WfY40/jFB9ZY7R3KCTCOO2qkgq36Lw==","shasum":"9f6b31ffefd54580f03db877ba7b84273b948398","tarball":"https://registry.npmjs.org/@dariomazzitelli/sdd-skills/-/sdd-skills-0.2.2.tgz","fileCount":34,"unpackedSize":108365,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@dariomazzitelli%2fsdd-skills@0.2.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCRD/QXD8E/zr65WOY868KyRtJdDwD1ClleKB7LLQSP/AIhANHeMwHhxKPu5BrDbxmoOC7CLfd9/XNEQgWQQylA4u0d"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:b37d8137-5ab4-4409-a81c-64379a94c4b8"}},"directories":{},"maintainers":[{"name":"dariomazz","email":"dariomazzitelli.replik@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdd-skills_0.2.2_1777335644367_0.48516544825579877"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-25T23:13:37.762Z","modified":"2026-04-28T00:20:44.946Z","0.1.0":"2026-04-25T23:13:38.036Z","0.1.1":"2026-04-25T23:44:55.203Z","0.2.0":"2026-04-27T20:10:44.638Z","0.2.1":"2026-04-27T20:52:49.625Z","0.2.2":"2026-04-28T00:20:44.585Z"},"bugs":{"url":"https://github.com/dariomazzitellireplik-coder/sdd-skills/issues"},"author":{"name":"Dario Mazzitelli"},"license":"MIT","homepage":"https://github.com/dariomazzitellireplik-coder/sdd-skills#readme","keywords":["claude","claude-code","skills","sdd","spec-driven-development","agent","workflow"],"repository":{"type":"git","url":"git+https://github.com/dariomazzitellireplik-coder/sdd-skills.git"},"description":"A 9-phase Spec-Driven Development workflow for Claude Code, distributed as installable skills.","maintainers":[{"name":"dariomazz","email":"dariomazzitelli.replik@gmail.com"}],"readme":"# sdd-skills\n\n> A 9-phase **Spec-Driven Development** workflow for [Claude Code](https://claude.ai/code), distributed as installable skills.\n\nYou write the requirement. Claude grills you on it. Then it researches, plans, executes, reviews, documents, and ships — pausing for your approval between phases. State is persisted on disk in `features/<name>/` so any session can pick up where the last one left off.\n\nNo magic, no auto-advance. Just a disciplined pipeline that forces depth before code.\n\n```\ninit ─→ requirement ─→ research ─→ plan ─→ execute ─→ review ─→ docs ─→ ship ─→ done\n```\n\n## Install\n\nPick **one** of the two patterns:\n\n### Global (recommended) — skills available in every project\n\n```bash\nnpx @dariomazzitelli/sdd-skills install\n```\n\nInstalls the 9 SDD skills + 5 companion utilities to `~/.claude/skills/` and the SDD reference docs (templates, SPEC, HOWTO) to `./.claude/sdd/` in the current project.\n\n### Local — everything scoped to one project\n\n```bash\nnpx @dariomazzitelli/sdd-skills install --local\n```\n\nInstalls both skills and docs under `./.claude/`. Useful when you want a project to be self-contained or pin a specific SDD version per repo.\n\n### Why the split?\n\nSkills are reusable across projects, so they default to your home dir. The `sdd/` directory holds **templates** (`requirement.md`, `execution_plan.md`, `state.md`, etc.) that the skills reference using project-relative paths — those, plus your `features/` working state, naturally belong in the project. `--local` keeps both together if you prefer.\n\n## Quick start\n\n```bash\n# 1. Install\nnpx @dariomazzitelli/sdd-skills install\n\n# 2. Add features/ to your repo's .gitignore\necho \"features/\" >> .gitignore\n\n# 3. Open Claude Code in your project and run:\n/sdd-init my-feature\n/sdd-requirement\n/sdd-research\n/sdd-plan\n/sdd-execute\n/sdd-review\n/sdd-docs\n/sdd-ship\n```\n\nEach command pauses for your approval before advancing. Run `/sdd-status` anytime to see active features.\n\n## The 9 phases\n\n| Phase | Skill | What it produces |\n|---|---|---|\n| 0 | `sdd-init` | `features/<name>/` folder + `state.md` tracker |\n| 1 | `sdd-requirement` | `requirement.md` (interview-driven, with FR/SC IDs) |\n| 2 | `sdd-research` | `research.md` (codebase + external + options evaluated, in parallel) |\n| 3 | `sdd-plan` | `execution_plan.md` (sequenced phases with verification + rollback) |\n| 4 | `sdd-execute` | Code + tests, one phase at a time, with pauses for approval |\n| 5 | `sdd-review` | `review.md` (automated checks + parallel review subagents) |\n| 6 | `sdd-docs` | Updates CHANGELOG, README, ADRs, version manifests |\n| 7 | `sdd-ship` | Branch + commit + PR (Conventional Commits) |\n| — | `sdd-status` | Read-only dashboard of active features |\n\nFull system spec: [`sdd/SPEC.md`](sdd/SPEC.md). Practical how-to: [`sdd/HOWTO.md`](sdd/HOWTO.md).\n\n## Why SDD\n\nMost coding agents either over-execute (build before understanding) or over-discuss (talk forever, never ship). SDD splits the difference: front-load the depth in phases 1-3, then execute mechanically with verification gates.\n\nIt's particularly useful for:\n- Features that span multiple modules or repos\n- Refactors that change a public API or contract\n- Anything that introduces new persistence or schema migrations\n- Features with non-trivial state, concurrency, or correctness requirements\n- Anything > 1 day of work\n\nIt's **not** the right tool for trivial bug fixes, dependency bumps, typos, or mechanical refactors.\n\n## Companion utilities (bundled)\n\nThe CLI also installs 5 general-purpose skills that the SDD phases lean on. They're useful on their own, but a few SDD skills compose with them directly (e.g. `sdd-requirement` and `sdd-plan` invoke `grill-me`).\n\n| Skill | What it does |\n|---|---|\n| `grill-me` | Interview pattern — one question at a time, each with a recommended answer |\n| `zoom-out` | Codebase exploration helper — go up a layer of abstraction |\n| `caveman` | Ultra-compressed output mode (~75% fewer tokens) for long sessions |\n| `qa` | Conversational QA — user reports bugs, agent files GitHub issues with codebase context |\n| `write-a-skill` | Meta-skill for authoring new skills with proper structure |\n\nThe SDD pipeline runs fine without explicitly invoking them; they just enrich specific phases when triggered.\n\n## CLI reference\n\n```\nsdd-skills <command> [options]\n\nCommands:\n  install               Install skills + sdd/ docs\n  update                Re-install over existing files (same as install --force)\n  uninstall             Remove skills and docs\n  list                  Show installed skills and their location\n  help                  Show usage\n  version               Show CLI version\n\nOptions:\n  --local               Install skills to ./.claude/skills/ instead of ~/.claude/skills/\n  --skills-only         Only operate on the 9 skill folders\n  --docs-only           Only operate on .claude/sdd/\n  --force               Overwrite existing files\n  --target <path>       Custom skills target dir (advanced)\n```\n\n## Updating\n\n```bash\nnpx @dariomazzitelli/sdd-skills update          # re-install over existing files\n# or\nnpx @dariomazzitelli/sdd-skills@latest install --force\n```\n\n## Uninstalling\n\n```bash\nnpx @dariomazzitelli/sdd-skills uninstall          # global skills + project docs\nnpx @dariomazzitelli/sdd-skills uninstall --local  # local skills + project docs\n```\n\n## Project layout (after install)\n\n```\n~/.claude/skills/\n  sdd-init/SKILL.md\n  sdd-requirement/SKILL.md\n  sdd-research/SKILL.md\n  sdd-plan/SKILL.md\n  sdd-execute/SKILL.md\n  sdd-review/SKILL.md\n  sdd-docs/SKILL.md\n  sdd-ship/SKILL.md\n  sdd-status/SKILL.md\n  grill-me/SKILL.md\n  zoom-out/SKILL.md\n  caveman/SKILL.md\n  qa/SKILL.md\n  write-a-skill/SKILL.md\n\n<your-project>/\n  .claude/sdd/\n    SPEC.md           # system spec\n    HOWTO.md          # user-facing how-to\n    templates/        # requirement.md, execution_plan.md, state.md, ...\n    references/tdd/   # TDD reference notes\n  features/           # gitignored: working state for in-flight features\n    <feature-name>/\n      state.md\n      requirement.md\n      research.md\n      execution_plan.md\n      review.md\n      artifacts/\n```\n\n## Contributing\n\nIssues and PRs welcome. The skills themselves live under `skills/` and the system docs under `sdd/`. Edits to either are picked up the next time someone runs `npx @dariomazzitelli/sdd-skills install --force`.\n\n## Credits\n\nThe 9 SDD skills (`skills/sdd-*`) and CLI are original to this project.\n\nThe 5 companion skills under `skills/{grill-me,zoom-out,caveman,qa,write-a-skill}/` are copied verbatim from [mattpocock/skills](https://github.com/mattpocock/skills) (MIT). The \"caveman mode\" concept that `skills/caveman` implements originated in [JuliusBrussee/caveman](https://github.com/JuliusBrussee/caveman) (MIT) — credit for the underlying idea belongs to Julius Brussee.\n\nSeveral reference materials in `sdd/templates/` and `sdd/references/tdd/` are also adapted from Matt Pocock's work.\n\nSee [NOTICES.md](NOTICES.md) for the full third-party license texts.\n\n## License\n\nMIT — see [LICENSE](LICENSE). Bundled third-party content retains its own MIT terms; see [NOTICES.md](NOTICES.md).\n","readmeFilename":"README.md"}