Repository: SuperClaude-Org/SuperClaude_Framework

Stars: 22324

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

🐍 Python Environment Rules

CRITICAL: This project uses UV for all Python operations. Never use python -m, pip install, or python script.py directly.

Required Commands

bash

All Python operations must use UV

uv run pytest                    # Run tests
uv run pytest tests/pm_agent/   # Run specific tests
uv pip install package           # Install dependencies
uv run python script.py          # Execute scripts

📂 Project Structure

Current v4.3.0 Architecture: Python package with 30 commands, 20 agents, 7 modes

text

Claude Code Configuration (v4.3.0)

Installed via superclaude install to user's home directory

~/.claude/
├── settings.json
├── commands/sc/         # 30 slash commands (/sc:research, /sc:implement, etc.)
│   ├── pm.md
│   ├── research.md
│   ├── implement.md
│   └── ... (30 total)
├── agents/              # 20 domain-specialist agents (@pm-agent, @system-architect, etc.)
│   ├── pm-agent.md
│   ├── system-architect.md
│   └── ... (20 total)
└── skills/              # Skills (confidence-check, etc.)
Python Package

src/superclaude/
├── __init__.py          # Public API: ConfidenceChecker, SelfCheckProtocol, ReflexionPattern
├── pytest_plugin.py     # Auto-loaded pytest integration (5 fixtures, 9 markers)
├── pm_agent/            # confidence.py, self_check.py, reflexion.py, token_budget.py
├── execution/           # parallel.py, reflection.py, self_correction.py
├── cli/                 # main.py, doctor.py, install_commands.py, install_mcp.py, install_skill.py
├── commands/            # 30 slash command definitions (.md files)
├── agents/              # 20 agent definitions (.md files)
├── modes/               # 7 behavioral modes (.md files)
├── skills/              # Installable skills (confidence-check, etc.)
├── hooks/               # Claude Code hook definitions
├── mcp/                 # MCP server configurations (10 servers)
└── core/                # Core utilities
Project Files

tests/                   # Python test suite (136 tests)
├── unit/                # Unit tests (auto-marked @pytest.mark.unit)
└── integration/         # Integration tests (auto-marked @pytest.mark.integration)
docs/                    # Documentation
scripts/                 # Analysis tools (workflow metrics, A/B testing)
plugins/                 # Exported plugin artefacts for distribution
PLANNING.md              # Architecture, absolute rules
TASK.md                  # Current tasks
KNOWLEDGE.md             # Accumulated insights

Claude Code Integration Points

SuperClaude integrates with Claude Code through these mechanisms:
- Slash Commands: 30 commands installed to ~/.claude/commands/sc/ (e.g., /sc:pm, /sc:research)
- Agents: 20 agents installed to ~/.claude/agents/ (e.g., @pm-agent, @system-architect)
- Skills: Installed to ~/.claude/skills/ (e.g., confidence-check)
- Hooks: Session lifecycle hooks in src/superclaude/hooks/
- Settings: Project settings in .claude/settings.json
- Pytest Plugin: Auto-loaded via entry point, provides fixtures and markers
- MCP Servers: 8+ servers configurable via superclaude mcp

🔧 Development Workflow

Essential Commands

bash

Setup

make dev              # Install in editable mode with dev dependencies
make verify           # Verify installation (package, plugin, health)
Testing

make test             # Run full test suite
uv run pytest tests/pm_agent/ -v              # Run specific directory
uv run pytest tests/test_file.py -v           # Run specific file
uv run pytest -m confidence_check             # Run by marker
uv run pytest --cov=superclaude               # With coverage
Code Quality

make lint             # Run ruff linter
make format           # Format code with ruff
make doctor           # Health check diagnostics
MCP Servers

superclaude mcp                              # Interactive install (gateway default)
superclaude mcp --list                       # List available servers
superclaude mcp --servers airis-mcp-gateway  # Install AIRIS Gateway (recommended)
superclaude mcp --servers tavily context7    # Install individual servers
Plugin Packaging

make build-plugin            # Build plugin artefacts into dist/
make sync-plugin-repo        # Sync artefacts into ../SuperClaude_Plugin
Maintenance

make clean            # Remove build artifacts

📦 Core Architecture

Pytest Plugin (Auto-loaded)

Registered via pyproject.toml entry point, automatically available after installation.

Fixtures: confidence_checker, self_check_protocol, reflexion_pattern, token_budget, pm_context

Auto-markers:
- Tests in /unit/ → @pytest.mark.unit
- Tests in /integration/ → @pytest.mark.integration

Custom markers: @pytest.mark.confidence_check, @pytest.mark.self_check, @pytest.mark.reflexion

PM Agent - Three Core Patterns

1. ConfidenceChecker (src/superclaude/pm_agent/confidence.py)
- Pre-execution confidence assessment: ≥90% required, 70-89% present alternatives, <70% ask questions
- Prevents wrong-direction work, ROI: 25-250x token savings

2. SelfCheckProtocol (src/superclaude/pm_agent/self_check.py)
- Post-implementation evidence-based validation
- No speculation - verify with tests/docs

3. ReflexionPattern (src/superclaude/pm_agent/reflexion.py)
- Error learning and prevention
- Cross-session pattern matching

Parallel Execution

Wave → Checkpoint → Wave pattern (src/superclaude/execution/parallel.py):
- 3.5x faster than sequential execution
- Automatic dependency analysis
- Example: [Read files in parallel] → Analyze → [Edit files in parallel]

Slash Commands, Agents & Modes (v4.3.0)

- Install via: pipx install superclaude && superclaude install
- 30 Commands installed to ~/.claude/commands/sc/ (e.g., /sc:pm, /sc:research, /sc:implement)
- 20 Agents installed to ~/.claude/agents/ (e.g., @pm-agent, @system-architect, @deep-research)
- 7 Behavioral Modes: Brainstorming, Business Panel, Deep Research, Introspection, Orchestration, Task Management, Token Efficiency
- Skills: Installable to ~/.claude/skills/ (e.g., confidence-check)

Note: TypeScript plugin system planned for v5.0 (#419)

🧪 Testing with PM Agent

Example Test with Markers

python

@pytest.mark.confidence_check
def test_feature(confidence_checker):
    """Pre-execution confidence check - skips if < 70%"""
    context = {"test_name": "test_feature", "has_official_docs": True}
    assert confidence_checker.assess(context) >= 0.7
@pytest.mark.self_check
def test_implementation(self_check_protocol):
    """Post-implementation validation with evidence"""
    implementation = {"code": "...", "tests": [...]}
    passed, issues = self_check_protocol.validate(implementation)
    assert passed, f"Validation failed: {issues}"
@pytest.mark.reflexion
def test_error_learning(reflexion_pattern):
    """If test fails, reflexion records for future prevention"""
    pass@pytest.mark.complexity("medium")  # simple: 200, medium: 1000, complex: 2500
def test_with_budget(token_budget):
    """Token budget allocation"""
    assert token_budget.limit == 1000

🌿 Git Workflow

Branch structure: master (production) ← integration (testing) ← feature/, fix/, docs/*

Standard workflow:
1. Create branch from integration: git checkout -b feature/your-feature
2. Develop with tests: uv run pytest
3. Commit: git commit -m "feat: description" (conventional commits)
4. Merge to integration → validate → merge to master

Current branch: See git status in session start output

Parallel Development with Git Worktrees

CRITICAL: When running multiple Claude Code sessions in parallel, use git worktree to avoid conflicts.

bash

Create worktree for integration branch

cd ~/github/SuperClaude_Framework
git worktree add ../SuperClaude_Framework-integration integration
Create worktree for feature branch

git worktree add ../SuperClaude_Framework-feature feature/pm-agent

Benefits:
- Run Claude Code sessions on different branches simultaneously
- No branch switching conflicts
- Independent working directories
- Parallel development without state corruption

Usage:
- Session A: Open ~/github/SuperClaude_Framework/ (current branch)
- Session B: Open ~/github/SuperClaude_Framework-integration/ (integration)
- Session C: Open ~/github/SuperClaude_Framework-feature/ (feature branch)

Cleanup:

bash

git worktree remove ../SuperClaude_Framework-integration

📝 Key Documentation Files

PLANNING.md - Architecture, design principles, absolute rules
TASK.md - Current tasks and priorities
KNOWLEDGE.md - Accumulated insights and troubleshooting

Additional docs in docs/user-guide/, docs/developer-guide/, docs/reference/

💡 Core Development Principles

1. Evidence-Based Development

Never guess - verify with official docs (Context7 MCP, WebFetch, WebSearch) before implementation.

2. Confidence-First Implementation

Check confidence BEFORE starting: ≥90% proceed, 70-89% present alternatives, <70% ask questions.

3. Parallel-First Execution

Use Wave → Checkpoint → Wave pattern (3.5x faster). Example: [Read files in parallel] → Analyze → [Edit files in parallel]

4. Token Efficiency

- Simple (typo): 200 tokens
- Medium (bug fix): 1,000 tokens
- Complex (feature): 2,500 tokens
- Confidence check ROI: spend 100-200 to save 5,000-50,000

🔧 MCP Server Integration

Recommended: Use airis-mcp-gateway for unified MCP management.

bash

superclaude mcp  # Interactive install, gateway is default (requires Docker)

Gateway Benefits: 60+ tools, 98% token reduction, single SSE endpoint, Web UI

High Priority Servers (included in gateway):
- Tavily: Web search (Deep Research)
- Context7: Official documentation (prevent hallucination)
- Sequential: Token-efficient reasoning (30-50% reduction)
- Serena: Session persistence
- Mindbase: Cross-session learning

Optional: Playwright (browser automation), Magic (UI components), Chrome DevTools (performance)

Usage: TypeScript plugins and Python pytest plugin can call MCP servers. Always prefer MCP tools over speculation for documentation/research.

🚀 Development & Installation

Current Installation Method (v4.3.0)

Standard Installation:

bash

Option 1: pipx (recommended)

pipx install superclaude
superclaude install
Option 2: Direct from repo

git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework
./install.sh

Development Mode:

bash

Install in editable mode

make dev
Run tests

make test
Verify installation

make verify

Plugin System (v5.0 - Not Yet Available)

The TypeScript plugin system (.claude-plugin/, marketplace) is planned for v5.0.
See docs/plugin-reorg.md for details.

📊 Package Information

Package name: superclaude
Version: 4.3.0
Python: >=3.10
Build system: hatchling (PEP 517)

Entry points:
- CLI: superclaude command
- Pytest plugin: Auto-loaded as superclaude

Dependencies:
- pytest>=7.0.0
- click>=8.0.0
- rich>=13.0.0

🔌 Claude Code Native Features (for developers)

SuperClaude extends Claude Code through its native extension points. When developing SuperClaude features, use these Claude Code capabilities:

Extension Points We Use

- Custom Commands (~/.claude/commands/sc/.md): 30 /sc: commands
- Custom Agents (~/.claude/agents/*.md): 20 domain-specialist agents
- Skills (~/.claude/skills/): confidence-check skill
- Settings (.claude/settings.json): Permission rules, hooks
- MCP Servers: 8 pre-configured + AIRIS gateway
- Pytest Plugin: Auto-loaded via entry point

Extension Points We Should Use More

- Hooks (28 events): SessionStart, Stop, PostToolUse, TaskCompleted — ideal for PM Agent auto-restore, self-check validation, and reflexion triggers
- Skills System: Commands should migrate to proper skills with YAML frontmatter for auto-triggering, tool restrictions, and effort overrides
- Plan Mode: Could integrate with confidence checks (block implementation when < 70%)
- Settings Profiles: Could provide recommended permission/hook configs per workflow
- Native Session Persistence: --continue/--resume instead of custom memory files

See docs/user-guide/claude-code-integration.md for the full gap analysis.

README.md

🚀 SuperClaude Framework

![Run in Smithery](https://smithery.ai/skills?ns=SuperClaude-Org&utm_source=github&utm_medium=badge)

Transform Claude Code into a Structured Development Platform

<p align="center">
<a href="#-quick-installation">Quick Start</a> •
<a href="#-support-the-project">Support</a> •
<a href="#-whats-new-in-v4">Features</a> •
<a href="#-documentation">Docs</a> •
<a href="#-contributing">Contributing</a>
</p>

</div>

---

📊 Framework Statistics

| Commands | Agents | Modes | MCP Servers |
|:------------:|:----------:|:---------:|:---------------:|
| 30 | 20 | 7 | 8 |
| Slash Commands | Specialized AI | Behavioral | Integrations |

30 slash commands covering the complete development lifecycle from brainstorming to deployment.

</div>

---

🎯 Overview

SuperClaude is a meta-programming configuration framework that transforms Claude Code into a structured development platform through behavioral instruction injection and component orchestration. It provides systematic workflow automation with powerful tools and intelligent agents.

Disclaimer

This project is not affiliated with or endorsed by Anthropic.
Claude Code is a product built and maintained by Anthropic.

📖 For Developers & Contributors

Essential documentation for working with SuperClaude Framework:

| Document | Purpose | When to Read |
|----------|---------|--------------|
| PLANNING.md | Architecture, design principles, absolute rules | Session start, before implementation |
| TASK.md | Current tasks, priorities, backlog | Daily, before starting work |
| KNOWLEDGE.md | Accumulated insights, best practices, troubleshooting | When encountering issues, learning patterns |
| CONTRIBUTING.md | Contribution guidelines, workflow | Before submitting PRs |
| Commands Reference | Complete reference for all 30 /sc:* commands with syntax, examples, workflows, and decision guides | Learning SuperClaude, choosing the right command |

💡 Pro Tip: Claude Code reads these files at session start to ensure consistent, high-quality development aligned with project standards.

> 📚 New to SuperClaude? Start with Commands Reference — it contains visual decision trees, detailed command comparisons, and workflow examples to help you understand which commands to use and when.

⚡ Quick Installation

IMPORTANT: The TypeScript plugin system described in older documentation is

not yet available (planned for v5.0). For current installation

instructions, please follow the steps below for v4.x.

Current Stable Version (v4.3.0)

SuperClaude currently uses slash commands.

Option 1: pipx (Recommended)

bash

Install from PyPI

pipx install superclaude
Install commands (installs all 30 slash commands)

superclaude install
Install MCP servers (optional, for enhanced capabilities)

superclaude mcp --list         # List available MCP servers
superclaude mcp                # Interactive installation
superclaude mcp --servers tavily --servers context7  # Install specific servers
Verify installation

superclaude install --list
superclaude doctor

After installation, restart Claude Code to use 30 commands including:
- /sc:research - Deep web research (enhanced with Tavily MCP)
- /sc:brainstorm - Structured brainstorming
- /sc:implement - Code implementation
- /sc:test - Testing workflows
- /sc:pm - Project management
- /sc - Show all 30 available commands

Option 2: Direct Installation from Git

bash

Clone the repository

git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework
Run the installation script

./install.sh

Coming in v5.0 (In Development)

We are actively working on a new TypeScript plugin system (see issue #419 for details). When released, installation will be simplified to:

bash

This feature is not yet available

/plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace
/plugin install superclaude

Status: In development. No ETA has been set.

Enhanced Performance (Optional MCPs)

For 2-3x faster execution and 30-50% fewer tokens, optionally install MCP servers:

bash

Optional MCP servers for enhanced performance (via airis-mcp-gateway):

- Serena: Code understanding (2-3x faster)

- Sequential: Token-efficient reasoning (30-50% fewer tokens)

- Tavily: Web search for Deep Research

- Context7: Official documentation lookup

- Mindbase: Semantic search across all conversations (optional enhancement)
Note: Error learning available via built-in ReflexionMemory (no installation required)

Mindbase provides semantic search enhancement (requires "recommended" profile)

Install MCP servers: https://github.com/agiletec-inc/airis-mcp-gateway

See docs/mcp/mcp-integration-policy.md for details

Performance Comparison:
- Without MCPs: Fully functional, standard performance ✅
- With MCPs: 2-3x faster, 30-50% fewer tokens ⚡

</div>

---

💖 Support the Project

Hey, let's be real - maintaining SuperClaude takes time and resources.

> The Claude Max subscription alone runs $100/month for testing, and that's before counting the hours spent on documentation, bug fixes, and feature development.

If you're finding value in SuperClaude for your daily work, consider supporting the project.

Even a few dollars helps cover the basics and keeps development active.

> Every contributor matters, whether through code, feedback, or support. Thanks for being part of this community! 🙏

☕ Ko-fi

![Ko-fi](https://ko-fi.com/superclaude)

One-time contributions

</td>
<td align="center" width="33%">

🎯 Patreon

![Patreon](https://patreon.com/superclaude)

Monthly support

</td>
<td align="center" width="33%">

💜 GitHub

![GitHub Sponsors](https://github.com/sponsors/SuperClaude-Org)

Flexible tiers

</td>
</tr>
</table>

Your Support Enables:

| Item | Cost/Impact |
|------|-------------|
| 🔬 Claude Max Testing | $100/month for validation & testing |
| ⚡ Feature Development | New capabilities & improvements |
| 📚 Documentation | Comprehensive guides & examples |
| 🤝 Community Support | Quick issue responses & help |
| 🔧 MCP Integration | Testing new server connections |
| 🌐 Infrastructure | Hosting & deployment costs |

Note: No pressure though - the framework stays open source regardless. Just knowing people use and appreciate it is motivating. Contributing code, documentation, or spreading the word helps too! 🙏

</div>

---

🎉 What's New in v4.1

Version 4.1 focuses on stabilizing the slash command architecture, enhancing agent capabilities, and improving documentation.

🤖 Smarter Agent System

20 specialized agents with domain expertise:
- PM Agent ensures continuous learning through systematic documentation
- Deep Research agent for autonomous web research
- Security engineer catches real vulnerabilities
- Frontend architect understands UI patterns
- Automatic coordination based on context
- Domain-specific expertise on demand

</td>
<td width="50%">

⚡ Optimized Performance

Smaller framework, bigger projects:
- Reduced framework footprint
- More context for your code
- Longer conversations possible
- Complex operations enabled

</td>
</tr>
<tr>
<td width="50%">

🔧 MCP Server Integration

8 powerful servers with easy CLI installation:

bash

List available MCP servers

superclaude mcp --list
Install specific servers

superclaude mcp --servers tavily context7
Interactive installation

superclaude mcp

Available servers:
- Tavily → Primary web search (Deep Research)
- Context7 → Official documentation lookup
- Sequential-Thinking → Multi-step reasoning
- Serena → Session persistence & memory
- Playwright → Cross-browser automation
- Magic → UI component generation
- Morphllm-Fast-Apply → Context-aware code modifications
- Chrome DevTools → Performance analysis

</td>
<td width="50%">

🎯 Behavioral Modes

7 adaptive modes for different contexts:
- Brainstorming → Asks right questions
- Business Panel → Multi-expert strategic analysis
- Deep Research → Autonomous web research
- Orchestration → Efficient tool coordination
- Token-Efficiency → 30-50% context savings
- Task Management → Systematic organization
- Introspection → Meta-cognitive analysis

</td>
</tr>
<tr>
<td width="50%">

📚 Documentation Overhaul

Complete rewrite for developers:
- Real examples & use cases
- Common pitfalls documented
- Practical workflows included
- Better navigation structure

</td>
<td width="50%">

🧪 Enhanced Stability

Focus on reliability:
- Bug fixes for core commands
- Improved test coverage
- More robust error handling
- CI/CD pipeline improvements

</td>
</tr>
</table>

</div>

---

🔬 Deep Research Capabilities

Autonomous Web Research Aligned with DR Agent Architecture

SuperClaude v4.2 introduces comprehensive Deep Research capabilities, enabling autonomous, adaptive, and intelligent web research.

🎯 Adaptive Planning

Three intelligent strategies:
- Planning-Only: Direct execution for clear queries
- Intent-Planning: Clarification for ambiguous requests
- Unified: Collaborative plan refinement (default)

</td>
<td width="50%">

🔄 Multi-Hop Reasoning

Up to 5 iterative searches:
- Entity expansion (Paper → Authors → Works)
- Concept deepening (Topic → Details → Examples)
- Temporal progression (Current → Historical)
- Causal chains (Effect → Cause → Prevention)

</td>
</tr>
<tr>
<td width="50%">

📊 Quality Scoring

Confidence-based validation:
- Source credibility assessment (0.0-1.0)
- Coverage completeness tracking
- Synthesis coherence evaluation
- Minimum threshold: 0.6, Target: 0.8

</td>
<td width="50%">

🧠 Case-Based Learning

Cross-session intelligence:
- Pattern recognition and reuse
- Strategy optimization over time
- Successful query formulations saved
- Performance improvement tracking

</td>
</tr>
</table>

Research Command Usage

bash

Basic research with automatic depth

/research "latest AI developments 2024"
Controlled research depth (via options in TypeScript)

/research "quantum computing breakthroughs"  # depth: exhaustive
Specific strategy selection

/research "market analysis"  # strategy: planning-only
Domain-filtered research (Tavily MCP integration)

/research "React patterns"  # domains: reactjs.org,github.com

Research Depth Levels

| Depth | Sources | Hops | Time | Best For |
|:-----:|:-------:|:----:|:----:|----------|
| Quick | 5-10 | 1 | ~2min | Quick facts, simple queries |
| Standard | 10-20 | 3 | ~5min | General research (default) |
| Deep | 20-40 | 4 | ~8min | Comprehensive analysis |
| Exhaustive | 40+ | 5 | ~10min | Academic-level research |

Integrated Tool Orchestration

The Deep Research system intelligently coordinates multiple tools:
- Tavily MCP: Primary web search and discovery
- Playwright MCP: Complex content extraction
- Sequential MCP: Multi-step reasoning and synthesis
- Serena MCP: Memory and learning persistence
- Context7 MCP: Technical documentation lookup

</div>

---

📚 Documentation

Complete Guide to SuperClaude

<table>
<tr>
<th align="center">🚀 Getting Started</th>
<th align="center">📖 User Guides</th>
<th align="center">🛠️ Developer Resources</th>
<th align="center">📋 Reference</th>
</tr>
<tr>
<td valign="top">

- 📝 Quick Start Guide
Get up and running fast

- 💾 Installation Guide
Detailed setup instructions

</td>
<td valign="top">

- 🎯 Slash Commands
All 30 commands organized by category

- 🤖 Agents Guide
20 specialized agents

- 🎨 Behavioral Modes
7 adaptive modes

- 🚩 Flags Guide
Control behaviors

- 🔧 MCP Servers
8 server integrations

- 💼 Session Management
Save & restore state

</td>
<td valign="top">

- 🏗️ Technical Architecture
System design details

- 💻 Contributing Code
Development workflow

- 🧪 Testing & Debugging
Quality assurance

</td>
<td valign="top">
- 📓 Examples Cookbook
Real-world recipes

- 🔍 Troubleshooting
Common issues & fixes

</td>
</tr>
</table>

</div>

---

🤝 Contributing

Join the SuperClaude Community

We welcome contributions of all kinds! Here's how you can help:

| Priority | Area | Description |
|:--------:|------|-------------|
| 📝 High | Documentation | Improve guides, add examples, fix typos |
| 🔧 High | MCP Integration | Add server configs, test integrations |
| 🎯 Medium | Workflows | Create command patterns & recipes |
| 🧪 Medium | Testing | Add tests, validate features |
| 🌐 Low | i18n | Translate docs to other languages |

</div>

---

⚖️ License

This project is licensed under the MIT License - see the LICENSE file for details.

</div>

---

⭐ Star History

</div>

---

🚀 Built with passion by the SuperClaude community

<p align="center">
<sub>Made with ❤️ for developers who push boundaries</sub>
</p>

</div>

---

📋 All 30 Commands

<details>
<summary><b>Click to expand full command list</b></summary>

🧠 Planning & Design (4)

- /brainstorm - Structured brainstorming
- /design - System architecture
- /estimate - Time/effort estimation
- /spec-panel - Specification analysis

💻 Development (5)

- /implement - Code implementation
- /build - Build workflows
- /improve - Code improvements
- /cleanup - Refactoring
- /explain - Code explanation

🧪 Testing & Quality (4)

- /test - Test generation
- /analyze - Code analysis
- /troubleshoot - Debugging
- /reflect - Retrospectives

📚 Documentation (2)

- /document - Doc generation
- /help - Command help

🔧 Version Control (1)

- /git - Git operations

📊 Project Management (3)

- /pm - Project management
- /task - Task tracking
- /workflow - Workflow automation

🔍 Research & Analysis (2)

- /research - Deep web research
- /business-panel - Business analysis

🎯 Utilities (9)

- /agent - AI agents
- /index-repo - Repository indexing
- /index - Indexing alias
- /recommend - Command recommendations
- /select-tool - Tool selection
- /spawn - Parallel tasks
- /load - Load sessions
- /save - Save sessions
- /sc - Show all commands

📖 View Detailed Command Reference →

</details>

Repository: SuperClaude-Org/SuperClaude_Framework

Stars: 22324

CLAUDE.md Copy Chapter

CLAUDE.md

🐍 Python Environment Rules Copy Chapter

Required Commands Copy Section

All Python operations must use UV

📂 Project Structure Copy Chapter

Claude Code Configuration (v4.3.0)

Installed via superclaude install to user's home directory

Python Package

Project Files

Claude Code Integration Points Copy Section

🔧 Development Workflow Copy Chapter

Essential Commands Copy Section

Setup

Testing

Code Quality

MCP Servers

Plugin Packaging

Maintenance

📦 Core Architecture Copy Chapter

Pytest Plugin (Auto-loaded) Copy Section

PM Agent - Three Core Patterns Copy Section

Parallel Execution Copy Section

Slash Commands, Agents & Modes (v4.3.0) Copy Section

🧪 Testing with PM Agent Copy Chapter

Example Test with Markers Copy Section

🌿 Git Workflow Copy Chapter

Parallel Development with Git Worktrees Copy Section

Create worktree for integration branch

Create worktree for feature branch

📝 Key Documentation Files Copy Chapter

💡 Core Development Principles Copy Chapter

1. Evidence-Based Development Copy Section

2. Confidence-First Implementation Copy Section

3. Parallel-First Execution Copy Section

4. Token Efficiency Copy Section

🔧 MCP Server Integration Copy Chapter

🚀 Development & Installation Copy Chapter

Current Installation Method (v4.3.0) Copy Section

Option 1: pipx (recommended)

Option 2: Direct from repo

Install in editable mode

Run tests

Verify installation

Plugin System (v5.0 - Not Yet Available) Copy Section

📊 Package Information Copy Chapter

🔌 Claude Code Native Features (for developers) Copy Chapter

Extension Points We Use Copy Section

Extension Points We Should Use More Copy Section

README.md Copy Chapter

🚀 SuperClaude Framework

Transform Claude Code into a Structured Development Platform Copy Section

📊 Framework Statistics Copy Chapter

🎯 Overview Copy Chapter

Disclaimer Copy Chapter

📖 For Developers & Contributors Copy Chapter

⚡ Quick Installation Copy Chapter

Current Stable Version (v4.3.0) Copy Section

Install from PyPI

Install commands (installs all 30 slash commands)

Install MCP servers (optional, for enhanced capabilities)

Verify installation

Clone the repository

Run the installation script

Coming in v5.0 (In Development) Copy Section

This feature is not yet available

Enhanced Performance (Optional MCPs) Copy Section

Optional MCP servers for enhanced performance (via airis-mcp-gateway):

- Serena: Code understanding (2-3x faster)

- Sequential: Token-efficient reasoning (30-50% fewer tokens)

- Tavily: Web search for Deep Research

- Context7: Official documentation lookup

- Mindbase: Semantic search across all conversations (optional enhancement)

Note: Error learning available via built-in ReflexionMemory (no installation required)

Mindbase provides semantic search enhancement (requires "recommended" profile)

Install MCP servers: https://github.com/agiletec-inc/airis-mcp-gateway

See docs/mcp/mcp-integration-policy.md for details

💖 Support the Project Copy Chapter

CLAUDE.md

🐍 Python Environment Rules

Required Commands

📂 Project Structure

Installed via `superclaude install` to user's home directory

Claude Code Integration Points

🔧 Development Workflow

Essential Commands

📦 Core Architecture

Pytest Plugin (Auto-loaded)

PM Agent - Three Core Patterns

Parallel Execution

Slash Commands, Agents & Modes (v4.3.0)

🧪 Testing with PM Agent

Example Test with Markers

🌿 Git Workflow

Parallel Development with Git Worktrees

📝 Key Documentation Files

💡 Core Development Principles

1. Evidence-Based Development

2. Confidence-First Implementation

3. Parallel-First Execution

4. Token Efficiency

🔧 MCP Server Integration

🚀 Development & Installation

Current Installation Method (v4.3.0)

Plugin System (v5.0 - Not Yet Available)

📊 Package Information

🔌 Claude Code Native Features (for developers)

Extension Points We Use

Extension Points We Should Use More

README.md

Transform Claude Code into a Structured Development Platform

📊 Framework Statistics

🎯 Overview

Disclaimer

📖 For Developers & Contributors

⚡ Quick Installation

Current Stable Version (v4.3.0)

Coming in v5.0 (In Development)

Enhanced Performance (Optional MCPs)

💖 Support the Project

☕ Ko-fi

🎯 Patreon

💜 GitHub

Your Support Enables:

🎉 What's New in v4.1

🤖 Smarter Agent System

⚡ Optimized Performance

🔧 MCP Server Integration

🎯 Behavioral Modes

📚 Documentation Overhaul

🧪 Enhanced Stability

🔬 Deep Research Capabilities

Autonomous Web Research Aligned with DR Agent Architecture

🎯 Adaptive Planning

🔄 Multi-Hop Reasoning

📊 Quality Scoring

🧠 Case-Based Learning

Research Command Usage

Research Depth Levels

Integrated Tool Orchestration

📚 Documentation

Complete Guide to SuperClaude

🤝 Contributing

Join the SuperClaude Community

⚖️ License

⭐ Star History

🚀 Built with passion by the SuperClaude community

📋 All 30 Commands

🧠 Planning & Design (4)

💻 Development (5)

🧪 Testing & Quality (4)

📚 Documentation (2)

🔧 Version Control (1)

📊 Project Management (3)

🔍 Research & Analysis (2)

🎯 Utilities (9)