🚀 SuperClaude Quick Start Guide

Context Engineering Framework for Claude Code

💡 Key Insight: SuperClaude doesn't replace Claude Code - it configures and enhances it through behavioral context injection

<p align="center"> <a href="#-how-it-works">How It Works</a> • <a href="#-instant-start">Instant Start</a> • <a href="#-core-components">Components</a> • <a href="#-workflow-patterns">Workflows</a> • <a href="#-when-to-use">When to Use</a> </p> </div>

📊 Framework Capabilities

Commands	AI Agents	Behavioral Modes	MCP Servers
30	20	7	8
`/sc:` triggers	Domain specialists	Context adaptation	Tool integration

</div>

🎯 How It Works

Framework Architecture Flow

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  User Input     │────>│   Claude Code    │────>│  Context Files  │
│  /sc:command    │     │  Reads Context   │     │  (.md behaviors)│
└─────────────────┘     └──────────────────┘     └─────────────────┘
                               │                          │
                               ▼                          ▼
┌─────────────────┐      ┌──────────────────┐     ┌─────────────────┐
│   Enhanced      │<─────│    Behavioral    │<────│   MCP Servers   │
│   Response      │      │    Activation    │     │ (if configured) │
└─────────────────┘      └──────────────────┘     └─────────────────┘

The Magic: When you type /sc:brainstorm, Claude reads behavioral instructions from installed .md files and responds with enhanced capabilities

</div>

⚡ Instant Start

5-Minute Journey from Installation to First Command

</div> <table> <tr> <th width="50%">📦 Step 1: Install (Terminal)</th> <th width="50%">💬 Step 2: Use (Claude Code)</th> </tr> <tr> <td valign="top">

bash

# Quick install with pipx
pipx install SuperClaude && SuperClaude install

# Or traditional pip
pip install SuperClaude && SuperClaude install

# Or via npm
npm install -g @bifrost_inc/superclaude && superclaude install

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

text

# Interactive discovery
/sc:brainstorm "web app for task management"

# Analyze existing code
/sc:analyze src/

# Generate implementation
/sc:implement "user authentication"

# Activate specialist
@agent-security "review auth flow"

</td> </tr> </table> <details> <summary><b>🎥 What Happens Behind the Scenes</b></summary>

Context Loading: Claude Code imports behavioral .md files via CLAUDE.md
Pattern Recognition: Recognizes /sc: and @agent- trigger patterns
Behavioral Activation: Applies corresponding instructions from context files
MCP Integration: Uses configured external tools when available
Response Enhancement: Follows framework patterns for comprehensive responses

</details>

🔧 Core Components

Four Pillars of SuperClaude

📝 Commands

Slash Commands

/sc:brainstorm
/sc:implement
/sc:analyze
/sc:workflow

Workflow automation

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

🤖 Agents

AI Specialists

@agent-architect
@agent-security
@agent-frontend
@agent-backend

Domain expertise

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

🎯 Modes

Behavioral Modes

Brainstorming
Introspection
Orchestration
Task Management

Context adaptation

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

🔌 MCP

Server Integration

Context7 (docs)
Sequential (analysis)
Magic (UI)
Playwright (testing)

Enhanced tools

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

📚 Workflow Patterns

Complete Development Lifecycle

</div>

🌟 First Project Session

<table> <tr> <th>Step</th> <th>Command</th> <th>What Happens</th> </tr> <tr> <td><b>1. Discovery</b></td> <td><code>/sc:brainstorm "e-commerce app"</code></td> <td>Interactive requirements exploration</td> </tr> <tr> <td><b>2. Load Context</b></td> <td><code>/sc:load src/</code></td> <td>Import existing project structure</td> </tr> <tr> <td><b>3. Analysis</b></td> <td><code>/sc:analyze --focus architecture</code></td> <td>Deep architectural review</td> </tr> <tr> <td><b>4. Planning</b></td> <td><code>/sc:workflow "payment integration"</code></td> <td>Generate implementation roadmap</td> </tr> <tr> <td><b>5. Implementation</b></td> <td><code>/sc:implement "Stripe checkout"</code></td> <td>Build with best practices</td> </tr> <tr> <td><b>6. Validation</b></td> <td><code>/sc:test --coverage</code></td> <td>Comprehensive testing</td> </tr> <tr> <td><b>7. Save Session</b></td> <td><code>/sc:save "payment-complete"</code></td> <td>Persist for next session</td> </tr> </table>

🎨 Domain-Specific Workflows

Domain	Trigger	Specialist Activation	MCP Server
Frontend	UI component request	`@agent-frontend`	Magic
Backend	API endpoint creation	`@agent-backend`	Sequential
Security	Auth implementation	`@agent-security`	Context7
Testing	E2E test scenarios	`@agent-qa`	Playwright
DevOps	Deployment setup	`@agent-devops`	Morphllm

</div>

🎯 When to Use

SuperClaude vs Standard Claude Code

<table> <tr> <th width="50%">✅ Use SuperClaude</th> <th width="50%">💭 Use Standard Claude</th> </tr> <tr> <td valign="top">

Perfect for:

🏗️ Building complete software projects
📊 Systematic workflows with quality gates
🔄 Complex, multi-component systems
💾 Long-term projects needing persistence
👥 Team collaboration with standards
🎯 Domain-specific expertise needs

Examples:

"Build a full-stack application"
"Implement secure authentication"
"Refactor legacy codebase"
"Create comprehensive test suite"

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

Better for:

💡 Simple questions or explanations
⚡ One-off coding tasks
📚 Learning programming concepts
🧪 Quick prototypes or experiments
🔍 Code snippet generation
❓ General programming help

Examples:

"Explain how async/await works"
"Write a sorting function"
"Debug this error message"
"Convert this loop to functional"

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

🎓 Learning Path

Your 4-Week Journey to Mastery

<table> <tr> <th>Week</th> <th>Focus</th> <th>Skills</th> <th>Milestone</th> </tr> <tr> <td align="center"><b>1</b> 🌱</td> <td><b>Core Commands</b></td> <td> • <code>/sc:brainstorm</code>

• <code>/sc:analyze</code>

• <code>/sc:implement</code>

</td> <td>Complete first project</td> </tr> <tr> <td align="center"><b>2</b> 🌿</td> <td><b>Behavioral Modes</b></td> <td> • Mode combinations

• Flag usage

• Context optimization

</td> <td>Optimize workflows</td> </tr> <tr> <td align="center"><b>3</b> 🌿</td> <td><b>MCP Servers</b></td> <td> • Server configuration

• Tool integration

• Enhanced capabilities

</td> <td>Full tool utilization</td> </tr> <tr> <td align="center"><b>4</b> 🌲</td> <td><b>Advanced Patterns</b></td> <td> • Custom workflows

• Session management

• Team patterns

</td> <td>Framework mastery</td> </tr> </table> </div>

💡 Key Insights

Understanding SuperClaude's Value

🧠 Not Software

It's a Framework

SuperClaude is behavioral configuration, not standalone software. Everything runs through Claude Code.

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

🔄 Systematic

Not Ad-hoc

Transforms random requests into structured workflows with quality gates and validation.

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

🚀 Progressive

Not Complex

Start simple with basic commands. Complexity emerges naturally as needed.

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

📖 Next Steps

Continue Your Learning Journey

<table> <tr> <th>🌱 Beginner</th> <th>🌿 Intermediate</th> <th>🌲 Advanced</th> </tr> <tr> <td valign="top">

First Week:

Start with /sc:brainstorm

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

Growing Skills:

Explore mode combinations

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

Expert Usage:

Create custom workflows

</td> </tr> </table> <p align="center"> <a href="../user-guide/commands.md"> </a> <a href="../reference/examples-cookbook.md"> </a> </p> </div>

🎉 Ready to Transform Your Development Workflow?

<p align="center"> <b>Start now with</b> <code>/sc:brainstorm</code> <b>in Claude Code!</b> </p> <p align="center"> <sub>SuperClaude v4.3.0 - Context Engineering for Claude Code</sub> </p> </div>