# jorgeferrando/sdd-skills architecture

> Architecture diagram of the GitHub repository jorgeferrando/sdd-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jorgeferrando/sdd-skills
- Repository: https://github.com/jorgeferrando/sdd-skills

## Overview

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: [`skills/sdd-ff/SKILL.md`](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-ff/SKILL.md) (Fast-forward), [`skills/sdd-spec/SKILL.md`](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-spec/SKILL.md) (Specify behavior), [`skills/sdd-new/SKILL.md`](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-new/SKILL.md) (Start change), [`skills/sdd-propose/SKILL.md`](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-propose/SKILL.md) (Propose change)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Project context"]
  node_init["Initialize<br/>[SKILL.md]"]
  node_discover["Discover specs<br/>[SKILL.md]"]
  node_steer["Manage steering<br/>[SKILL.md]"]
end

subgraph group_planning["Change planning"]
  node_new["Start change<br/>[SKILL.md]"]
  node_explore["Explore code<br/>[SKILL.md]"]
  node_propose["Propose change<br/>[SKILL.md]"]
  node_spec["Specify behavior<br/>[SKILL.md]"]
  node_design["Design solution<br/>[SKILL.md]"]
  node_tasks["Plan tasks<br/>[SKILL.md]"]
  node_ff["Fast-forward<br/>[SKILL.md]"]
end

subgraph group_execution["Change execution"]
  node_apply["Apply tasks<br/>[SKILL.md]"]
  node_verify["Verify change<br/>[SKILL.md]"]
  node_archive["Archive change<br/>[SKILL.md]"]
end

subgraph group_support["Workflow support"]
  node_continue["Continue workflow<br/>[SKILL.md]"]
end

node_user(("User"))

node_user -->|"sets up project"| node_init
node_user -->|"requests discovery"| node_discover
node_user -->|"updates context"| node_steer
node_user -->|"starts change"| node_new
node_user -->|"starts fast path"| node_ff
node_new -->|"explores codebase"| node_explore
node_new -->|"creates proposal"| node_propose
node_propose -->|"advances to"| node_spec
node_spec -->|"advances to"| node_design
node_design -->|"advances to"| node_tasks
node_tasks -->|"hands off tasks"| node_apply
node_apply -->|"precedes checks"| node_verify
node_verify -->|"closes cycle"| node_archive
node_ff -->|"creates proposal"| node_propose
node_ff -->|"creates spec"| node_spec
node_ff -->|"creates design"| node_design
node_ff -->|"creates tasks"| node_tasks
node_user -->|"advances workflow"| node_continue
node_continue -->|"detects next phase"| node_spec

click node_init "https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-init/SKILL.md"
click node_discover "https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-discover/SKILL.md"
click node_steer "https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-steer/SKILL.md"
click node_new "https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-new/SKILL.md"
click node_explore "https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-explore/SKILL.md"
click node_propose "https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-propose/SKILL.md"
click node_spec "https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-spec/SKILL.md"
click node_design "https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-design/SKILL.md"
click node_tasks "https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-tasks/SKILL.md"
click node_ff "https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-ff/SKILL.md"
click node_continue "https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-continue/SKILL.md"
click node_apply "https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-apply/SKILL.md"
click node_verify "https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-verify/SKILL.md"
click node_archive "https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-archive/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_init,node_discover,node_steer,node_user toneBlue
class node_new,node_explore,node_propose,node_spec,node_design,node_tasks,node_ff toneAmber
class node_apply,node_verify,node_archive toneMint
class node_continue toneRose
```

## Components

### Project context

- [Initialize](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-init/SKILL.md): `skills/sdd-init/SKILL.md`
- [Discover specs](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-discover/SKILL.md): `skills/sdd-discover/SKILL.md`
- [Manage steering](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-steer/SKILL.md): `skills/sdd-steer/SKILL.md`

### Change planning

- [Start change](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-new/SKILL.md): `skills/sdd-new/SKILL.md`
- [Explore code](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-explore/SKILL.md): `skills/sdd-explore/SKILL.md`
- [Propose change](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-propose/SKILL.md): `skills/sdd-propose/SKILL.md`
- [Specify behavior](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-spec/SKILL.md): `skills/sdd-spec/SKILL.md`
- [Design solution](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-design/SKILL.md): `skills/sdd-design/SKILL.md`
- [Plan tasks](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-tasks/SKILL.md): `skills/sdd-tasks/SKILL.md`
- [Fast-forward](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-ff/SKILL.md): `skills/sdd-ff/SKILL.md`

### Change execution

- [Apply tasks](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-apply/SKILL.md): `skills/sdd-apply/SKILL.md`
- [Verify change](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-verify/SKILL.md): `skills/sdd-verify/SKILL.md`
- [Archive change](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-archive/SKILL.md): `skills/sdd-archive/SKILL.md`

### Workflow support

- [Continue workflow](https://github.com/jorgeferrando/sdd-skills/blob/main/skills/sdd-continue/SKILL.md): `skills/sdd-continue/SKILL.md`

### Other components

- **User**

## Connections

- User → Initialize: sets up project (evidence: `README.md`)
- User → Discover specs: requests discovery (evidence: `README.md`)
- User → Manage steering: updates context (evidence: `README.md`)
- User → Start change: starts change (evidence: `README.md`)
- User → Fast-forward: starts fast path (evidence: `README.md`)
- Start change → Explore code: explores codebase (evidence: `README.md`)
- Start change → Propose change: creates proposal (evidence: `README.md`)
- Propose change → Specify behavior: advances to (evidence: `README.md`)
- Specify behavior → Design solution: advances to (evidence: `README.md`)
- Design solution → Plan tasks: advances to (evidence: `README.md`)
- Plan tasks → Apply tasks: hands off tasks (evidence: `README.md`)
- Apply tasks → Verify change: precedes checks (evidence: `README.md`)
- Verify change → Archive change: closes cycle (evidence: `README.md`)
- Fast-forward → Propose change: creates proposal (evidence: `README.md`)
- Fast-forward → Specify behavior: creates spec (evidence: `README.md`)
- Fast-forward → Design solution: creates design (evidence: `README.md`)
- Fast-forward → Plan tasks: creates tasks (evidence: `README.md`)
- User → Continue workflow: advances workflow (evidence: `README.md`)
- Continue workflow → Specify behavior: detects next phase (evidence: `README.md`)