# superclaude-org/superclaude_framework architecture

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

- Interactive diagram: https://gitdiagram.com/superclaude-org/superclaude_framework
- Repository: https://github.com/superclaude-org/superclaude_framework

## Overview

SuperClaude is a Claude Code development framework: users install its slash commands and agents, optionally configure MCP integrations, then use its commands, agents, and modes to guide development workflows. Its Python package also provides a CLI and pytest-based PM-agent checks, plus parallel execution, reflection, and self-correction capabilities. The README and excerpts support the product stages and CLI dispatch; unsampled command and agent content is represented by its exact directories, without guessing internal call flows.

Main entry points: [`src/superclaude/pytest_plugin.py`](https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/pytest_plugin.py) (Pytest Plugin), [`src/superclaude/cli/main.py`](https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/cli/main.py) (SuperClaude CLI), [`src/superclaude/cli/install_mcp.py`](https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/cli/install_mcp.py) (MCP Installer), [`src/superclaude/cli/install_commands.py`](https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/cli/install_commands.py) (Command Installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_install["Setup and Integration"]
  node_cli["SuperClaude CLI<br/>[main.py]"]
  node_command_install["Command Installer"]
  node_mcp_install["MCP Installer<br/>[install_mcp.py]"]
  node_doctor["Health Checks<br/>[doctor.py]"]
  node_mcp_configs["MCP Configurations"]
end

subgraph group_workflow["Development Workflows"]
  node_commands["Slash Commands"]
  node_agents["Specialized Agents"]
  node_modes["Behavior Modes"]
  node_skills["Skills"]
end

subgraph group_execution["Execution Support"]
  node_parallel["Parallel Execution<br/>[parallel.py]"]
  node_reflection["Pre-task Reflection<br/>[reflection.py]"]
  node_self_correction["Self-Correction<br/>[self_correction.py]"]
end

subgraph group_pm["PM Agent Checks"]
  node_pytest["Pytest Plugin<br/>[pytest_plugin.py]"]
  node_confidence["Confidence Check<br/>[confidence.py]"]
  node_self_check["Evidence Self-Check<br/>[self_check.py]"]
  node_reflexion["Reflexion Learning<br/>[reflexion.py]"]
  node_token_budget["Token Budget<br/>[token_budget.py]"]
end

node_user(("Developer"))
node_claude_code(("Claude Code"))
node_mcp_services{{"MCP Services"}}

node_user -->|"runs"| node_cli
node_cli -->|"dispatches install"| node_command_install
node_cli -->|"dispatches MCP setup"| node_mcp_install
node_cli -->|"runs diagnostics"| node_doctor
node_command_install -->|"installs commands"| node_commands
node_command_install -->|"installs agents"| node_agents
node_mcp_install -->|"uses configuration"| node_mcp_configs
node_mcp_install -->|"registers servers"| node_mcp_services
node_mcp_install -->|"registers servers"| node_claude_code
node_claude_code -->|"uses commands"| node_commands
node_claude_code -->|"uses agents"| node_agents
node_claude_code -->|"uses modes"| node_modes
node_claude_code -.->|"uses skills"| node_skills
node_claude_code -.->|"optionally connects"| node_mcp_services
node_pytest -->|"provides fixture"| node_confidence
node_pytest -->|"provides fixture"| node_self_check
node_pytest -->|"provides fixture"| node_reflexion
node_pytest -->|"provides fixture"| node_token_budget

click node_cli "https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/cli/main.py"
click node_command_install "https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/cli/install_commands.py"
click node_mcp_install "https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/cli/install_mcp.py"
click node_doctor "https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/cli/doctor.py"
click node_commands "https://github.com/superclaude-org/superclaude_framework/tree/master/src/superclaude/commands"
click node_agents "https://github.com/superclaude-org/superclaude_framework/tree/master/src/superclaude/agents"
click node_modes "https://github.com/superclaude-org/superclaude_framework/tree/master/src/superclaude/modes"
click node_skills "https://github.com/superclaude-org/superclaude_framework/tree/master/src/superclaude/skills"
click node_mcp_configs "https://github.com/superclaude-org/superclaude_framework/tree/master/src/superclaude/mcp/configs"
click node_parallel "https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/execution/parallel.py"
click node_reflection "https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/execution/reflection.py"
click node_self_correction "https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/execution/self_correction.py"
click node_pytest "https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/pytest_plugin.py"
click node_confidence "https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/pm_agent/confidence.py"
click node_self_check "https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/pm_agent/self_check.py"
click node_reflexion "https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/pm_agent/reflexion.py"
click node_token_budget "https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/pm_agent/token_budget.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_cli,node_command_install,node_mcp_install,node_doctor,node_mcp_configs toneBlue
class node_commands,node_agents,node_modes,node_skills toneAmber
class node_parallel,node_reflection,node_self_correction toneMint
class node_pytest,node_confidence,node_self_check,node_reflexion,node_token_budget toneRose
class node_user,node_claude_code,node_mcp_services toneIndigo
```

## Components

### Setup and Integration

- [SuperClaude CLI](https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/cli/main.py): `src/superclaude/cli/main.py`
- [Command Installer](https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/cli/install_commands.py): `src/superclaude/cli/install_commands.py`
- [MCP Installer](https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/cli/install_mcp.py): `src/superclaude/cli/install_mcp.py`
- [Health Checks](https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/cli/doctor.py): `src/superclaude/cli/doctor.py`
- [MCP Configurations](https://github.com/superclaude-org/superclaude_framework/tree/master/src/superclaude/mcp/configs): `src/superclaude/mcp/configs`

### Development Workflows

- [Slash Commands](https://github.com/superclaude-org/superclaude_framework/tree/master/src/superclaude/commands): `src/superclaude/commands`
- [Specialized Agents](https://github.com/superclaude-org/superclaude_framework/tree/master/src/superclaude/agents): `src/superclaude/agents`
- [Behavior Modes](https://github.com/superclaude-org/superclaude_framework/tree/master/src/superclaude/modes): `src/superclaude/modes`
- [Skills](https://github.com/superclaude-org/superclaude_framework/tree/master/src/superclaude/skills): `src/superclaude/skills`

### Execution Support

- [Parallel Execution](https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/execution/parallel.py): `src/superclaude/execution/parallel.py`
- [Pre-task Reflection](https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/execution/reflection.py): `src/superclaude/execution/reflection.py`
- [Self-Correction](https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/execution/self_correction.py): `src/superclaude/execution/self_correction.py`

### PM Agent Checks

- [Pytest Plugin](https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/pytest_plugin.py): `src/superclaude/pytest_plugin.py`
- [Confidence Check](https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/pm_agent/confidence.py): `src/superclaude/pm_agent/confidence.py`
- [Evidence Self-Check](https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/pm_agent/self_check.py): `src/superclaude/pm_agent/self_check.py`
- [Reflexion Learning](https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/pm_agent/reflexion.py): `src/superclaude/pm_agent/reflexion.py`
- [Token Budget](https://github.com/superclaude-org/superclaude_framework/blob/master/src/superclaude/pm_agent/token_budget.py): `src/superclaude/pm_agent/token_budget.py`

### Other components

- **Developer**
- **Claude Code**
- **MCP Services**

## Connections

- Developer → SuperClaude CLI: runs (evidence: `README.md`)
- SuperClaude CLI → Command Installer: dispatches install (evidence: `src/superclaude/cli/main.py`)
- SuperClaude CLI → MCP Installer: dispatches MCP setup (evidence: `src/superclaude/cli/main.py`)
- SuperClaude CLI → Health Checks: runs diagnostics (evidence: `src/superclaude/cli/main.py`)
- Command Installer → Slash Commands: installs commands (evidence: `README.md`)
- Command Installer → Specialized Agents: installs agents
- MCP Installer → MCP Configurations: uses configuration (evidence: `src/superclaude/cli/install_mcp.py`)
- MCP Installer → MCP Services: registers servers (evidence: `src/superclaude/cli/install_mcp.py`)
- MCP Installer → Claude Code: registers servers (evidence: `src/superclaude/cli/install_mcp.py`)
- Claude Code → Slash Commands: uses commands (evidence: `README.md`)
- Claude Code → Specialized Agents: uses agents (evidence: `README.md`)
- Claude Code → Behavior Modes: uses modes (evidence: `README.md`)
- Claude Code → Skills: uses skills
- Claude Code → MCP Services: optionally connects (evidence: `README.md`)
- Pytest Plugin → Confidence Check: provides fixture (evidence: `src/superclaude/pytest_plugin.py`)
- Pytest Plugin → Evidence Self-Check: provides fixture (evidence: `src/superclaude/pytest_plugin.py`)
- Pytest Plugin → Reflexion Learning: provides fixture (evidence: `src/superclaude/pytest_plugin.py`)
- Pytest Plugin → Token Budget: provides fixture (evidence: `src/superclaude/pytest_plugin.py`)
