# jyhemlin4812/sdlc-framework architecture

> Architecture diagram of the GitHub repository jyhemlin4812/sdlc-framework, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jyhemlin4812/sdlc-framework
- Repository: https://github.com/jyhemlin4812/sdlc-framework

## Overview

sdlc-framework is a Claude Code SDLC workflow built from slash commands, skills, and subagents. A project starts with initialization and requirements elicitation, optionally adds discussion, then produces architecture decisions and tasks arranged into execution waves. The AQ Gate validates traceability and security before implementation; development proceeds wave by wave, with Code Lock supporting coordinated work, and reporting closes the release workflow. The graph reflects README-documented capabilities and sampled validator, scanner, planner, and model-resolver code; command-to-agent details and several integrations were not sampled, so those relationships are omitted.

Main entry points: [`claude/commands/sdlc`](https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/commands/sdlc) (SDLC commands), [`bundle/templates/SDLC_PM`](https://github.com/jyhemlin4812/sdlc-framework/tree/main/bundle/templates/SDLC_PM) (SDLC project artifacts), [`claude/skills/sdlc/scripts/check_sdlc.py`](https://github.com/jyhemlin4812/sdlc-framework/blob/main/claude/skills/sdlc/scripts/check_sdlc.py) (AQ Gate validator), [`claude/skills/sdlc`](https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/skills/sdlc) (Workflow skills)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Project workflow"]
  node_commands["SDLC commands"]
  node_skills["Workflow skills"]
  node_agents["Subagents"]
  node_project_setup["Project setup"]
  node_elicitation["Requirements elicitation"]
  node_discussion["Project discussion"]
  node_project_artifacts["SDLC project artifacts"]
end

subgraph group_execution["Planning and execution"]
  node_architecture_tasks["Architecture and tasks"]
  node_wave_planner["Wave planner<br/>[wave_planner.py]"]
  node_wave_execution["Wave execution"]
  node_code_lock["Code Lock<br/>[code-lock.md]"]
end

subgraph group_assurance["Quality assurance"]
  node_aq_gate["AQ Gate validator<br/>[check_sdlc.py]"]
  node_asvs_scanner["ASVS scanner<br/>[asvs_scanner.py]"]
  node_release_report["Release report"]
end

subgraph group_support["Framework support"]
  node_model_profiler["Model resolver<br/>[model_profiler.py]"]
  node_state_lock["State lock helper<br/>[lockfile_helper.py]"]
end

node_project_user(("Project user"))
node_claude_code["Claude Code"]

node_project_user -->|"uses"| node_claude_code
node_claude_code -->|"invokes"| node_commands
node_commands -->|"initializes"| node_project_setup
node_commands -->|"elicits"| node_elicitation
node_commands -->|"facilitates"| node_discussion
node_commands -->|"plans"| node_architecture_tasks
node_architecture_tasks -->|"computes waves"| node_wave_planner
node_commands -->|"executes waves"| node_wave_execution
node_wave_execution -.->|"delegates work"| node_agents
node_wave_execution -->|"coordinates state"| node_code_lock
node_project_setup -->|"creates structure"| node_project_artifacts
node_elicitation -->|"records requirements"| node_project_artifacts
node_discussion -->|"records discussion"| node_project_artifacts
node_architecture_tasks -->|"records plan"| node_project_artifacts
node_commands -->|"runs gate"| node_aq_gate
node_aq_gate -->|"runs scan"| node_asvs_scanner
node_aq_gate -->|"validates traceability"| node_project_artifacts
node_commands -->|"reports release"| node_release_report
node_skills -.->|"resolves models"| node_model_profiler
node_wave_execution -.->|"locks state"| node_state_lock

click node_commands "https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/commands/sdlc"
click node_skills "https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/skills/sdlc"
click node_agents "https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/agents"
click node_project_setup "https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/commands/sdlc"
click node_elicitation "https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/commands/sdlc"
click node_discussion "https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/commands/sdlc"
click node_architecture_tasks "https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/commands/sdlc"
click node_wave_planner "https://github.com/jyhemlin4812/sdlc-framework/blob/main/claude/skills/sdlc-wave-orchestrator/scripts/wave_planner.py"
click node_wave_execution "https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/commands/sdlc"
click node_code_lock "https://github.com/jyhemlin4812/sdlc-framework/blob/main/claude/skills/sdlc/references/code-lock.md"
click node_project_artifacts "https://github.com/jyhemlin4812/sdlc-framework/tree/main/bundle/templates/SDLC_PM"
click node_aq_gate "https://github.com/jyhemlin4812/sdlc-framework/blob/main/claude/skills/sdlc/scripts/check_sdlc.py"
click node_asvs_scanner "https://github.com/jyhemlin4812/sdlc-framework/blob/main/claude/skills/sdlc-asvs-auditor/scripts/asvs_scanner.py"
click node_release_report "https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/commands/sdlc"
click node_model_profiler "https://github.com/jyhemlin4812/sdlc-framework/blob/main/claude/skills/sdlc/scripts/model_profiler.py"
click node_state_lock "https://github.com/jyhemlin4812/sdlc-framework/blob/main/claude/skills/sdlc-wave-orchestrator/scripts/lockfile_helper.py"

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_commands,node_skills,node_agents,node_project_setup,node_elicitation,node_discussion,node_project_artifacts,node_project_user toneBlue
class node_architecture_tasks,node_wave_planner,node_wave_execution,node_code_lock toneAmber
class node_aq_gate,node_asvs_scanner,node_release_report toneMint
class node_model_profiler,node_state_lock toneRose
class node_claude_code toneIndigo
```

## Components

### Project workflow

- [SDLC commands](https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/commands/sdlc): `claude/commands/sdlc`
- [Workflow skills](https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/skills/sdlc): `claude/skills/sdlc`
- [Subagents](https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/agents): `claude/agents`
- [Project setup](https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/commands/sdlc): `claude/commands/sdlc`
- [Requirements elicitation](https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/commands/sdlc): `claude/commands/sdlc`
- [Project discussion](https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/commands/sdlc): `claude/commands/sdlc`
- [SDLC project artifacts](https://github.com/jyhemlin4812/sdlc-framework/tree/main/bundle/templates/SDLC_PM): `bundle/templates/SDLC_PM`

### Planning and execution

- [Architecture and tasks](https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/commands/sdlc): `claude/commands/sdlc`
- [Wave planner](https://github.com/jyhemlin4812/sdlc-framework/blob/main/claude/skills/sdlc-wave-orchestrator/scripts/wave_planner.py): `claude/skills/sdlc-wave-orchestrator/scripts/wave_planner.py`
- [Wave execution](https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/commands/sdlc): `claude/commands/sdlc`
- [Code Lock](https://github.com/jyhemlin4812/sdlc-framework/blob/main/claude/skills/sdlc/references/code-lock.md): `claude/skills/sdlc/references/code-lock.md`

### Quality assurance

- [AQ Gate validator](https://github.com/jyhemlin4812/sdlc-framework/blob/main/claude/skills/sdlc/scripts/check_sdlc.py): `claude/skills/sdlc/scripts/check_sdlc.py`
- [ASVS scanner](https://github.com/jyhemlin4812/sdlc-framework/blob/main/claude/skills/sdlc-asvs-auditor/scripts/asvs_scanner.py): `claude/skills/sdlc-asvs-auditor/scripts/asvs_scanner.py`
- [Release report](https://github.com/jyhemlin4812/sdlc-framework/tree/main/claude/commands/sdlc): `claude/commands/sdlc`

### Framework support

- [Model resolver](https://github.com/jyhemlin4812/sdlc-framework/blob/main/claude/skills/sdlc/scripts/model_profiler.py): `claude/skills/sdlc/scripts/model_profiler.py`
- [State lock helper](https://github.com/jyhemlin4812/sdlc-framework/blob/main/claude/skills/sdlc-wave-orchestrator/scripts/lockfile_helper.py): `claude/skills/sdlc-wave-orchestrator/scripts/lockfile_helper.py`

### Other components

- **Project user**
- **Claude Code**

## Connections

- Project user → Claude Code: uses (evidence: `README.md`)
- Claude Code → SDLC commands: invokes (evidence: `README.md`)
- SDLC commands → Project setup: initializes (evidence: `README.md`)
- SDLC commands → Requirements elicitation: elicits (evidence: `README.md`)
- SDLC commands → Project discussion: facilitates (evidence: `README.md`)
- SDLC commands → Architecture and tasks: plans (evidence: `README.md`)
- Architecture and tasks → Wave planner: computes waves (evidence: `claude/skills/sdlc-wave-orchestrator/scripts/wave_planner.py`)
- SDLC commands → Wave execution: executes waves (evidence: `README.md`)
- Wave execution → Subagents: delegates work
- Wave execution → Code Lock: coordinates state
- Project setup → SDLC project artifacts: creates structure (evidence: `README.md`)
- Requirements elicitation → SDLC project artifacts: records requirements (evidence: `README.md`)
- Project discussion → SDLC project artifacts: records discussion (evidence: `README.md`)
- Architecture and tasks → SDLC project artifacts: records plan (evidence: `README.md`)
- SDLC commands → AQ Gate validator: runs gate (evidence: `README.md`)
- AQ Gate validator → ASVS scanner: runs scan (evidence: `claude/skills/sdlc/scripts/check_sdlc.py`)
- AQ Gate validator → SDLC project artifacts: validates traceability (evidence: `claude/skills/sdlc/scripts/check_sdlc.py`)
- SDLC commands → Release report: reports release (evidence: `README.md`)
- Workflow skills → Model resolver: resolves models
- Wave execution → State lock helper: locks state
