# chakib-lah/sdd-claude architecture

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

- Interactive diagram: https://gitdiagram.com/chakib-lah/sdd-claude
- Repository: https://github.com/chakib-lah/sdd-claude

## Overview

SDD Claude is a Claude Code toolkit for taking a ticket through a human-approved, spec-driven development process. The principal workflow starts a feature, produces and validates a specification, then a plan and task breakdown, with a human approval gate at each stage before implementation. Technical verification and acceptance-criteria review gate merge-request preparation and archival. The README documents the workflow and major capabilities; source excerpts were not provided, so links reflect documented relationships only.

Main entry points: [`core/commands`](https://github.com/chakib-lah/sdd-claude/tree/main/core/commands) (Supporting commands), [`core/commands/sdd-spec.md`](https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-spec.md) (Specify), [`core/commands/sdd-plan.md`](https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-plan.md) (Plan work), [`core/commands/sdd-tasks.md`](https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-tasks.md) (Break down tasks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["SDD workflow"]
  node_start["Start feature<br/>[sdd-start.md]"]
  node_spec["Specify<br/>[sdd-spec.md]"]
  node_specdoc["Specification<br/>[spec.md]"]
  node_plan["Plan work<br/>[sdd-plan.md]"]
  node_plandoc["Implementation plan<br/>[plan.md]"]
  node_tasks["Break down tasks<br/>[sdd-tasks.md]"]
  node_tasksdoc["Task list<br/>[tasks.md]"]
  node_implement["Implement tasks<br/>[sdd-implement.md]"]
  node_verify["Technical gate<br/>[sdd-verify.md]"]
  node_review["Functional gate<br/>[sdd-review.md]"]
  node_mr["Prepare MR<br/>[sdd-mr.md]"]
  node_archive["Archive artifacts<br/>[sdd-archive.md]"]
end

subgraph group_capabilities["Workflow commands"]
  node_phasecommands["Supporting commands"]
  node_agents["SDD agents"]
end

subgraph group_stack["Stack guidance"]
  node_skills["Stack skills"]
end

subgraph group_standards["Shared standards"]
  node_rules["Process rules"]
  node_templates["Artifact templates"]
end

node_developer(("Developer"))
node_human(("Human approver"))
node_claude(("Claude Code"))

node_developer -->|"starts ticket"| node_start
node_start -->|"begins workflow"| node_spec
node_claude -->|"executes command"| node_spec
node_spec -->|"creates draft"| node_specdoc
node_spec -->|"requests approval"| node_human
node_human -->|"approves spec"| node_plan
node_plan -->|"creates plan"| node_plandoc
node_plan -->|"requests approval"| node_human
node_human -->|"approves plan"| node_tasks
node_tasks -->|"creates breakdown"| node_tasksdoc
node_tasks -->|"requests approval"| node_human
node_human -->|"approves tasks"| node_implement
node_implement -->|"completes implementation"| node_verify
node_implement -->|"completes implementation"| node_review
node_verify -->|"passes technical gate"| node_mr
node_review -->|"passes functional gate"| node_mr
node_mr -->|"after merge"| node_archive
node_phasecommands -->|"delegates tasks"| node_agents
node_skills -->|"provides stack rules"| node_rules
node_skills -->|"includes commands"| node_phasecommands
node_phasecommands -->|"uses artifacts"| node_templates
node_phasecommands -->|"follows guidance"| node_rules

click node_start "https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-start.md"
click node_spec "https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-spec.md"
click node_specdoc "https://github.com/chakib-lah/sdd-claude/blob/main/core/templates/spec.md"
click node_plan "https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-plan.md"
click node_plandoc "https://github.com/chakib-lah/sdd-claude/blob/main/core/templates/plan.md"
click node_tasks "https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-tasks.md"
click node_tasksdoc "https://github.com/chakib-lah/sdd-claude/blob/main/core/templates/tasks.md"
click node_implement "https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-implement.md"
click node_verify "https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-verify.md"
click node_review "https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-review.md"
click node_mr "https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-mr.md"
click node_archive "https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-archive.md"
click node_phasecommands "https://github.com/chakib-lah/sdd-claude/tree/main/core/commands"
click node_agents "https://github.com/chakib-lah/sdd-claude/tree/main/core/agents"
click node_skills "https://github.com/chakib-lah/sdd-claude/tree/main/skills"
click node_rules "https://github.com/chakib-lah/sdd-claude/tree/main/core/rules"
click node_templates "https://github.com/chakib-lah/sdd-claude/tree/main/core/templates"

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_start,node_spec,node_specdoc,node_plan,node_plandoc,node_tasks,node_tasksdoc,node_implement,node_verify,node_review,node_mr,node_archive toneBlue
class node_phasecommands,node_agents toneAmber
class node_skills toneMint
class node_rules,node_templates toneRose
class node_developer,node_human,node_claude toneIndigo
```

## Components

### SDD workflow

- [Start feature](https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-start.md): `core/commands/sdd-start.md`
- [Specify](https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-spec.md): `core/commands/sdd-spec.md`
- [Specification](https://github.com/chakib-lah/sdd-claude/blob/main/core/templates/spec.md): `core/templates/spec.md`
- [Plan work](https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-plan.md): `core/commands/sdd-plan.md`
- [Implementation plan](https://github.com/chakib-lah/sdd-claude/blob/main/core/templates/plan.md): `core/templates/plan.md`
- [Break down tasks](https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-tasks.md): `core/commands/sdd-tasks.md`
- [Task list](https://github.com/chakib-lah/sdd-claude/blob/main/core/templates/tasks.md): `core/templates/tasks.md`
- [Implement tasks](https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-implement.md): `core/commands/sdd-implement.md`
- [Technical gate](https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-verify.md): `core/commands/sdd-verify.md`
- [Functional gate](https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-review.md): `core/commands/sdd-review.md`
- [Prepare MR](https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-mr.md): `core/commands/sdd-mr.md`
- [Archive artifacts](https://github.com/chakib-lah/sdd-claude/blob/main/core/commands/sdd-archive.md): `core/commands/sdd-archive.md`

### Workflow commands

- [Supporting commands](https://github.com/chakib-lah/sdd-claude/tree/main/core/commands): `core/commands`
- [SDD agents](https://github.com/chakib-lah/sdd-claude/tree/main/core/agents): `core/agents`

### Stack guidance

- [Stack skills](https://github.com/chakib-lah/sdd-claude/tree/main/skills): `skills`

### Shared standards

- [Process rules](https://github.com/chakib-lah/sdd-claude/tree/main/core/rules): `core/rules`
- [Artifact templates](https://github.com/chakib-lah/sdd-claude/tree/main/core/templates): `core/templates`

### Other components

- **Developer**
- **Human approver**
- **Claude Code**

## Connections

- Developer → Start feature: starts ticket
- Start feature → Specify: begins workflow
- Claude Code → Specify: executes command
- Specify → Specification: creates draft
- Specify → Human approver: requests approval
- Human approver → Plan work: approves spec
- Plan work → Implementation plan: creates plan
- Plan work → Human approver: requests approval
- Human approver → Break down tasks: approves plan
- Break down tasks → Task list: creates breakdown
- Break down tasks → Human approver: requests approval
- Human approver → Implement tasks: approves tasks
- Implement tasks → Technical gate: completes implementation
- Implement tasks → Functional gate: completes implementation
- Technical gate → Prepare MR: passes technical gate
- Functional gate → Prepare MR: passes functional gate
- Prepare MR → Archive artifacts: after merge
- Supporting commands → SDD agents: delegates tasks
- Stack skills → Process rules: provides stack rules
- Stack skills → Supporting commands: includes commands
- Supporting commands → Artifact templates: uses artifacts
- Supporting commands → Process rules: follows guidance