SuperClaude

Comprehensive SuperClaude commands and workflows for enhanced Claude Code development with specialized commands, cognitive personas, and evidence-based methodologies.

Overview

SuperClaude is an open-source framework that extends Claude Code with 19 specialized commands, 9 cognitive personas, and evidence-based development methodologies. It applies software engineering principles without requiring additional code or external tools, transforming Claude Code into a more powerful development assistant with enhanced context management, token optimization, and modular workflows.

⚠️ Usage Notice: SuperClaude enhances Claude Code capabilities but should be used alongside proper testing, code review, and security practices. Always validate AI-generated code before production use.

Installation

Quick Setup

# Clone SuperClaude repository
git clone https://github.com/NomenAK/SuperClaude.git
cd SuperClaude

# Copy configuration to Claude Code directory
cp superclaude.md ~/.claude/

# Initialize SuperClaude in your project
claude-code --config superclaude.md

Manual Configuration

# Create SuperClaude config directory
mkdir -p ~/.superclaude

# Download configuration files
curl -o ~/.superclaude/config.md https://raw.githubusercontent.com/NomenAK/SuperClaude/main/superclaude.md

# Set environment variable
export SUPERCLAUDE_CONFIG=~/.superclaude/config.md

Core Commands

Command	Description
`/architect`	Activate architect persona for system design
`/security`	Enable security expert persona for code review
`/optimizer`	Switch to performance optimization persona
`/debugger`	Activate debugging specialist persona
`/tester`	Enable testing expert persona
`/docs`	Activate documentation specialist persona
`/reviewer`	Switch to code review expert persona
`/mentor`	Enable teaching and mentoring persona
`/researcher`	Activate research and analysis persona

Specialized Commands

Context Management

Command	Description
`/context7`	Research and documentation tool
`/checkpoint`	Create development checkpoint
`/history`	View development history
`/compress`	Enable UltraCompressed mode
`/expand`	Expand compressed context
`/focus`	Focus on specific code area
`/scope`	Define project scope

Development Workflows

Command	Description
`/sequential`	Enable deep thinking and analysis
`/parallel`	Run parallel development tasks
`/wave`	Orchestrate complex workflows
`/modular`	Enable modular development approach
`/iterative`	Use iterative development cycle
`/validate`	Validate code and architecture

Persona Flags

Architecture Persona

# Activate architect persona
claude-code --persona-architect

# System design commands
/architect --design-system
/architect --review-architecture
/architect --optimize-structure

Security Persona

# Enable security expert
claude-code --persona-security

# Security analysis commands
/security --audit-code
/security --check-vulnerabilities
/security --review-permissions

Performance Persona

# Activate optimizer
claude-code --persona-optimizer

# Performance commands
/optimizer --analyze-performance
/optimizer --optimize-queries
/optimizer --reduce-complexity

Advanced Features

Token Optimization

# Enable token optimization
/compress --ultra

# Optimize conversation context
/context7 --optimize

# Reduce token usage
/focus --narrow-scope

Modular Development

# Initialize modular structure
/modular --init

# Create module
/modular --create module_name

# Link modules
/modular --link module1 module2

Documentation Generation

# Generate project documentation
/docs --generate-all

# Create API documentation
/docs --api-docs

# Generate README
/docs --readme

Configuration Options

Basic Configuration

# ~/.superclaude/config.yaml
personas:
  default: architect
  available: [architect, security, optimizer, debugger, tester, docs, reviewer, mentor, researcher]

features:
  token_optimization: true
  modular_development: true
  checkpoint_system: true
  ultra_compressed: false

workflows:
  sequential_thinking: true
  parallel_processing: false
  wave_orchestration: true

Advanced Settings

# Advanced SuperClaude configuration
context:
  max_tokens: 200000
  compression_ratio: 0.7
  focus_depth: 3

development:
  checkpoint_frequency: 10
  auto_documentation: true
  code_validation: true
  security_checks: true

personas:
  architect:
    focus: [system_design, architecture_patterns, scalability]
  security:
    focus: [vulnerability_assessment, secure_coding, compliance]
  optimizer:
    focus: [performance_tuning, resource_optimization, efficiency]

Workflow Examples

Full Stack Development

# Initialize project with architect persona
claude-code --persona-architect
/architect --design-system "e-commerce platform"

# Switch to security review
/security --audit-design

# Implement with optimizer
/optimizer --implement-efficient

# Test with tester persona
/tester --comprehensive-testing

# Document with docs persona
/docs --generate-complete

Code Review Workflow

# Start code review session
claude-code --persona-reviewer

# Analyze code quality
/reviewer --analyze-quality

# Check security issues
/security --vulnerability-scan

# Performance review
/optimizer --performance-review

# Generate review report
/docs --review-report

Debugging Session

# Activate debugger persona
claude-code --persona-debugger

# Analyze error
/debugger --analyze-error "error_message"

# Trace execution
/debugger --trace-execution

# Suggest fixes
/debugger --suggest-fixes

# Validate solution
/tester --validate-fix

Integration with Claude Code

Enhanced Commands

# SuperClaude enhanced file operations
claude-code edit --persona-architect file.py
claude-code create --persona-security auth.py
claude-code review --persona-reviewer codebase/

# Context-aware development
claude-code --context7 --focus-area authentication
claude-code --sequential --deep-analysis
claude-code --wave --orchestrate-features

Project Templates

# Create project with SuperClaude template
claude-code create-project --template superclaude-fullstack
claude-code create-project --template superclaude-api
claude-code create-project --template superclaude-frontend

# Initialize existing project
claude-code init --superclaude

Best Practices

Persona Selection

Architect: System design, architecture planning, scalability decisions
Security: Code audits, vulnerability assessment, secure coding
Optimizer: Performance tuning, resource optimization, efficiency
Debugger: Error analysis, troubleshooting, issue resolution
Tester: Test planning, quality assurance, validation
Docs: Documentation, API specs, user guides
Reviewer: Code review, quality assessment, best practices
Mentor: Learning guidance, explanation, teaching
Researcher: Analysis, investigation, research tasks

Token Management

# Optimize token usage
/compress --smart-compression
/focus --relevant-context
/checkpoint --save-state

# Monitor token consumption
/context7 --token-usage
/history --token-analysis

Development Lifecycle

# 1. Planning phase
/architect --plan-project

# 2. Implementation phase
/optimizer --implement-efficient

# 3. Security phase
/security --security-review

# 4. Testing phase
/tester --comprehensive-testing

# 5. Documentation phase
/docs --complete-documentation

# 6. Review phase
/reviewer --final-review

Troubleshooting

Common Issues

# Reset SuperClaude configuration
claude-code --reset-superclaude

# Clear context cache
/context7 --clear-cache

# Rebuild persona profiles
/persona --rebuild-all

# Validate configuration
/validate --config-check

Performance Optimization

# Optimize SuperClaude performance
/optimizer --superclaude-performance

# Reduce memory usage
/compress --memory-optimization

# Speed up responses
/focus --performance-mode

Debug Mode

# Enable SuperClaude debug mode
claude-code --debug-superclaude

# Verbose logging
/debugger --verbose-logging

# Trace persona switching
/persona --trace-switches

Advanced Use Cases

Multi-Agent Development

# Coordinate multiple personas
/wave --multi-agent-coordination

# Parallel development streams
/parallel --architect --security --optimizer

# Sequential expert consultation
/sequential --architect -> /security -> /optimizer

Enterprise Integration

# Enterprise configuration
claude-code --enterprise-superclaude

# Team collaboration
/wave --team-coordination

# Compliance checking
/security --compliance-audit

# Documentation standards
/docs --enterprise-standards

Custom Workflows

# Create custom workflow
/wave --create-workflow "custom_dev_flow"

# Define workflow steps
/wave --add-step "architect_review"
/wave --add-step "security_check"
/wave --add-step "performance_optimization"

# Execute custom workflow
/wave --execute "custom_dev_flow"