# lst97/claude-code-sub-agents architecture

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

- Interactive diagram: https://gitdiagram.com/lst97/claude-code-sub-agents
- Repository: https://github.com/lst97/claude-code-sub-agents

## Overview

This repository is a collection of Markdown-defined Claude Code subagents, not an executable application. The principal workflow is that Claude Code selects a domain specialist from task context, or a user explicitly invokes one; the agent applies its domain expertise to the task. For complex work, the documented agent-organizer analyzes requirements, assembles a team, and coordinates collaboration. The README describes these behaviors, but no source excerpts were provided, so internal agent-to-agent links are omitted.

Main entry points: [`agents/agent-organizer.md`](https://github.com/lst97/claude-code-sub-agents/blob/main/agents/agent-organizer.md) (Agent Organizer), [`agents/development`](https://github.com/lst97/claude-code-sub-agents/tree/main/agents/development) (Development Agents), [`agents/infrastructure`](https://github.com/lst97/claude-code-sub-agents/tree/main/agents/infrastructure) (Infrastructure Agents), [`agents/quality-testing`](https://github.com/lst97/claude-code-sub-agents/tree/main/agents/quality-testing) (Quality Agents)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_development["Development"]
  node_development_agents["Development Agents"]
end

subgraph group_infrastructure["Infrastructure"]
  node_infrastructure_agents["Infrastructure Agents"]
end

subgraph group_quality["Quality"]
  node_quality_agents["Quality Agents"]
end

subgraph group_data_ai["Data &amp; AI"]
  node_data_ai_agents["Data &amp; AI Agents"]
end

subgraph group_security["Security"]
  node_security_agents["Security Agent"]
end

subgraph group_business_docs["Business &amp; Docs"]
  node_business_docs_agents["Business &amp; Docs Agents"]
  node_specialization_agents["Specialization Agents"]
end

node_user(("User"))
node_claude_code(("Claude Code"))
node_organizer["Agent Organizer<br/>[agent-organizer.md]"]

node_user -->|"submits task"| node_claude_code
node_claude_code -->|"selects by context"| node_development_agents
node_claude_code -->|"selects by context"| node_infrastructure_agents
node_claude_code -->|"selects by context"| node_quality_agents
node_claude_code -->|"selects by context"| node_data_ai_agents
node_claude_code -->|"selects by context"| node_security_agents
node_claude_code -->|"selects by context"| node_business_docs_agents
node_claude_code -->|"selects by context"| node_specialization_agents
node_user -->|"requests coordination"| node_organizer
node_organizer -->|"assembles teams"| node_development_agents
node_organizer -->|"assembles teams"| node_infrastructure_agents
node_organizer -->|"assembles teams"| node_quality_agents
node_organizer -->|"assembles teams"| node_data_ai_agents
node_organizer -->|"assembles teams"| node_security_agents
node_organizer -->|"assembles teams"| node_business_docs_agents
node_organizer -->|"assembles teams"| node_specialization_agents

click node_development_agents "https://github.com/lst97/claude-code-sub-agents/tree/main/agents/development"
click node_infrastructure_agents "https://github.com/lst97/claude-code-sub-agents/tree/main/agents/infrastructure"
click node_quality_agents "https://github.com/lst97/claude-code-sub-agents/tree/main/agents/quality-testing"
click node_data_ai_agents "https://github.com/lst97/claude-code-sub-agents/tree/main/agents/data-ai"
click node_security_agents "https://github.com/lst97/claude-code-sub-agents/tree/main/agents/security"
click node_business_docs_agents "https://github.com/lst97/claude-code-sub-agents/tree/main/agents/business"
click node_specialization_agents "https://github.com/lst97/claude-code-sub-agents/tree/main/agents/specialization"
click node_organizer "https://github.com/lst97/claude-code-sub-agents/blob/main/agents/agent-organizer.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_development_agents,node_user toneBlue
class node_infrastructure_agents toneAmber
class node_quality_agents toneMint
class node_data_ai_agents toneRose
class node_security_agents,node_claude_code toneIndigo
class node_business_docs_agents,node_specialization_agents,node_organizer toneTeal
```

## Components

### Development

- [Development Agents](https://github.com/lst97/claude-code-sub-agents/tree/main/agents/development): `agents/development`

### Infrastructure

- [Infrastructure Agents](https://github.com/lst97/claude-code-sub-agents/tree/main/agents/infrastructure): `agents/infrastructure`

### Quality

- [Quality Agents](https://github.com/lst97/claude-code-sub-agents/tree/main/agents/quality-testing): `agents/quality-testing`

### Data & AI

- [Data & AI Agents](https://github.com/lst97/claude-code-sub-agents/tree/main/agents/data-ai): `agents/data-ai`

### Security

- [Security Agent](https://github.com/lst97/claude-code-sub-agents/tree/main/agents/security): `agents/security`

### Business & Docs

- [Business & Docs Agents](https://github.com/lst97/claude-code-sub-agents/tree/main/agents/business): `agents/business`
- [Specialization Agents](https://github.com/lst97/claude-code-sub-agents/tree/main/agents/specialization): `agents/specialization`

### Other components

- **User**
- **Claude Code**
- [Agent Organizer](https://github.com/lst97/claude-code-sub-agents/blob/main/agents/agent-organizer.md): `agents/agent-organizer.md`

## Connections

- User → Claude Code: submits task (evidence: `README.md`)
- Claude Code → Development Agents: selects by context (evidence: `README.md`)
- Claude Code → Infrastructure Agents: selects by context (evidence: `README.md`)
- Claude Code → Quality Agents: selects by context (evidence: `README.md`)
- Claude Code → Data & AI Agents: selects by context (evidence: `README.md`)
- Claude Code → Security Agent: selects by context (evidence: `README.md`)
- Claude Code → Business & Docs Agents: selects by context (evidence: `README.md`)
- Claude Code → Specialization Agents: selects by context (evidence: `README.md`)
- User → Agent Organizer: requests coordination (evidence: `README.md`)
- Agent Organizer → Development Agents: assembles teams (evidence: `README.md`)
- Agent Organizer → Infrastructure Agents: assembles teams (evidence: `README.md`)
- Agent Organizer → Quality Agents: assembles teams (evidence: `README.md`)
- Agent Organizer → Data & AI Agents: assembles teams (evidence: `README.md`)
- Agent Organizer → Security Agent: assembles teams (evidence: `README.md`)
- Agent Organizer → Business & Docs Agents: assembles teams (evidence: `README.md`)
- Agent Organizer → Specialization Agents: assembles teams (evidence: `README.md`)
