How superclaude-org/superclaude_framework works
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: pytest_plugin.py Pytest Plugin · main.py SuperClaude CLI · install_mcp.py MCP Installer · install_commands.py Command Installer
Components 20
Setup and Integration
- SuperClaude CLI
src/superclaude/cli/main.py - Command Installer
src/superclaude/cli/install_commands.py - MCP Installer
src/superclaude/cli/install_mcp.py - Health Checks
src/superclaude/cli/doctor.py - MCP Configurations
src/superclaude/mcp/configs
Development Workflows
- Slash Commands
src/superclaude/commands - Specialized Agents
src/superclaude/agents - Behavior Modes
src/superclaude/modes - Skills
src/superclaude/skills
Execution Support
- Parallel Execution
src/superclaude/execution/parallel.py - Pre-task Reflection
src/superclaude/execution/reflection.py - Self-Correction
src/superclaude/execution/self_correction.py
PM Agent Checks
- Pytest Plugin
src/superclaude/pytest_plugin.py - Confidence Check
src/superclaude/pm_agent/confidence.py - Evidence Self-Check
src/superclaude/pm_agent/self_check.py - Reflexion Learning
src/superclaude/pm_agent/reflexion.py - Token Budget
src/superclaude/pm_agent/token_budget.py
Other components
- Developer
- Claude Code
- MCP Services
Connections 18
- Developer → SuperClaude CLI: runs
README.md - SuperClaude CLI → Command Installer: dispatches install
src/superclaude/cli/main.py - SuperClaude CLI → MCP Installer: dispatches MCP setup
src/superclaude/cli/main.py - SuperClaude CLI → Health Checks: runs diagnostics
src/superclaude/cli/main.py - Command Installer → Slash Commands: installs commands
README.md - Command Installer → Specialized Agents: installs agents
- MCP Installer → MCP Configurations: uses configuration
src/superclaude/cli/install_mcp.py - MCP Installer → MCP Services: registers servers
src/superclaude/cli/install_mcp.py - MCP Installer → Claude Code: registers servers
src/superclaude/cli/install_mcp.py - Claude Code → Slash Commands: uses commands
README.md - Claude Code → Specialized Agents: uses agents
README.md - Claude Code → Behavior Modes: uses modes
README.md - Claude Code → Skills: uses skills
- Claude Code → MCP Services: optionally connects
README.md - Pytest Plugin → Confidence Check: provides fixture
src/superclaude/pytest_plugin.py - Pytest Plugin → Evidence Self-Check: provides fixture
src/superclaude/pytest_plugin.py - Pytest Plugin → Reflexion Learning: provides fixture
src/superclaude/pytest_plugin.py - Pytest Plugin → Token Budget: provides fixture
src/superclaude/pytest_plugin.py