How jorgeferrando/sdd-skills works
SDD Skills is a collection of project-agnostic instructions for guiding AI coding assistants through specification-first development. A user starts setup or a change workflow; the assistant’s skills produce and advance OpenSpec artifacts from exploration and proposal through specification, design, tasks, implementation, verification, and archival. Setup, discovery, and steering are distinct capabilities. Relationships here follow the README’s documented workflow; source excerpts were not provided, so internal calls beyond those documented are not asserted.
Main entry points: sdd-ff/SKILL.md Fast-forward · sdd-spec/SKILL.md Specify behavior · sdd-new/SKILL.md Start change · sdd-propose/SKILL.md Propose change
Components 15
Project context
- Initialize
skills/sdd-init/SKILL.md - Discover specs
skills/sdd-discover/SKILL.md - Manage steering
skills/sdd-steer/SKILL.md
Change planning
- Start change
skills/sdd-new/SKILL.md - Explore code
skills/sdd-explore/SKILL.md - Propose change
skills/sdd-propose/SKILL.md - Specify behavior
skills/sdd-spec/SKILL.md - Design solution
skills/sdd-design/SKILL.md - Plan tasks
skills/sdd-tasks/SKILL.md - Fast-forward
skills/sdd-ff/SKILL.md
Change execution
- Apply tasks
skills/sdd-apply/SKILL.md - Verify change
skills/sdd-verify/SKILL.md - Archive change
skills/sdd-archive/SKILL.md
Workflow support
- Continue workflow
skills/sdd-continue/SKILL.md
Other components
- User
Connections 19
- User → Initialize: sets up project
README.md - User → Discover specs: requests discovery
README.md - User → Manage steering: updates context
README.md - User → Start change: starts change
README.md - User → Fast-forward: starts fast path
README.md - Start change → Explore code: explores codebase
README.md - Start change → Propose change: creates proposal
README.md - Propose change → Specify behavior: advances to
README.md - Specify behavior → Design solution: advances to
README.md - Design solution → Plan tasks: advances to
README.md - Plan tasks → Apply tasks: hands off tasks
README.md - Apply tasks → Verify change: precedes checks
README.md - Verify change → Archive change: closes cycle
README.md - Fast-forward → Propose change: creates proposal
README.md - Fast-forward → Specify behavior: creates spec
README.md - Fast-forward → Design solution: creates design
README.md - Fast-forward → Plan tasks: creates tasks
README.md - User → Continue workflow: advances workflow
README.md - Continue workflow → Specify behavior: detects next phase
README.md