How stasmarkov/sdd-kit works
SDD Kit packages spec-driven development workflows, agent skills, hooks, and host integrations for Claude Code, with a spec-board CLI. The principal user journey is to invoke an SDD workflow, which guides work from written specification through implementation, QA/security, and shipping; the extensive workflow content is present in host/plugin trees but mostly unsampled. The adapter sources show a second internal layer that builds and installs host-specific assets and dispatches hooks, while the workflow bridge exposes asynchronous jobs over JSON-RPC. Arrows are limited to README statements and visible bridge calls; workflow internals are not inferred.
Main entry points: workflows SDD front door · engine.mjs Job engine · registrations.mjs Hook registry · spec-board.mjs Spec board
Components 25
SDD workflows
- SDD front door
plugins/sdd-kit/workflows - Spec creation
plugins/sdd-kit/workflows/create-spec.js - Greenfield build
plugins/sdd-kit/workflows/greenfield-build.js - Bug fixing
plugins/sdd-kit/workflows/fix-bug.js - Tech research
plugins/sdd-kit/workflows/tech-research.js - QA and docs
plugins/sdd-kit/workflows/qa-and-docs.js - Security audit
plugins/sdd-kit/workflows/security-audit.js - Feature shipping
plugins/sdd-kit/workflows/ship-feature.js - Stack support
plugins/sdd-kit/workflows/lib/stacks.js
Workflow bridge
- JSON-RPC server
adapters/bridge/server.mjs - Job engine
adapters/bridge/engine.mjs - Input validation
adapters/bridge/schema.mjs - Run state
adapters/bridge/state.mjs - Artifact runtime
adapters/bridge/runtime.mjs - Agent definitions
adapters/bridge/agents.mjs - Stack manifests
adapters/bridge/stacks.mjs
Host integration
- Codex adapter
adapters/codex/build.mjs - Cursor adapter
adapters/cursor/build.mjs - Host installers
adapters/shared/install.mjs - Hook dispatcher
adapters/hooks/dispatch.mjs - Hook registry
adapters/hooks/registrations.mjs
Spec tools
- Spec board
cli/spec-board.mjs - Board implementation
hosts/codex/sdd-kit/runtime/skills/spec-board/scripts/spec-board.mjs - CLI
cli/sdd-kit.mjs
Other components
- Developer
Connections 21
- Developer → SDD front door: invokes
README.md - Developer → Spec board: runs
README.md - SDD front door → Spec creation: routes to
README.md - SDD front door → Greenfield build: routes to
README.md - SDD front door → Bug fixing: routes to
README.md - SDD front door → Tech research: routes to
README.md - SDD front door → QA and docs: routes to
README.md - SDD front door → Security audit: routes to
README.md - SDD front door → Feature shipping: routes to
README.md - JSON-RPC server → Job engine: dispatches calls
adapters/bridge/server.mjs - JSON-RPC server → Input validation: validates input
adapters/bridge/server.mjs - Job engine → Input validation: validates output
adapters/bridge/engine.mjs - Job engine → Run state: reads and writes
adapters/bridge/engine.mjs - Job engine → Artifact runtime: hashes artifacts
adapters/bridge/engine.mjs - Codex adapter → Hook registry: uses registrations
adapters/codex/build.mjs - Codex adapter → Host installers: uses shared build
adapters/codex/build.mjs - Cursor adapter → Hook registry: plans hooks
adapters/cursor/build.mjs - Cursor adapter → Hook dispatcher: uses dispatcher
adapters/cursor/build.mjs - Hook registry → Hook dispatcher: registers dispatch
adapters/hooks/registrations.mjs - Spec board → Board implementation: starts board
- CLI → Spec board: offers command