External/SuperClaude
1
0
Fork 0
mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-29 16:16:08 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: comprehensive documentation update and command system enhancement

Browse Source 
- Update all command documentation with improved clarity and examples
- Enhance user guides with simplified activation patterns
- Improve installation and setup documentation
- Refine command system implementation in setup components
- Update changelog with recent improvements

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
NomenAK
2025-07-14 18:34:01 +02:00
parent e6bd45ed87
commit 90716ab7b8
23 changed files with 769 additions and 635 deletions
Download Patch File Download Diff File Expand all files Collapse all files

44
CHANGELOG.md
View File

@@ -0,0 +1,44 @@
# Changelog
All notable changes to SuperClaude will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased]
### Changed
- **BREAKING**: Commands now use `/sc:` namespace to avoid conflicts with user custom commands
- Commands are now installed in `~/.claude/commands/sc/` subdirectory
- All 15 commands updated: `/analyze` ’ `/sc:analyze`, `/build` ’ `/sc:build`, etc.
- Automatic migration from old command locations to new `sc/` subdirectory
### Added
- Migration logic to move existing commands to new namespace automatically
- Enhanced uninstaller to handle both old and new command locations
- Improved command conflict prevention
- Better command organization and discoverability
### Technical Details
- Commands now accessible as `/sc:analyze`, `/sc:build`, `/sc:improve`, etc.
- Migration preserves existing functionality while preventing naming conflicts
- Installation process detects and migrates existing commands automatically
- Tab completion support for `/sc:` prefix to discover all SuperClaude commands
## [3.0.0] - 2025-07-14
### Added
- Initial release of SuperClaude v3.0
- 15 specialized slash commands for development tasks
- Smart persona auto-activation system
- MCP server integration (Context7, Sequential, Magic, Playwright)
- Unified CLI installer with multiple installation profiles
- Comprehensive documentation and user guides
- Token optimization framework
- Task management system
### Features
- **Commands**: analyze, build, cleanup, design, document, estimate, explain, git, improve, index, load, spawn, task, test, troubleshoot
- **Personas**: architect, frontend, backend, analyzer, security, mentor, refactorer, performance, qa, devops, scribe
- **MCP Servers**: Official library documentation, complex analysis, UI components, browser automation
- **Installation**: Quick, minimal, and developer profiles with component selection

246
Docs/commands-guide.md
View File

@@ -18,11 +18,11 @@
**Start here** (no reading required): **Start here** (no reading required):
```bash ```bash
/help # See what's available /sc:help # See what's available
/analyze src/ # Smart analysis of your code /sc:analyze src/ # Smart analysis of your code
/build # Intelligent project building /sc:build # Intelligent project building
/improve messy-file.js # Clean up code automatically /sc:improve messy-file.js # Clean up code automatically
/troubleshoot "error" # Get help with problems /sc:troubleshoot "error" # Get help with problems
``` ```
**That's honestly enough to get started.** Everything else below is here when you get curious about what other tools are available. **That's honestly enough to get started.** Everything else below is here when you get curious about what other tools are available.
@@ -70,11 +70,11 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Basic syntax**: **Basic syntax**:
```bash ```bash
/build # Build current project /sc:build # Build current project
/build --type prod # Production build /sc:build --type prod # Production build
/build --clean # Clean build (remove old artifacts) /sc:build --clean # Clean build (remove old artifacts)
/build --optimize # Enable optimizations /sc:build --optimize # Enable optimizations
/build src/ # Build specific directory /sc:build src/ # Build specific directory
``` ```
**Useful flags**: **Useful flags**:
@@ -85,9 +85,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Real examples**: **Real examples**:
```bash ```bash
/build --type prod --optimize # Production build with optimizations /sc:build --type prod --optimize # Production build with optimizations
/build --clean --verbose # Clean build with detailed output /sc:build --clean --verbose # Clean build with detailed output
/build src/components # Build just the components folder /sc:build src/components # Build just the components folder
``` ```
**Gotchas**: **Gotchas**:
@@ -108,9 +108,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Basic syntax**: **Basic syntax**:
```bash ```bash
/design user-auth-system # Design a user authentication system /sc:design user-auth-system # Design a user authentication system
/design --type api auth # Design just the API part /sc:design --type api auth # Design just the API part
/design --format spec payment # Create formal specification /sc:design --format spec payment # Create formal specification
``` ```
**Useful flags**: **Useful flags**:
@@ -120,9 +120,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Real examples**: **Real examples**:
```bash ```bash
/design --type api user-management # Design user management API /sc:design --type api user-management # Design user management API
/design --format spec chat-system # Create chat system specification /sc:design --format spec chat-system # Create chat system specification
/design --type database ecommerce # Design database schema /sc:design --type database ecommerce # Design database schema
``` ```
**Gotchas**: **Gotchas**:
@@ -145,9 +145,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Basic syntax**: **Basic syntax**:
```bash ```bash
/analyze src/ # Analyze entire src directory /sc:analyze src/ # Analyze entire src directory
/analyze --focus security # Focus on security issues /sc:analyze --focus security # Focus on security issues
/analyze --depth deep app.js # Deep analysis of specific file /sc:analyze --depth deep app.js # Deep analysis of specific file
``` ```
**Useful flags**: **Useful flags**:
@@ -157,9 +157,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Real examples**: **Real examples**:
```bash ```bash
/analyze --focus security --depth deep # Deep security analysis /sc:analyze --focus security --depth deep # Deep security analysis
/analyze --focus performance src/api/ # Performance analysis of API /sc:analyze --focus performance src/api/ # Performance analysis of API
/analyze --format report . # Generate analysis report /sc:analyze --format report . # Generate analysis report
``` ```
**Gotchas**: **Gotchas**:
@@ -180,9 +180,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Basic syntax**: **Basic syntax**:
```bash ```bash
/troubleshoot "login not working" # Investigate login issue /sc:troubleshoot "login not working" # Investigate login issue
/troubleshoot --logs error.log # Analyze error logs /sc:troubleshoot --logs error.log # Analyze error logs
/troubleshoot performance # Performance troubleshooting /sc:troubleshoot performance # Performance troubleshooting
``` ```
**Useful flags**: **Useful flags**:
@@ -192,9 +192,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Real examples**: **Real examples**:
```bash ```bash
/troubleshoot "API returning 500" --logs server.log /sc:troubleshoot "API returning 500" --logs server.log
/troubleshoot --focus database "slow queries" /sc:troubleshoot --focus database "slow queries"
/troubleshoot "build failing" --systematic /sc:troubleshoot "build failing" --systematic
``` ```
**Gotchas**: **Gotchas**:
@@ -215,9 +215,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Basic syntax**: **Basic syntax**:
```bash ```bash
/explain async/await # Explain async/await concept /sc:explain async/await # Explain async/await concept
/explain --code src/utils.js # Explain specific code file /sc:explain --code src/utils.js # Explain specific code file
/explain --beginner React hooks # Beginner-friendly explanation /sc:explain --beginner React hooks # Beginner-friendly explanation
``` ```
**Useful flags**: **Useful flags**:
@@ -228,9 +228,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Real examples**: **Real examples**:
```bash ```bash
/explain --beginner "what is REST API" /sc:explain --beginner "what is REST API"
/explain --code src/auth.js --advanced /sc:explain --code src/auth.js --advanced
/explain --examples "React context patterns" /sc:explain --examples "React context patterns"
``` ```
**Gotchas**: **Gotchas**:
@@ -251,9 +251,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Basic syntax**: **Basic syntax**:
```bash ```bash
/improve src/legacy/ # Improve legacy code /sc:improve src/legacy/ # Improve legacy code
/improve --type performance # Focus on performance /sc:improve --type performance # Focus on performance
/improve --safe src/utils.js # Safe, low-risk improvements only /sc:improve --safe src/utils.js # Safe, low-risk improvements only
``` ```
**Useful flags**: **Useful flags**:
@@ -263,9 +263,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Real examples**: **Real examples**:
```bash ```bash
/improve --type performance --safe src/api/ /sc:improve --type performance --safe src/api/
/improve --preview src/components/LegacyComponent.js /sc:improve --preview src/components/LegacyComponent.js
/improve --type style . --safe /sc:improve --type style . --safe
``` ```
**Gotchas**: **Gotchas**:
@@ -286,9 +286,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Basic syntax**: **Basic syntax**:
```bash ```bash
/cleanup src/ # Clean up src directory /sc:cleanup src/ # Clean up src directory
/cleanup --dead-code # Focus on dead code removal /sc:cleanup --dead-code # Focus on dead code removal
/cleanup --imports package.js # Clean up imports in specific file /sc:cleanup --imports package.js # Clean up imports in specific file
``` ```
**Useful flags**: **Useful flags**:
@@ -299,9 +299,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Real examples**: **Real examples**:
```bash ```bash
/cleanup --dead-code --safe src/utils/ /sc:cleanup --dead-code --safe src/utils/
/cleanup --imports src/components/ /sc:cleanup --imports src/components/
/cleanup --files . --safe /sc:cleanup --files . --safe
``` ```
**Gotchas**: **Gotchas**:
@@ -322,10 +322,10 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Basic syntax**: **Basic syntax**:
```bash ```bash
/test # Run all tests /sc:test # Run all tests
/test --type unit # Run only unit tests /sc:test --type unit # Run only unit tests
/test --coverage # Generate coverage report /sc:test --coverage # Generate coverage report
/test --watch src/ # Watch mode for development /sc:test --watch src/ # Watch mode for development
``` ```
**Useful flags**: **Useful flags**:
@@ -336,9 +336,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Real examples**: **Real examples**:
```bash ```bash
/test --type unit --coverage /sc:test --type unit --coverage
/test --watch src/components/ /sc:test --watch src/components/
/test --type e2e --fix /sc:test --type e2e --fix
``` ```
**Gotchas**: **Gotchas**:
@@ -359,9 +359,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Basic syntax**: **Basic syntax**:
```bash ```bash
/document src/api/auth.js # Document authentication module /sc:document src/api/auth.js # Document authentication module
/document --type api # API documentation /sc:document --type api # API documentation
/document --style brief README # Brief README file /sc:document --style brief README # Brief README file
``` ```
**Useful flags**: **Useful flags**:
@@ -371,9 +371,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Real examples**: **Real examples**:
```bash ```bash
/document --type api src/controllers/ /sc:document --type api src/controllers/
/document --style detailed --type guide user-onboarding /sc:document --style detailed --type guide user-onboarding
/document --type inline src/utils/helpers.js /sc:document --type inline src/utils/helpers.js
``` ```
**Gotchas**: **Gotchas**:
@@ -394,9 +394,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Basic syntax**: **Basic syntax**:
```bash ```bash
/estimate "add user authentication" # Estimate auth feature /sc:estimate "add user authentication" # Estimate auth feature
/estimate --detailed shopping-cart # Detailed breakdown /sc:estimate --detailed shopping-cart # Detailed breakdown
/estimate --complexity user-dashboard # Complexity analysis /sc:estimate --complexity user-dashboard # Complexity analysis
``` ```
**Useful flags**: **Useful flags**:
@@ -406,9 +406,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Real examples**: **Real examples**:
```bash ```bash
/estimate --detailed "implement payment system" /sc:estimate --detailed "implement payment system"
/estimate --complexity --team-size 3 "migrate to microservices" /sc:estimate --complexity --team-size 3 "migrate to microservices"
/estimate "add real-time chat" --detailed /sc:estimate "add real-time chat" --detailed
``` ```
**Gotchas**: **Gotchas**:
@@ -429,9 +429,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Basic syntax**: **Basic syntax**:
```bash ```bash
/task create "implement user dashboard" # Create new task /sc:task create "implement user dashboard" # Create new task
/task status # Check task status /sc:task status # Check task status
/task breakdown "payment integration" # Break down into subtasks /sc:task breakdown "payment integration" # Break down into subtasks
``` ```
**Useful flags**: **Useful flags**:
@@ -442,9 +442,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Real examples**: **Real examples**:
```bash ```bash
/task create "migrate from REST to GraphQL" --priority high /sc:task create "migrate from REST to GraphQL" --priority high
/task breakdown "e-commerce checkout flow" /sc:task breakdown "e-commerce checkout flow"
/task status /sc:task status
``` ```
**Gotchas**: **Gotchas**:
@@ -465,9 +465,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Basic syntax**: **Basic syntax**:
```bash ```bash
/spawn deploy-pipeline # Orchestrate deployment /sc:spawn deploy-pipeline # Orchestrate deployment
/spawn --parallel migrate-data # Parallel data migration /sc:spawn --parallel migrate-data # Parallel data migration
/spawn setup-dev-environment # Complex environment setup /sc:spawn setup-dev-environment # Complex environment setup
``` ```
**Useful flags**: **Useful flags**:
@@ -477,9 +477,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Real examples**: **Real examples**:
```bash ```bash
/spawn --parallel "test and deploy to staging" /sc:spawn --parallel "test and deploy to staging"
/spawn setup-ci-cd --monitor /sc:spawn setup-ci-cd --monitor
/spawn --sequential database-migration /sc:spawn --sequential database-migration
``` ```
**Gotchas**: **Gotchas**:
@@ -500,9 +500,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Basic syntax**: **Basic syntax**:
```bash ```bash
/git commit # Smart commit with auto-generated message /sc:git commit # Smart commit with auto-generated message
/git --smart-commit add . # Add and commit with smart message /sc:git --smart-commit add . # Add and commit with smart message
/git branch feature/new-auth # Create and switch to new branch /sc:git branch feature/new-auth # Create and switch to new branch
``` ```
**Useful flags**: **Useful flags**:
@@ -512,9 +512,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Real examples**: **Real examples**:
```bash ```bash
/git --smart-commit "fixed login bug" /sc:git --smart-commit "fixed login bug"
/git branch feature/user-dashboard --branch-strategy /sc:git branch feature/user-dashboard --branch-strategy
/git merge develop --interactive /sc:git merge develop --interactive
``` ```
**Gotchas**: **Gotchas**:
@@ -534,9 +534,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Basic syntax**: **Basic syntax**:
```bash ```bash
/index # List all commands /sc:index # List all commands
/index testing # Find commands related to testing /sc:index testing # Find commands related to testing
/index --category analysis # Commands in analysis category /sc:index --category analysis # Commands in analysis category
``` ```
**Useful flags**: **Useful flags**:
@@ -545,9 +545,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Real examples**: **Real examples**:
```bash ```bash
/index --search "performance" /sc:index --search "performance"
/index --category quality /sc:index --category quality
/index git /sc:index git
``` ```
**Gotchas**: **Gotchas**:
@@ -567,9 +567,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Basic syntax**: **Basic syntax**:
```bash ```bash
/load # Load current project context /sc:load # Load current project context
/load src/ # Load specific directory context /sc:load src/ # Load specific directory context
/load --deep # Deep analysis of project structure /sc:load --deep # Deep analysis of project structure
``` ```
**Useful flags**: **Useful flags**:
@@ -579,9 +579,9 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
**Real examples**: **Real examples**:
```bash ```bash
/load --deep --summary /sc:load --deep --summary
/load src/components/ --focus architecture /sc:load src/components/ --focus architecture
/load . --focus dependencies /sc:load . --focus dependencies
``` ```
**Gotchas**: **Gotchas**:
@@ -594,55 +594,55 @@ A practical guide to all 15 SuperClaude slash commands. We'll be honest about wh
### Effective Flag Combinations ### Effective Flag Combinations
```bash ```bash
# Safe improvement workflow # Safe improvement workflow
/improve --preview src/component.js # See what would change /sc:improve --preview src/component.js # See what would change
/improve --safe src/component.js # Apply safe changes only /sc:improve --safe src/component.js # Apply safe changes only
# Comprehensive analysis # Comprehensive analysis
/analyze --focus security --depth deep /sc:analyze --focus security --depth deep
/test --coverage /sc:test --coverage
/document --type api /sc:document --type api
# Smart git workflow # Smart git workflow
/git add . /sc:git add .
/git --smart-commit --branch-strategy /sc:git --smart-commit --branch-strategy
# Project understanding workflow # Project understanding workflow
/load --deep --summary /sc:load --deep --summary
/analyze --focus architecture /sc:analyze --focus architecture
/document --type guide /sc:document --type guide
``` ```
### Common Workflows ### Common Workflows
**New Project Onboarding**: **New Project Onboarding**:
```bash ```bash
/load --deep --summary /sc:load --deep --summary
/analyze --focus architecture /sc:analyze --focus architecture
/test --coverage /sc:test --coverage
/document README /sc:document README
``` ```
**Bug Investigation**: **Bug Investigation**:
```bash ```bash
/troubleshoot "specific error message" --logs /sc:troubleshoot "specific error message" --logs
/analyze --focus security /sc:analyze --focus security
/test --type unit affected-component /sc:test --type unit affected-component
``` ```
**Code Quality Improvement**: **Code Quality Improvement**:
```bash ```bash
/analyze --focus quality /sc:analyze --focus quality
/improve --preview src/ /sc:improve --preview src/
/cleanup --safe /sc:cleanup --safe
/test --coverage /sc:test --coverage
``` ```
**Pre-deployment Checklist**: **Pre-deployment Checklist**:
```bash ```bash
/test --type all --coverage /sc:test --type all --coverage
/analyze --focus security /sc:analyze --focus security
/build --type prod --optimize /sc:build --type prod --optimize
/git --smart-commit /sc:git --smart-commit
``` ```
### Troubleshooting Command Issues ### Troubleshooting Command Issues

86
Docs/flags-guide.md
View File

@@ -23,10 +23,10 @@
```bash ```bash
# These work great with zero flag knowledge: # These work great with zero flag knowledge:
/analyze src/ # Auto-picks the right analysis flags /sc:analyze src/ # Auto-picks the right analysis flags
/build # Auto-optimizes based on your project /sc:build # Auto-optimizes based on your project
/improve messy-code.js # Auto-activates quality and safety flags /sc:improve messy-code.js # Auto-activates quality and safety flags
/troubleshoot "weird error" # Auto-activates debugging and analysis flags /sc:troubleshoot "weird error" # Auto-activates debugging and analysis flags
``` ```
**See? No flags needed.** Everything below is for when you get curious about what's happening behind the scenes. **See? No flags needed.** Everything below is for when you get curious about what's happening behind the scenes.
@@ -41,9 +41,9 @@ A practical guide to SuperClaude's flag system. Flags are like command-line opti
**Basic syntax** (but you usually don't need to know this): **Basic syntax** (but you usually don't need to know this):
```bash ```bash
/command --flag-name /sc:command --flag-name
/command --flag-name value /sc:command --flag-name value
/analyze src/ --focus security --depth deep /sc:analyze src/ --focus security --depth deep
``` ```
**How flags actually work in practice**: **How flags actually work in practice**:
@@ -234,38 +234,38 @@ Direct SuperClaude's attention to specific areas.
### Quick Analysis ### Quick Analysis
```bash ```bash
/analyze src/ --focus quality # Quick quality check /sc:analyze src/ --focus quality # Quick quality check
/analyze --uc --focus security # Fast security scan /sc:analyze --uc --focus security # Fast security scan
``` ```
### Deep Investigation ### Deep Investigation
```bash ```bash
/troubleshoot "bug" --think --seq # Systematic debugging /sc:troubleshoot "bug" --think --seq # Systematic debugging
/analyze --think-hard --focus architecture # Architectural analysis /sc:analyze --think-hard --focus architecture # Architectural analysis
``` ```
### Large Project Work ### Large Project Work
```bash ```bash
/analyze monorepo/ --delegate auto --uc # Efficient large analysis /sc:analyze monorepo/ --delegate auto --uc # Efficient large analysis
/improve legacy/ --wave-mode auto --safe-mode # Safe systematic improvement /sc:improve legacy/ --wave-mode auto --safe-mode # Safe systematic improvement
``` ```
### Learning & Documentation ### Learning & Documentation
```bash ```bash
/explain React hooks --c7 --verbose # Detailed explanation with docs /sc:explain React hooks --c7 --verbose # Detailed explanation with docs
/document api/ --persona-scribe # Professional documentation /sc:document api/ --persona-scribe # Professional documentation
``` ```
### Performance-Focused ### Performance-Focused
```bash ```bash
/analyze --focus performance --play # Performance analysis with testing /sc:analyze --focus performance --play # Performance analysis with testing
/build --uc --no-mcp # Fast build without extra features /sc:build --uc --no-mcp # Fast build without extra features
``` ```
### Security-Focused ### Security-Focused
```bash ```bash
/analyze --focus security --think --validate # Thorough security analysis /sc:analyze --focus security --think --validate # Thorough security analysis
/scan --persona-security --safe-mode # Conservative security scan /sc:scan --persona-security --safe-mode # Conservative security scan
``` ```
## Practical Examples 💡 ## Practical Examples 💡
@@ -273,13 +273,13 @@ Direct SuperClaude's attention to specific areas.
### Before/After: Basic Analysis ### Before/After: Basic Analysis
**Before** (basic): **Before** (basic):
```bash ```bash
/analyze auth.js /sc:analyze auth.js
# → Simple file analysis # → Simple file analysis
``` ```
**After** (with flags): **After** (with flags):
```bash ```bash
/analyze auth.js --focus security --think --c7 /sc:analyze auth.js --focus security --think --c7
# → Security-focused analysis with deep thinking and official docs # → Security-focused analysis with deep thinking and official docs
# → Much more thorough, finds security patterns, checks against best practices # → Much more thorough, finds security patterns, checks against best practices
``` ```
@@ -287,13 +287,13 @@ Direct SuperClaude's attention to specific areas.
### Before/After: Large Project ### Before/After: Large Project
**Before** (slow): **Before** (slow):
```bash ```bash
/analyze huge-monorepo/ /sc:analyze huge-monorepo/
# → Tries to analyze everything at once, may timeout or use too many tokens # → Tries to analyze everything at once, may timeout or use too many tokens
``` ```
**After** (efficient): **After** (efficient):
```bash ```bash
/analyze huge-monorepo/ --delegate auto --uc --focus architecture /sc:analyze huge-monorepo/ --delegate auto --uc --focus architecture
# → Delegates work to sub-agents, compresses output, focuses on architecture # → Delegates work to sub-agents, compresses output, focuses on architecture
# → Faster, more focused, better results # → Faster, more focused, better results
``` ```
@@ -301,13 +301,13 @@ Direct SuperClaude's attention to specific areas.
### Before/After: Improvement Work ### Before/After: Improvement Work
**Before** (risky): **Before** (risky):
```bash ```bash
/improve legacy-system/ /sc:improve legacy-system/
# → May make too many changes, could break things # → May make too many changes, could break things
``` ```
**After** (safe): **After** (safe):
```bash ```bash
/improve legacy-system/ --safe-mode --loop --validate --preview /sc:improve legacy-system/ --safe-mode --loop --validate --preview
# → Safe changes only, iterative approach, validates first, shows preview # → Safe changes only, iterative approach, validates first, shows preview
# → Much safer, progressive improvement # → Much safer, progressive improvement
``` ```
@@ -318,22 +318,22 @@ SuperClaude automatically adds flags based on context. Here's when:
### Complexity-Based ### Complexity-Based
```bash ```bash
/analyze huge-codebase/ /sc:analyze huge-codebase/
# Auto-adds: --delegate auto --uc # Auto-adds: --delegate auto --uc
# Why: >50 files detected, context management needed # Why: >50 files detected, context management needed
/troubleshoot "complex system issue" /sc:troubleshoot "complex system issue"
# Auto-adds: --think --seq # Auto-adds: --think --seq
# Why: Multi-component problem detected # Why: Multi-component problem detected
``` ```
### Domain-Based ### Domain-Based
```bash ```bash
/build react-app/ /sc:build react-app/
# Auto-adds: --c7 --persona-frontend # Auto-adds: --c7 --persona-frontend
# Why: Frontend framework detected # Why: Frontend framework detected
/analyze --focus security /sc:analyze --focus security
# Auto-adds: --persona-security --validate # Auto-adds: --persona-security --validate
# Why: Security focus triggers security specialist # Why: Security focus triggers security specialist
``` ```
@@ -341,12 +341,12 @@ SuperClaude automatically adds flags based on context. Here's when:
### Performance-Based ### Performance-Based
```bash ```bash
# When context usage >75% # When context usage >75%
/analyze large-project/ /sc:analyze large-project/
# Auto-adds: --uc # Auto-adds: --uc
# Why: Token optimization needed # Why: Token optimization needed
# When risk score >0.7 # When risk score >0.7
/improve production-code/ /sc:improve production-code/
# Auto-adds: --safe-mode --validate # Auto-adds: --safe-mode --validate
# Why: High-risk operation detected # Why: High-risk operation detected
``` ```
@@ -357,19 +357,19 @@ SuperClaude automatically adds flags based on context. Here's when:
**Comprehensive Code Review**: **Comprehensive Code Review**:
```bash ```bash
/review codebase/ --persona-qa --think-hard --focus quality --validate --c7 /sc:review codebase/ --persona-qa --think-hard --focus quality --validate --c7
# → QA specialist + deep thinking + quality focus + validation + docs # → QA specialist + deep thinking + quality focus + validation + docs
``` ```
**Legacy System Modernization**: **Legacy System Modernization**:
```bash ```bash
/improve legacy/ --wave-mode force --persona-architect --safe-mode --loop --c7 /sc:improve legacy/ --wave-mode force --persona-architect --safe-mode --loop --c7
# → Wave orchestration + architect perspective + safety + iteration + docs # → Wave orchestration + architect perspective + safety + iteration + docs
``` ```
**Security Audit**: **Security Audit**:
```bash ```bash
/scan --persona-security --ultrathink --focus security --validate --seq /sc:scan --persona-security --ultrathink --focus security --validate --seq
# → Security specialist + maximum thinking + security focus + validation + systematic analysis # → Security specialist + maximum thinking + security focus + validation + systematic analysis
``` ```
@@ -377,13 +377,13 @@ SuperClaude automatically adds flags based on context. Here's when:
**For Speed**: **For Speed**:
```bash ```bash
/analyze --no-mcp --uc --scope file /sc:analyze --no-mcp --uc --scope file
# → Disable extra features, compress output, limit scope # → Disable extra features, compress output, limit scope
``` ```
**For Thoroughness**: **For Thoroughness**:
```bash ```bash
/analyze --all-mcp --think-hard --delegate auto /sc:analyze --all-mcp --think-hard --delegate auto
# → All capabilities, deep thinking, parallel processing # → All capabilities, deep thinking, parallel processing
``` ```
@@ -391,17 +391,17 @@ SuperClaude automatically adds flags based on context. Here's when:
**Bug Investigation Workflow**: **Bug Investigation Workflow**:
```bash ```bash
/troubleshoot "specific error" --seq --think --validate /sc:troubleshoot "specific error" --seq --think --validate
/analyze affected-files/ --focus quality --persona-analyzer /sc:analyze affected-files/ --focus quality --persona-analyzer
/test --play --coverage /sc:test --play --coverage
``` ```
**Feature Development Workflow**: **Feature Development Workflow**:
```bash ```bash
/design new-feature --persona-architect --c7 /sc:design new-feature --persona-architect --c7
/build --magic --persona-frontend --validate /sc:build --magic --persona-frontend --validate
/test --play --coverage /sc:test --play --coverage
/document --persona-scribe --c7 /sc:document --persona-scribe --c7
``` ```
## Quick Reference 📋 ## Quick Reference 📋

8
Docs/installation-guide.md
View File

@@ -257,10 +257,10 @@ Try these commands to get started:
```bash ```bash
# In Claude Code, try these: # In Claude Code, try these:
/help # See available commands /sc:help # See available commands
/analyze README.md # Analyze a file /sc:analyze README.md # Analyze a file
/build --help # See build options /sc:build --help # See build options
/improve --help # See improvement options /sc:improve --help # See improvement options
``` ```
**Don't worry if it seems overwhelming** - SuperClaude enhances Claude Code gradually. You can use as much or as little as you want. **Don't worry if it seems overwhelming** - SuperClaude enhances Claude Code gradually. You can use as much or as little as you want.

164
Docs/personas-guide.md
View File

@@ -20,10 +20,10 @@
```bash ```bash
# These automatically activate the right experts: # These automatically activate the right experts:
/analyze payment-system/ # → Security + backend experts auto-activate /sc:analyze payment-system/ # → Security + backend experts auto-activate
/build react-app/ # → Frontend specialist takes over /sc:build react-app/ # → Frontend specialist takes over
/improve slow-queries.sql # → Performance optimizer jumps in /sc:improve slow-queries.sql # → Performance optimizer jumps in
/troubleshoot "auth failing" # → Debug specialist + security expert coordinate /sc:troubleshoot "auth failing" # → Debug specialist + security expert coordinate
``` ```
**See the pattern?** You focus on what you want to do, SuperClaude figures out who should help. Everything below is for when you get curious about who's on the team. **See the pattern?** You focus on what you want to do, SuperClaude figures out who should help. Everything below is for when you get curious about who's on the team.
@@ -74,9 +74,9 @@ Think of SuperClaude personas as having a team of specialists on demand. Each pe
**Example workflows**: **Example workflows**:
```bash ```bash
/design microservices-migration --persona-architect /sc:design microservices-migration --persona-architect
/analyze --focus architecture large-system/ /sc:analyze --focus architecture large-system/
/estimate "redesign auth system" --persona-architect /sc:estimate "redesign auth system" --persona-architect
``` ```
**What they prioritize**: **What they prioritize**:
@@ -111,9 +111,9 @@ Think of SuperClaude personas as having a team of specialists on demand. Each pe
**Example workflows**: **Example workflows**:
```bash ```bash
/build dashboard --persona-frontend /sc:build dashboard --persona-frontend
/improve --focus accessibility components/ /sc:improve --focus accessibility components/
/analyze --persona-frontend --focus performance /sc:analyze --persona-frontend --focus performance
``` ```
**What they prioritize**: **What they prioritize**:
@@ -149,9 +149,9 @@ Think of SuperClaude personas as having a team of specialists on demand. Each pe
**Example workflows**: **Example workflows**:
```bash ```bash
/design user-api --persona-backend /sc:design user-api --persona-backend
/analyze --focus security api/ /sc:analyze --focus security api/
/improve --persona-backend database-layer/ /sc:improve --persona-backend database-layer/
``` ```
**What they prioritize**: **What they prioritize**:
@@ -187,9 +187,9 @@ Think of SuperClaude personas as having a team of specialists on demand. Each pe
**Example workflows**: **Example workflows**:
```bash ```bash
/scan --persona-security --focus security /sc:scan --persona-security --focus security
/analyze auth-system/ --persona-security /sc:analyze auth-system/ --persona-security
/improve --focus security --persona-security /sc:improve --focus security --persona-security
``` ```
**What they prioritize**: **What they prioritize**:
@@ -225,9 +225,9 @@ Think of SuperClaude personas as having a team of specialists on demand. Each pe
**Example workflows**: **Example workflows**:
```bash ```bash
/analyze --focus performance --persona-performance /sc:analyze --focus performance --persona-performance
/improve --type performance slow-endpoints/ /sc:improve --type performance slow-endpoints/
/test --benchmark --persona-performance /sc:test --benchmark --persona-performance
``` ```
**What they prioritize**: **What they prioritize**:
@@ -263,9 +263,9 @@ Think of SuperClaude personas as having a team of specialists on demand. Each pe
**Example workflows**: **Example workflows**:
```bash ```bash
/troubleshoot "auth randomly fails" --persona-analyzer /sc:troubleshoot "auth randomly fails" --persona-analyzer
/analyze --persona-analyzer mysterious-bug/ /sc:analyze --persona-analyzer mysterious-bug/
/explain --detailed "why is this slow" --persona-analyzer /sc:explain --detailed "why is this slow" --persona-analyzer
``` ```
**What they prioritize**: **What they prioritize**:
@@ -301,9 +301,9 @@ Think of SuperClaude personas as having a team of specialists on demand. Each pe
**Example workflows**: **Example workflows**:
```bash ```bash
/test --persona-qa comprehensive-suite /sc:test --persona-qa comprehensive-suite
/analyze --focus quality --persona-qa /sc:analyze --focus quality --persona-qa
/review --persona-qa critical-features/ /sc:review --persona-qa critical-features/
``` ```
**What they prioritize**: **What they prioritize**:
@@ -339,9 +339,9 @@ Think of SuperClaude personas as having a team of specialists on demand. Each pe
**Example workflows**: **Example workflows**:
```bash ```bash
/improve --type quality --persona-refactorer /sc:improve --type quality --persona-refactorer
/cleanup legacy-module/ --persona-refactorer /sc:cleanup legacy-module/ --persona-refactorer
/analyze --focus maintainability --persona-refactorer /sc:analyze --focus maintainability --persona-refactorer
``` ```
**What they prioritize**: **What they prioritize**:
@@ -377,9 +377,9 @@ Think of SuperClaude personas as having a team of specialists on demand. Each pe
**Example workflows**: **Example workflows**:
```bash ```bash
/deploy production --persona-devops /sc:deploy production --persona-devops
/analyze infrastructure/ --persona-devops /sc:analyze infrastructure/ --persona-devops
/improve deployment-pipeline --persona-devops /sc:improve deployment-pipeline --persona-devops
``` ```
**What they prioritize**: **What they prioritize**:
@@ -415,9 +415,9 @@ Think of SuperClaude personas as having a team of specialists on demand. Each pe
**Example workflows**: **Example workflows**:
```bash ```bash
/explain React hooks --persona-mentor /sc:explain React hooks --persona-mentor
/document --type guide --persona-mentor /sc:document --type guide --persona-mentor
/analyze complex-algorithm.js --persona-mentor /sc:analyze complex-algorithm.js --persona-mentor
``` ```
**What they prioritize**: **What they prioritize**:
@@ -451,9 +451,9 @@ Think of SuperClaude personas as having a team of specialists on demand. Each pe
**Example workflows**: **Example workflows**:
```bash ```bash
/document api/ --persona-scribe /sc:document api/ --persona-scribe
/git commit --persona-scribe /sc:git commit --persona-scribe
/explain --persona-scribe=es complex-feature /sc:explain --persona-scribe=es complex-feature
``` ```
**What they prioritize**: **What they prioritize**:
@@ -510,31 +510,31 @@ Personas often work together automatically. Here are common collaboration patter
### Design & Implementation ### Design & Implementation
```bash ```bash
/design user-dashboard /sc:design user-dashboard
# Auto-activates: 🏗️ architect (system design) + 🎨 frontend (UI design) # Auto-activates: 🏗️ architect (system design) + 🎨 frontend (UI design)
``` ```
### Security Review ### Security Review
```bash ```bash
/analyze --focus security api/ /sc:analyze --focus security api/
# Auto-activates: 🛡️ security (primary) + ⚙️ backend (API expertise) # Auto-activates: 🛡️ security (primary) + ⚙️ backend (API expertise)
``` ```
### Performance Optimization ### Performance Optimization
```bash ```bash
/improve --focus performance slow-app/ /sc:improve --focus performance slow-app/
# Auto-activates: ⚡ performance (primary) + 🎨 frontend (if UI) or ⚙️ backend (if API) # Auto-activates: ⚡ performance (primary) + 🎨 frontend (if UI) or ⚙️ backend (if API)
``` ```
### Quality Improvement ### Quality Improvement
```bash ```bash
/improve --focus quality legacy-code/ /sc:improve --focus quality legacy-code/
# Auto-activates: 🔄 refactorer (primary) + 🧪 qa (testing) + 🏗️ architect (design) # Auto-activates: 🔄 refactorer (primary) + 🧪 qa (testing) + 🏗️ architect (design)
``` ```
### Documentation & Learning ### Documentation & Learning
```bash ```bash
/document complex-feature --type guide /sc:document complex-feature --type guide
# Auto-activates: ✍️ scribe (writing) + 👨‍🏫 mentor (educational approach) # Auto-activates: ✍️ scribe (writing) + 👨‍🏫 mentor (educational approach)
``` ```
@@ -544,13 +544,13 @@ Personas often work together automatically. Here are common collaboration patter
**Before** (generic): **Before** (generic):
```bash ```bash
/analyze auth.js /sc:analyze auth.js
# → Basic analysis, generic advice # → Basic analysis, generic advice
``` ```
**After** (security persona): **After** (security persona):
```bash ```bash
/analyze auth.js --persona-security /sc:analyze auth.js --persona-security
# → Security-focused analysis # → Security-focused analysis
# → Threat modeling perspective # → Threat modeling perspective
# → OWASP compliance checking # → OWASP compliance checking
@@ -561,7 +561,7 @@ Personas often work together automatically. Here are common collaboration patter
**Frontend work detection**: **Frontend work detection**:
```bash ```bash
/build react-components/ /sc:build react-components/
# Auto-activates: 🎨 frontend # Auto-activates: 🎨 frontend
# → UI-focused build optimization # → UI-focused build optimization
# → Accessibility checking # → Accessibility checking
@@ -571,7 +571,7 @@ Personas often work together automatically. Here are common collaboration patter
**Complex debugging**: **Complex debugging**:
```bash ```bash
/troubleshoot "payment processing randomly fails" /sc:troubleshoot "payment processing randomly fails"
# Auto-activates: 🔍 analyzer # Auto-activates: 🔍 analyzer
# → Systematic investigation approach # → Systematic investigation approach
# → Evidence collection methodology # → Evidence collection methodology
@@ -583,7 +583,7 @@ Personas often work together automatically. Here are common collaboration patter
**Force security perspective**: **Force security perspective**:
```bash ```bash
/analyze react-app/ --persona-security /sc:analyze react-app/ --persona-security
# Even though it's frontend code, analyze from security perspective # Even though it's frontend code, analyze from security perspective
# → XSS vulnerability checking # → XSS vulnerability checking
# → Authentication flow analysis # → Authentication flow analysis
@@ -592,7 +592,7 @@ Personas often work together automatically. Here are common collaboration patter
**Get architectural advice on small changes**: **Get architectural advice on small changes**:
```bash ```bash
/improve small-utility.js --persona-architect /sc:improve small-utility.js --persona-architect
# Apply architectural thinking to small code # Apply architectural thinking to small code
# → Design pattern opportunities # → Design pattern opportunities
# → Future extensibility # → Future extensibility
@@ -611,30 +611,30 @@ Personas often work together automatically. Here are common collaboration patter
**How to override**: **How to override**:
```bash ```bash
# Explicit persona selection # Explicit persona selection
/analyze frontend-code/ --persona-security # Security view of frontend /sc:analyze frontend-code/ --persona-security # Security view of frontend
/improve backend-api/ --persona-performance # Performance view of backend /sc:improve backend-api/ --persona-performance # Performance view of backend
# Multiple persona flags (last one wins) # Multiple persona flags (last one wins)
/analyze --persona-frontend --persona-security # Uses security persona /sc:analyze --persona-frontend --persona-security # Uses security persona
``` ```
### Persona-Specific Flags and Settings ### Persona-Specific Flags and Settings
**Security persona + validation**: **Security persona + validation**:
```bash ```bash
/analyze --persona-security --focus security --validate /sc:analyze --persona-security --focus security --validate
# → Maximum security focus with validation # → Maximum security focus with validation
``` ```
**Performance persona + benchmarking**: **Performance persona + benchmarking**:
```bash ```bash
/test --persona-performance --benchmark --focus performance /sc:test --persona-performance --benchmark --focus performance
# → Performance-focused testing with metrics # → Performance-focused testing with metrics
``` ```
**Mentor persona + detailed explanations**: **Mentor persona + detailed explanations**:
```bash ```bash
/explain complex-concept --persona-mentor --verbose /sc:explain complex-concept --persona-mentor --verbose
# → Educational explanation with full detail # → Educational explanation with full detail
``` ```
@@ -643,12 +643,12 @@ Personas often work together automatically. Here are common collaboration patter
**When you need multiple perspectives**: **When you need multiple perspectives**:
```bash ```bash
# Sequential analysis with different personas # Sequential analysis with different personas
/analyze --persona-security api/auth.js /sc:analyze --persona-security api/auth.js
/analyze --persona-performance api/auth.js /sc:analyze --persona-performance api/auth.js
/analyze --persona-refactorer api/auth.js /sc:analyze --persona-refactorer api/auth.js
# Or let SuperClaude coordinate automatically # Or let SuperClaude coordinate automatically
/analyze --focus quality api/auth.js /sc:analyze --focus quality api/auth.js
# Auto-coordinates: security + performance + refactorer insights # Auto-coordinates: security + performance + refactorer insights
``` ```
@@ -657,56 +657,56 @@ Personas often work together automatically. Here are common collaboration patter
### 🏗️ Architect Workflows ### 🏗️ Architect Workflows
```bash ```bash
# System design # System design
/design microservices-architecture --persona-architect /sc:design microservices-architecture --persona-architect
/estimate "migrate monolith to microservices" --persona-architect /sc:estimate "migrate monolith to microservices" --persona-architect
# Architecture review # Architecture review
/analyze --focus architecture --persona-architect large-system/ /sc:analyze --focus architecture --persona-architect large-system/
/review --persona-architect critical-components/ /sc:review --persona-architect critical-components/
``` ```
### 🎨 Frontend Workflows ### 🎨 Frontend Workflows
```bash ```bash
# Component development # Component development
/build dashboard-components/ --persona-frontend /sc:build dashboard-components/ --persona-frontend
/improve --focus accessibility --persona-frontend ui/ /sc:improve --focus accessibility --persona-frontend ui/
# Performance optimization # Performance optimization
/analyze --focus performance --persona-frontend bundle/ /sc:analyze --focus performance --persona-frontend bundle/
/test --persona-frontend --focus performance /sc:test --persona-frontend --focus performance
``` ```
### ⚙️ Backend Workflows ### ⚙️ Backend Workflows
```bash ```bash
# API development # API development
/design rest-api --persona-backend /sc:design rest-api --persona-backend
/build api-endpoints/ --persona-backend /sc:build api-endpoints/ --persona-backend
# Reliability improvements # Reliability improvements
/improve --focus reliability --persona-backend services/ /sc:improve --focus reliability --persona-backend services/
/analyze --persona-backend --focus security api/ /sc:analyze --persona-backend --focus security api/
``` ```
### 🛡️ Security Workflows ### 🛡️ Security Workflows
```bash ```bash
# Security assessment # Security assessment
/scan --persona-security --focus security entire-app/ /sc:scan --persona-security --focus security entire-app/
/analyze --persona-security auth-flow/ /sc:analyze --persona-security auth-flow/
# Vulnerability fixing # Vulnerability fixing
/improve --focus security --persona-security vulnerable-code/ /sc:improve --focus security --persona-security vulnerable-code/
/review --persona-security --focus security critical-paths/ /sc:review --persona-security --focus security critical-paths/
``` ```
### 🔍 Analyzer Workflows ### 🔍 Analyzer Workflows
```bash ```bash
# Bug investigation # Bug investigation
/troubleshoot "intermittent failures" --persona-analyzer /sc:troubleshoot "intermittent failures" --persona-analyzer
/analyze --persona-analyzer --focus debugging problem-area/ /sc:analyze --persona-analyzer --focus debugging problem-area/
# System understanding # System understanding
/explain --persona-analyzer complex-system/ /sc:explain --persona-analyzer complex-system/
/load --persona-analyzer unfamiliar-codebase/ /sc:load --persona-analyzer unfamiliar-codebase/
``` ```
## Quick Reference 📋 ## Quick Reference 📋
@@ -808,14 +808,14 @@ Personas often work together automatically. Here are common collaboration patter
**How to override effectively**: **How to override effectively**:
```bash ```bash
# Force specific perspective # Force specific perspective
/analyze frontend-code/ --persona-security # Security view of frontend /sc:analyze frontend-code/ --persona-security # Security view of frontend
# Combine multiple perspectives # Combine multiple perspectives
/analyze api/ --persona-security /sc:analyze api/ --persona-security
/analyze api/ --persona-performance # Run separately for different views /sc:analyze api/ --persona-performance # Run separately for different views
# Use general analysis # Use general analysis
/analyze --no-persona # Disable persona auto-activation /sc:analyze --no-persona # Disable persona auto-activation
``` ```
## Tips for Effective Persona Usage 💡 ## Tips for Effective Persona Usage 💡

664
Docs/superclaude-user-guide.md
View File

File diff suppressed because it is too large Load Diff

8
README.md
View File

@@ -40,10 +40,10 @@ This is what we've been working on to make Claude Code more helpful for developm
### Commands 🛠️ ### Commands 🛠️
We focused on 15 essential commands for the most common tasks: We focused on 15 essential commands for the most common tasks:
**Development**: `/build`, `/dev-setup` **Development**: `/sc:build`, `/sc:dev-setup`
**Analysis**: `/analyze`, `/review`, `/troubleshoot` **Analysis**: `/sc:analyze`, `/sc:review`, `/sc:troubleshoot`
**Quality**: `/improve`, `/scan`, `/test` **Quality**: `/sc:improve`, `/sc:scan`, `/sc:test`
**Others**: `/document`, `/deploy`, `/git`, `/migrate`, `/estimate`, `/task`, `/design` **Others**: `/sc:document`, `/sc:deploy`, `/sc:git`, `/sc:migrate`, `/sc:estimate`, `/sc:task`, `/sc:design`
### Smart Personas 🎭 ### Smart Personas 🎭
Auto-activating specialists that adapt Claude's behavior: Auto-activating specialists that adapt Claude's behavior:

4
SuperClaude/Commands/analyze.md
View File

@@ -3,14 +3,14 @@ allowed-tools: [Read, Grep, Glob, Bash, TodoWrite]
description: "Analyze code quality, security, performance, and architecture" description: "Analyze code quality, security, performance, and architecture"
--- ---
# /analyze - Code Analysis # /sc:analyze - Code Analysis
## Purpose ## Purpose
Execute comprehensive code analysis across quality, security, performance, and architecture domains. Execute comprehensive code analysis across quality, security, performance, and architecture domains.
## Usage ## Usage
``` ```
/analyze [target] [--focus quality|security|performance|architecture] [--depth quick|deep] /sc:analyze [target] [--focus quality|security|performance|architecture] [--depth quick|deep]
``` ```
## Arguments ## Arguments

4
SuperClaude/Commands/build.md
View File

@@ -3,14 +3,14 @@ allowed-tools: [Read, Bash, Glob, TodoWrite, Edit]
description: "Build, compile, and package projects with error handling and optimization" description: "Build, compile, and package projects with error handling and optimization"
--- ---
# /build - Project Building # /sc:build - Project Building
## Purpose ## Purpose
Build, compile, and package projects with comprehensive error handling and optimization. Build, compile, and package projects with comprehensive error handling and optimization.
## Usage ## Usage
``` ```
/build [target] [--type dev|prod|test] [--clean] [--optimize] /sc:build [target] [--type dev|prod|test] [--clean] [--optimize]
``` ```
## Arguments ## Arguments

4
SuperClaude/Commands/cleanup.md
View File

@@ -3,14 +3,14 @@ allowed-tools: [Read, Grep, Glob, Bash, Edit, MultiEdit]
description: "Clean up code, remove dead code, and optimize project structure" description: "Clean up code, remove dead code, and optimize project structure"
--- ---
# /cleanup - Code and Project Cleanup # /sc:cleanup - Code and Project Cleanup
## Purpose ## Purpose
Systematically clean up code, remove dead code, optimize imports, and improve project structure. Systematically clean up code, remove dead code, optimize imports, and improve project structure.
## Usage ## Usage
``` ```
/cleanup [target] [--type code|imports|files|all] [--safe|--aggressive] /sc:cleanup [target] [--type code|imports|files|all] [--safe|--aggressive]
``` ```
## Arguments ## Arguments

4
SuperClaude/Commands/design.md
View File

@@ -3,14 +3,14 @@ allowed-tools: [Read, Grep, Glob, Write, Edit, TodoWrite]
description: "Design system architecture, APIs, and component interfaces" description: "Design system architecture, APIs, and component interfaces"
--- ---
# /design - System and Component Design # /sc:design - System and Component Design
## Purpose ## Purpose
Design system architecture, APIs, component interfaces, and technical specifications. Design system architecture, APIs, component interfaces, and technical specifications.
## Usage ## Usage
``` ```
/design [target] [--type architecture|api|component|database] [--format diagram|spec|code] /sc:design [target] [--type architecture|api|component|database] [--format diagram|spec|code]
``` ```
## Arguments ## Arguments

4
SuperClaude/Commands/document.md
View File

@@ -3,14 +3,14 @@ allowed-tools: [Read, Grep, Glob, Write, Edit]
description: "Create focused documentation for specific components or features" description: "Create focused documentation for specific components or features"
--- ---
# /document - Focused Documentation # /sc:document - Focused Documentation
## Purpose ## Purpose
Generate precise, focused documentation for specific components, functions, or features. Generate precise, focused documentation for specific components, functions, or features.
## Usage ## Usage
``` ```
/document [target] [--type inline|external|api|guide] [--style brief|detailed] /sc:document [target] [--type inline|external|api|guide] [--style brief|detailed]
``` ```
## Arguments ## Arguments

4
SuperClaude/Commands/estimate.md
View File

@@ -3,14 +3,14 @@ allowed-tools: [Read, Grep, Glob, Bash]
description: "Provide development estimates for tasks, features, or projects" description: "Provide development estimates for tasks, features, or projects"
--- ---
# /estimate - Development Estimation # /sc:estimate - Development Estimation
## Purpose ## Purpose
Generate accurate development estimates for tasks, features, or projects based on complexity analysis. Generate accurate development estimates for tasks, features, or projects based on complexity analysis.
## Usage ## Usage
``` ```
/estimate [target] [--type time|effort|complexity|cost] [--unit hours|days|weeks] /sc:estimate [target] [--type time|effort|complexity|cost] [--unit hours|days|weeks]
``` ```
## Arguments ## Arguments

4
SuperClaude/Commands/explain.md
View File

@@ -3,14 +3,14 @@ allowed-tools: [Read, Grep, Glob, Bash]
description: "Provide clear explanations of code, concepts, or system behavior" description: "Provide clear explanations of code, concepts, or system behavior"
--- ---
# /explain - Code and Concept Explanation # /sc:explain - Code and Concept Explanation
## Purpose ## Purpose
Deliver clear, comprehensive explanations of code functionality, concepts, or system behavior. Deliver clear, comprehensive explanations of code functionality, concepts, or system behavior.
## Usage ## Usage
``` ```
/explain [target] [--level basic|intermediate|advanced] [--format text|diagram|examples] /sc:explain [target] [--level basic|intermediate|advanced] [--format text|diagram|examples]
``` ```
## Arguments ## Arguments

4
SuperClaude/Commands/git.md
View File

@@ -3,14 +3,14 @@ allowed-tools: [Bash, Read, Glob, TodoWrite, Edit]
description: "Git operations with intelligent commit messages and branch management" description: "Git operations with intelligent commit messages and branch management"
--- ---
# /git - Git Operations # /sc:git - Git Operations
## Purpose ## Purpose
Execute Git operations with intelligent commit messages, branch management, and workflow optimization. Execute Git operations with intelligent commit messages, branch management, and workflow optimization.
## Usage ## Usage
``` ```
/git [operation] [args] [--smart-commit] [--branch-strategy] /sc:git [operation] [args] [--smart-commit] [--branch-strategy]
``` ```
## Arguments ## Arguments

4
SuperClaude/Commands/improve.md
View File

@@ -3,14 +3,14 @@ allowed-tools: [Read, Grep, Glob, Edit, MultiEdit, TodoWrite]
description: "Apply systematic improvements to code quality, performance, and maintainability" description: "Apply systematic improvements to code quality, performance, and maintainability"
--- ---
# /improve - Code Improvement # /sc:improve - Code Improvement
## Purpose ## Purpose
Apply systematic improvements to code quality, performance, maintainability, and best practices. Apply systematic improvements to code quality, performance, maintainability, and best practices.
## Usage ## Usage
``` ```
/improve [target] [--type quality|performance|maintainability|style] [--safe] /sc:improve [target] [--type quality|performance|maintainability|style] [--safe]
``` ```
## Arguments ## Arguments

4
SuperClaude/Commands/index.md
View File

@@ -3,14 +3,14 @@ allowed-tools: [Read, Grep, Glob, Bash, Write]
description: "Generate comprehensive project documentation and knowledge base" description: "Generate comprehensive project documentation and knowledge base"
--- ---
# /index - Project Documentation # /sc:index - Project Documentation
## Purpose ## Purpose
Create and maintain comprehensive project documentation, indexes, and knowledge bases. Create and maintain comprehensive project documentation, indexes, and knowledge bases.
## Usage ## Usage
``` ```
/index [target] [--type docs|api|structure|readme] [--format md|json|yaml] /sc:index [target] [--type docs|api|structure|readme] [--format md|json|yaml]
``` ```
## Arguments ## Arguments

4
SuperClaude/Commands/load.md
View File

@@ -3,14 +3,14 @@ allowed-tools: [Read, Grep, Glob, Bash, Write]
description: "Load and analyze project context, configurations, and dependencies" description: "Load and analyze project context, configurations, and dependencies"
--- ---
# /load - Project Context Loading # /sc:load - Project Context Loading
## Purpose ## Purpose
Load and analyze project context, configurations, dependencies, and environment setup. Load and analyze project context, configurations, dependencies, and environment setup.
## Usage ## Usage
``` ```
/load [target] [--type project|config|deps|env] [--cache] /sc:load [target] [--type project|config|deps|env] [--cache]
``` ```
## Arguments ## Arguments

4
SuperClaude/Commands/spawn.md
View File

@@ -3,14 +3,14 @@ allowed-tools: [Read, Grep, Glob, Bash, TodoWrite, Edit, MultiEdit, Write]
description: "Break complex tasks into coordinated subtasks with efficient execution" description: "Break complex tasks into coordinated subtasks with efficient execution"
--- ---
# /spawn - Task Orchestration # /sc:spawn - Task Orchestration
## Purpose ## Purpose
Decompose complex requests into manageable subtasks and coordinate their execution. Decompose complex requests into manageable subtasks and coordinate their execution.
## Usage ## Usage
``` ```
/spawn [task] [--sequential|--parallel] [--validate] /sc:spawn [task] [--sequential|--parallel] [--validate]
``` ```
## Arguments ## Arguments

12
SuperClaude/Commands/task.md
View File

@@ -8,14 +8,14 @@ personas: [architect, analyzer, project-manager]
mcp-servers: [sequential, context7] mcp-servers: [sequential, context7]
--- ---
# /task - Enhanced Task Management # /sc:task - Enhanced Task Management
## Purpose ## Purpose
Execute complex tasks with intelligent workflow management, cross-session persistence, hierarchical task organization, and advanced orchestration capabilities. Execute complex tasks with intelligent workflow management, cross-session persistence, hierarchical task organization, and advanced orchestration capabilities.
## Usage ## Usage
``` ```
/task [action] [target] [--strategy systematic|agile|enterprise] [--persist] [--hierarchy] [--delegate] /sc:task [action] [target] [--strategy systematic|agile|enterprise] [--persist] [--hierarchy] [--delegate]
``` ```
## Actions ## Actions
@@ -124,22 +124,22 @@ Execute complex tasks with intelligent workflow management, cross-session persis
### Create Project-Level Task Hierarchy ### Create Project-Level Task Hierarchy
``` ```
/task create "Implement user authentication system" --hierarchy --persist --strategy systematic /sc:task create "Implement user authentication system" --hierarchy --persist --strategy systematic
``` ```
### Execute with Multi-Agent Delegation ### Execute with Multi-Agent Delegation
``` ```
/task execute AUTH-001 --delegate --wave-mode --validate /sc:task execute AUTH-001 --delegate --wave-mode --validate
``` ```
### Analytics and Optimization ### Analytics and Optimization
``` ```
/task analytics --project AUTH --optimization-recommendations /sc:task analytics --project AUTH --optimization-recommendations
``` ```
### Cross-Session Task Management ### Cross-Session Task Management
``` ```
/task status --all-sessions --detailed-breakdown /sc:task status --all-sessions --detailed-breakdown
``` ```
## Claude Code Integration ## Claude Code Integration

4
SuperClaude/Commands/test.md
View File

@@ -3,14 +3,14 @@ allowed-tools: [Read, Bash, Glob, TodoWrite, Edit, Write]
description: "Execute tests, generate test reports, and maintain test coverage" description: "Execute tests, generate test reports, and maintain test coverage"
--- ---
# /test - Testing and Quality Assurance # /sc:test - Testing and Quality Assurance
## Purpose ## Purpose
Execute tests, generate comprehensive test reports, and maintain test coverage standards. Execute tests, generate comprehensive test reports, and maintain test coverage standards.
## Usage ## Usage
``` ```
/test [target] [--type unit|integration|e2e|all] [--coverage] [--watch] /sc:test [target] [--type unit|integration|e2e|all] [--coverage] [--watch]
``` ```
## Arguments ## Arguments

4
SuperClaude/Commands/troubleshoot.md
View File

@@ -3,14 +3,14 @@ allowed-tools: [Read, Grep, Glob, Bash, TodoWrite]
description: "Diagnose and resolve issues in code, builds, or system behavior" description: "Diagnose and resolve issues in code, builds, or system behavior"
--- ---
# /troubleshoot - Issue Diagnosis and Resolution # /sc:troubleshoot - Issue Diagnosis and Resolution
## Purpose ## Purpose
Systematically diagnose and resolve issues in code, builds, deployments, or system behavior. Systematically diagnose and resolve issues in code, builds, deployments, or system behavior.
## Usage ## Usage
``` ```
/troubleshoot [issue] [--type bug|build|performance|deployment] [--trace] /sc:troubleshoot [issue] [--type bug|build|performance|deployment] [--trace]
``` ```
## Arguments ## Arguments

116
setup/components/commands.py
View File

@@ -71,7 +71,7 @@ class CommandsComponent(Component):
errors.append(f"Missing command files: {missing_files}") errors.append(f"Missing command files: {missing_files}")
# Check write permissions to install directory # Check write permissions to install directory
commands_dir = self.install_dir / "commands" commands_dir = self.install_dir / "commands" / "sc"
has_perms, missing = SecurityValidator.check_permissions( has_perms, missing = SecurityValidator.check_permissions(
self.install_dir, {'write'} self.install_dir, {'write'}
) )
@@ -92,7 +92,7 @@ class CommandsComponent(Component):
for filename in self.command_files: for filename in self.command_files:
source = source_dir / filename source = source_dir / filename
target = self.install_dir / "commands" / filename target = self.install_dir / "commands" / "sc" / filename
files.append((source, target)) files.append((source, target))
return files return files
@@ -119,6 +119,9 @@ class CommandsComponent(Component):
try: try:
self.logger.info("Installing SuperClaude command definitions...") self.logger.info("Installing SuperClaude command definitions...")
# Check for and migrate existing commands from old location
self._migrate_existing_commands()
# Validate installation # Validate installation
success, errors = self.validate_prerequisites() success, errors = self.validate_prerequisites()
if not success: if not success:
@@ -131,7 +134,7 @@ class CommandsComponent(Component):
# Validate all files for security # Validate all files for security
source_dir = self._get_source_dir() source_dir = self._get_source_dir()
commands_dir = self.install_dir / "commands" commands_dir = self.install_dir / "commands" / "sc"
is_safe, security_errors = SecurityValidator.validate_component_files( is_safe, security_errors = SecurityValidator.validate_component_files(
files_to_install, source_dir, commands_dir files_to_install, source_dir, commands_dir
) )
@@ -185,8 +188,8 @@ class CommandsComponent(Component):
try: try:
self.logger.info("Uninstalling SuperClaude commands component...") self.logger.info("Uninstalling SuperClaude commands component...")
# Remove command files # Remove command files from sc subdirectory
commands_dir = self.install_dir / "commands" commands_dir = self.install_dir / "commands" / "sc"
removed_count = 0 removed_count = 0
for filename in self.command_files: for filename in self.command_files:
@@ -197,13 +200,39 @@ class CommandsComponent(Component):
else: else:
self.logger.warning(f"Could not remove {filename}") self.logger.warning(f"Could not remove {filename}")
# Remove commands directory if empty # Also check and remove any old commands in root commands directory
old_commands_dir = self.install_dir / "commands"
old_removed_count = 0
for filename in self.command_files:
old_file_path = old_commands_dir / filename
if old_file_path.exists() and old_file_path.is_file():
if self.file_manager.remove_file(old_file_path):
old_removed_count += 1
self.logger.debug(f"Removed old {filename}")
else:
self.logger.warning(f"Could not remove old {filename}")
if old_removed_count > 0:
self.logger.info(f"Also removed {old_removed_count} commands from old location")
removed_count += old_removed_count
# Remove sc subdirectory if empty
try: try:
if commands_dir.exists(): if commands_dir.exists():
remaining_files = list(commands_dir.iterdir()) remaining_files = list(commands_dir.iterdir())
if not remaining_files: if not remaining_files:
commands_dir.rmdir() commands_dir.rmdir()
self.logger.debug("Removed empty commands directory") self.logger.debug("Removed empty sc commands directory")
# Also remove parent commands directory if empty
parent_commands_dir = self.install_dir / "commands"
if parent_commands_dir.exists():
remaining_files = list(parent_commands_dir.iterdir())
if not remaining_files:
parent_commands_dir.rmdir()
self.logger.debug("Removed empty parent commands directory")
except Exception as e: except Exception as e:
self.logger.warning(f"Could not remove commands directory: {e}") self.logger.warning(f"Could not remove commands directory: {e}")
@@ -242,7 +271,7 @@ class CommandsComponent(Component):
self.logger.info(f"Updating commands component from {current_version} to {target_version}") self.logger.info(f"Updating commands component from {current_version} to {target_version}")
# Create backup of existing command files # Create backup of existing command files
commands_dir = self.install_dir / "commands" commands_dir = self.install_dir / "commands" / "sc"
backup_files = [] backup_files = []
if commands_dir.exists(): if commands_dir.exists():
@@ -287,10 +316,10 @@ class CommandsComponent(Component):
"""Validate commands component installation""" """Validate commands component installation"""
errors = [] errors = []
# Check if commands directory exists # Check if sc commands directory exists
commands_dir = self.install_dir / "commands" commands_dir = self.install_dir / "commands" / "sc"
if not commands_dir.exists(): if not commands_dir.exists():
errors.append("Commands directory not found") errors.append("SC commands directory not found")
return False, errors return False, errors
# Check if all command files exist # Check if all command files exist
@@ -343,6 +372,67 @@ class CommandsComponent(Component):
"files_installed": len(self.command_files), "files_installed": len(self.command_files),
"command_files": self.command_files, "command_files": self.command_files,
"estimated_size": self.get_size_estimate(), "estimated_size": self.get_size_estimate(),
"install_directory": str(self.install_dir / "commands"), "install_directory": str(self.install_dir / "commands" / "sc"),
"dependencies": self.get_dependencies() "dependencies": self.get_dependencies()
} }
def _migrate_existing_commands(self) -> None:
"""Migrate existing commands from old location to new sc subdirectory"""
try:
old_commands_dir = self.install_dir / "commands"
new_commands_dir = self.install_dir / "commands" / "sc"
# Check if old commands exist in root commands directory
migrated_count = 0
commands_to_migrate = []
if old_commands_dir.exists():
for filename in self.command_files:
old_file_path = old_commands_dir / filename
if old_file_path.exists() and old_file_path.is_file():
commands_to_migrate.append(filename)
if commands_to_migrate:
self.logger.info(f"Found {len(commands_to_migrate)} existing commands to migrate to sc/ subdirectory")
# Ensure new directory exists
if not self.file_manager.ensure_directory(new_commands_dir):
self.logger.error(f"Could not create sc commands directory: {new_commands_dir}")
return
# Move files from old to new location
for filename in commands_to_migrate:
old_file_path = old_commands_dir / filename
new_file_path = new_commands_dir / filename
try:
# Copy file to new location
if self.file_manager.copy_file(old_file_path, new_file_path):
# Remove old file
if self.file_manager.remove_file(old_file_path):
migrated_count += 1
self.logger.debug(f"Migrated {filename} to sc/ subdirectory")
else:
self.logger.warning(f"Could not remove old {filename}")
else:
self.logger.warning(f"Could not copy {filename} to sc/ subdirectory")
except Exception as e:
self.logger.warning(f"Error migrating {filename}: {e}")
if migrated_count > 0:
self.logger.success(f"Successfully migrated {migrated_count} commands to /sc: namespace")
self.logger.info("Commands are now available as /sc:analyze, /sc:build, etc.")
# Try to remove old commands directory if empty
try:
if old_commands_dir.exists():
remaining_files = [f for f in old_commands_dir.iterdir() if f.is_file()]
if not remaining_files:
# Only remove if no user files remain
old_commands_dir.rmdir()
self.logger.debug("Removed empty old commands directory")
except Exception as e:
self.logger.debug(f"Could not remove old commands directory: {e}")
except Exception as e:
self.logger.warning(f"Error during command migration: {e}")