SuperClaude/docs/Getting-Started/quick-start.md

🚀 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

How It Works • Instant Start • Components • Workflows • When to Use

---

📊 Framework Capabilities

Commands	AI Agents	Behavioral Modes	MCP Servers
21	14	6	6
/sc: triggers	Domain specialists	Context adaptation	Tool integration

---

🎯 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

---

⚡ Instant Start

5-Minute Journey from Installation to First Command

📦 Step 1: Install (Terminal)	💬 Step 2: Use (Claude Code)
# 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	# 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"

🎥 What Happens Behind the Scenes

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

---

🔧 Core Components

Four Pillars of SuperClaude

📝 Commands 21 Slash Commands /sc:brainstorm /sc:implement /sc:analyze /sc:workflow Workflow automation

🤖 Agents 14 AI Specialists @agent-architect @agent-security @agent-frontend @agent-backend Domain expertise

🎯 Modes 6 Behavioral Modes Brainstorming Introspection Orchestration Task Management Context adaptation

🔌 MCP 6 Server Integration Context7 (docs) Sequential (analysis) Magic (UI) Playwright (testing) Enhanced tools

---

📚 Workflow Patterns

Complete Development Lifecycle

🌟 First Project Session

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

🎨 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

---

🎯 When to Use

SuperClaude vs Standard Claude Code

✅ Use SuperClaude	💭 Use Standard Claude
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"	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"

---

🎓 Learning Path

Your 4-Week Journey to Mastery

Week	Focus	Skills	Milestone
1 🌱	Core Commands	• /sc:brainstorm • /sc:analyze • /sc:implement	Complete first project
2 🌿	Behavioral Modes	• Mode combinations • Flag usage • Context optimization	Optimize workflows
3 🌿	MCP Servers	• Server configuration • Tool integration • Enhanced capabilities	Full tool utilization
4 🌲	Advanced Patterns	• Custom workflows • Session management • Team patterns	Framework mastery

---

💡 Key Insights

Understanding SuperClaude's Value

🧠 Not Software It's a Framework SuperClaude is behavioral configuration, not standalone software. Everything runs through Claude Code.

🔄 Systematic Not Ad-hoc Transforms random requests into structured workflows with quality gates and validation.

🚀 Progressive Not Complex Start simple with basic commands. Complexity emerges naturally as needed.

---

📖 Next Steps

Continue Your Learning Journey

🌱 Beginner	🌿 Intermediate	🌲 Advanced
First Week: Installation Guide Commands Reference Examples Cookbook Start with /sc:brainstorm	Growing Skills: Behavioral Modes Agents Guide Session Management Explore mode combinations	Expert Usage: MCP Servers Technical Architecture Contributing Create custom workflows

---

🎉 Ready to Transform Your Development Workflow?

Start now with /sc:brainstorm in Claude Code!

_{SuperClaude v4.1.5 - Context Engineering for Claude Code}