2025-08-18 11:58:55 +02:00
# SuperClaude Commands Guide
2025-09-15 15:03:33 +00:00
SuperClaude provides 24 commands for Claude Code: `/sc:*` commands for workflows and `@agent-*` for specialists.
2025-08-21 19:03:25 +02:00
## Command Types
| Type | Where Used | Format | Example |
|------|------------|--------|---------|
| **Slash Commands** | Claude Code | `/sc:[command]` | `/sc:implement "feature"` |
2025-08-21 19:05:51 +02:00
| **Agents** | Claude Code | `@agent-[name]` | `@agent-security "review"` |
2025-08-21 19:03:25 +02:00
| **Installation** | Terminal | `SuperClaude [command]` | `SuperClaude install` |
## Quick Test
```bash
# Terminal: Verify installation
python3 -m SuperClaude --version
2025-08-22 19:18:44 +02:00
# Claude Code CLI verification: claude --version
2025-08-21 19:03:25 +02:00
# Claude Code: Test commands
/sc:brainstorm "test project" # Should ask discovery questions
/sc:analyze README.md # Should provide analysis
```
**Workflow**: `/sc:brainstorm "idea"` → `/sc:implement "feature"` → `/sc:test`
## 🎯 Understanding SuperClaude Commands
## How SuperClaude Works
SuperClaude provides behavioral context files that Claude Code reads to adopt specialized behaviors. When you type `/sc:implement` , Claude Code reads the `implement.md` context file and follows its behavioral instructions.
**SuperClaude commands are NOT executed by software** - they are context triggers that modify Claude Code's behavior through reading specialized instruction files from the framework.
### Command Types:
- **Slash Commands** (`/sc:*` ): Trigger workflow patterns and behavioral modes
2025-08-21 19:05:51 +02:00
- **Agent Invocations** (`@agent-*` ): Manually activate specific domain specialists
2025-08-21 19:03:25 +02:00
- **Flags** (`--think` , `--safe-mode` ): Modify command behavior and depth
### The Context Mechanism:
1. **User Input** : You type `/sc:implement "auth system"`
2. **Context Loading** : Claude Code reads `~/.claude/SuperClaude/Commands/implement.md`
3. **Behavior Adoption** : Claude applies domain expertise, tool selection, and validation patterns
4. **Enhanced Output** : Structured implementation with security considerations and best practices
**Key Point**: This creates sophisticated development workflows through context management rather than traditional software execution.
### Installation vs Usage Commands
**🖥️ Terminal Commands** (Actual CLI software):
- `SuperClaude install` - Installs the framework components
- `SuperClaude update` - Updates existing installation
- `SuperClaude uninstall` - Removes framework installation
- `python3 -m SuperClaude --version` - Check installation status
**💬 Claude Code Commands** (Context triggers):
- `/sc:brainstorm` - Activates requirements discovery context
- `/sc:implement` - Activates feature development context
2025-08-21 19:05:51 +02:00
- `@agent-security` - Activates security specialist context
2025-08-21 19:03:25 +02:00
- All commands work inside Claude Code chat interface only
2025-08-18 12:45:06 +02:00
2025-08-18 11:58:55 +02:00
> **Quick Start**: Try `/sc:brainstorm "your project idea"` → `/sc:implement "feature name"` → `/sc:test` to experience the core workflow.
## 🧪 Testing Your Setup
2025-08-18 12:45:06 +02:00
### 🖥️ Terminal Verification (Run in Terminal/CMD)
2025-08-18 11:58:55 +02:00
```bash
2025-08-21 19:03:25 +02:00
# Verify SuperClaude is working (primary method)
python3 -m SuperClaude --version
Fixes and improvement (#378)
* Fix: Install only selected MCP servers and ensure valid empty backups
This commit addresses two separate issues:
1. **MCP Installation:** The `install` command was installing all MCP servers instead of only the ones selected by the user. The `_install` method in `setup/components/mcp.py` was iterating through all available servers, not the user's selection. This has been fixed to respect the `selected_mcp_servers` configuration. A new test has been added to verify this fix.
2. **Backup Creation:** The `create_backup` method in `setup/core/installer.py` created an invalid `.tar.gz` file when the backup source was empty. This has been fixed to ensure that a valid, empty tar archive is always created. A test was added for this as well.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
* Fix: Correct installer validation for MCP and MCP Docs components
This commit fixes a validation issue in the installer where it would incorrectly fail after a partial installation of MCP servers.
The `MCPComponent` validation logic was checking for all "required" servers, regardless of whether they were selected by the user. This has been corrected to only validate the servers that were actually installed, by checking against the list of installed servers stored in the metadata. The metadata storage has also been fixed to only record the installed servers.
The `MCPDocsComponent` was failing validation because it was not being registered in the metadata if no documentation files were installed. This has been fixed by ensuring the post-installation hook runs even when no files are copied.
New tests have been added for both components to verify the corrected logic.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
* Fix: Allow re-installation of components and correct validation logic
This commit fixes a bug that prevented new MCP servers from being installed on subsequent runs of the installer. It also fixes the validation logic that was causing failures after a partial installation.
The key changes are:
1. A new `is_reinstallable` method has been added to the base `Component` class. This allows certain components (like the `mcp` component) to be re-run even if they are already marked as installed.
2. The installer logic has been updated to respect this new method.
3. The `MCPComponent` now correctly stores only the installed servers in the metadata.
4. The validation logic for `MCPComponent` and `MCPDocsComponent` has been corrected to prevent incorrect failures.
New tests have been added to verify all aspects of the new logic.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
* feat: Display authors in UI header and update author info
This commit implements the user's request to display author names and emails in the UI header of the installer.
The key changes are:
1. The `__email__` field in `SuperClaude/__init__.py` has been updated to include both authors' emails.
2. The `display_header` function in `setup/utils/ui.py` has been modified to read the author and email information and display it.
3. A new test has been added to `tests/test_ui.py` to verify the new UI output.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
* feat: Version bump to 4.1.0 and various fixes
This commit prepares the project for the v4.1.0 release. It includes a version bump across all relevant files and incorporates several bug fixes and feature enhancements from recent tasks.
Key changes in this release:
- **Version Bump**: The project version has been updated from 4.0.9 to 4.1.0 in all configuration files, documentation, and source code.
- **Installer Fixes**:
- Components can now be marked as `reinstallable`, allowing them to be re-run on subsequent installations. This fixes a bug where new MCP servers could not be added.
- The validation logic for `mcp` and `mcp_docs` components has been corrected to avoid incorrect failures.
- A bug in the backup creation process that created invalid empty archives has been fixed.
- **UI Enhancements**:
- Author names and emails are now displayed in the installer UI header.
- **Metadata Updates**:
- Mithun Gowda B has been added as an author.
- **New Tests**:
- Comprehensive tests have been added for the installer logic, MCP components, and UI changes to ensure correctness and prevent regressions.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
* fix: Resolve dependencies for partial installs and other fixes
This commit addresses several issues, the main one being a dependency resolution failure during partial installations.
Key changes:
- **Dependency Resolution**: The installer now correctly resolves the full dependency tree when a user requests to install a subset of components. This fixes the "Unknown component: core" error.
- **Component Re-installation**: A new `is_reinstallable` flag allows components like `mcp` to be re-run on subsequent installs, enabling the addition of new servers.
- **Validation Logic**: The validation for `mcp` and `mcp_docs` has been corrected to avoid spurious failures.
- **UI and Metadata**: Author information has been added to the UI header and source files.
- **Version Bump**: The project version has been updated to 4.1.0.
- **Tests**: New tests have been added to cover all the above changes.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
* fix: Installer fixes and version bump to 4.1.0
This commit includes a collection of fixes for the installer logic, UI enhancements, and a version bump to 4.1.0.
Key changes:
- **Dependency Resolution**: The installer now correctly resolves the full dependency tree for partial installations, fixing the "Unknown component: core" error.
- **Component Re-installation**: A new `is_reinstallable` flag allows components like `mcp` to be re-run to add new servers.
- **MCP Installation**: The non-interactive installation of the `mcp` component now correctly prompts the user to select servers.
- **Validation Logic**: The post-installation validation logic has been corrected to only validate components from the current session and to use the correct list of installed servers.
- **UI & Metadata**: Author information has been added to the UI and source files.
- **Version Bump**: The project version has been updated from 4.0.9 to 4.1.0 across all files.
- **Tests**: New tests have been added to cover all the bug fixes.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
* feat: Add --authors flag and multiple installer fixes
This commit introduces the `--authors` flag to display author information and includes a collection of fixes for the installer logic.
Key changes:
- **New Feature**: Added an `--authors` flag that displays the names, emails, and GitHub usernames of the project authors.
- **Dependency Resolution**: Fixed a critical bug where partial installations would fail due to unresolved dependencies.
- **Component Re-installation**: Added a mechanism to allow components to be "reinstallable", fixing an issue that prevented adding new MCP servers on subsequent runs.
- **MCP Installation**: The non-interactive installation of the `mcp` component now correctly prompts for server selection.
- **Validation Logic**: Corrected the post-installation validation to prevent spurious errors.
- **Version Bump**: The project version has been updated to 4.1.0.
- **Metadata**: Author and GitHub information has been added to the source files.
- **UI**: The installer header now displays author information.
- **Tests**: Added new tests for all new features and bug fixes.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
* Add Docker support and framework enhancements
- Add serena-docker.json MCP configuration
- Update MCP configs and installer components
- Enhance CLI commands with new functionality
- Add symbols utility for framework operations
- Improve UI and logging components
🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
* Bump version from 4.1.1 to 4.1.2
- Update version across all package files
- Update documentation and README files
- Update Python module version strings
- Update feature configuration files
🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
Co-Authored-By: Mithun Gowda B <mithungowda.b7411@gmail.com>
* Bump version from 4.1.2 to 4.1.3
- Update version across all package files
- Update documentation and README files
- Update Python module version strings
- Update feature configuration files
🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
Co-Authored-By: Mithun Gowda B <mithungowda.b7411@gmail.com>
* Fix home directory detection for immutable distros
- Add get_home_directory() function to handle /var/home/$USER paths
- Support Fedora Silverblue, Universal Blue, and other immutable distros
- Replace all Path.home() calls throughout the setup system
- Add fallback methods for edge cases and compatibility
- Create test script for immutable distro validation
Fixes:
- Incorrect home path detection on immutable Linux distributions
- Installation failures on Fedora Silverblue/Universal Blue
- Issues with Claude Code configuration paths
Technical changes:
- New get_home_directory() in utils/environment.py
- Updated all CLI commands, validators, and core components
- Maintains backward compatibility with standard systems
- Robust fallback chain for edge cases
🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
Co-Authored-By: Mithun Gowda B <mithungowda.b7411@gmail.com>
* Fix circular import and complete immutable distro support
- Move get_home_directory() to separate paths.py module
- Resolve circular import between environment.py and logger.py
- Update all import statements across the setup system
- Verify functionality with comprehensive testing
Technical changes:
- Created setup/utils/paths.py for path utilities
- Updated imports in all affected modules
- Maintains full backward compatibility
- Fixes installation on immutable distros
Testing completed:
- ✅ Basic home directory detection works
- ✅ Installation system integration works
- ✅ Environment utilities integration works
- ✅ Immutable distro logic validated
🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
Co-Authored-By: Mithun Gowda B <mithungowda.b7411@gmail.com>
* Fix mcp_docs installation bugs
- Fix mcp_docs component incorrectly marking as installed when no MCP servers selected
- Add MCP server selection prompt when mcp_docs component is explicitly requested
- Return False instead of calling _post_install() when no servers selected or files found
- Add user-friendly warning when mcp_docs requested without server selection
- Remove mcp_docs from installation when no servers are available
🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
* Fix MCP server name mapping for documentation files
- Add mapping for sequential-thinking -> MCP_Sequential.md
- Add mapping for morphllm-fast-apply -> MCP_Morphllm.md
- Ensures mcp_docs installation works with all MCP server naming conventions
🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
* Enable mcp_docs component reinstallation
- Add is_reinstallable() method returning True to allow repeat installations
- Fixes issue where mcp_docs was skipped on subsequent installation attempts
- Enables users to change MCP server selections and update documentation
🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
* Fix repeat installation issues for mcp_docs
- Ensure mcp component is auto-added when mcp_docs is selected with servers
- Fix component_files tracking to only include successfully copied files
- Ensures CLAUDE.md gets properly updated with MCP documentation imports
- Fixes issue where MCP servers weren't installed on repeat attempts
🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
* Fix MCP component metadata tracking and debug logging
- Fix servers_count to track actually installed servers instead of total available
- Add installed_servers list to metadata for better tracking
- Add debug logging to trace component auto-addition
- Ensures MCP component appears properly in metadata when servers are installed
🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
* Fix pyproject.toml license format and add missing classifier
- Fix license format from string to {text = "MIT"} format
- Add missing "License :: OSI Approved :: MIT License" classifier
- Fix indentation consistency in classifiers section
- Resolves setup.py installation errors and PEP 621 compliance
🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
* Fix MCP incremental installation and auto-detection system
PROBLEM FIXED:
- MCP component only registered servers selected during current session
- mcp_docs component only installed docs for newly selected servers
- Users had to reinstall everything when adding new MCP servers
- Installation failed if no servers selected but servers existed
SOLUTION IMPLEMENTED:
- Add auto-detection of existing MCP servers from config files (.claude.json, claude_desktop_config.json)
- Add CLI detection via 'claude mcp list' output parsing
- Add smart server merging (existing + selected + previously installed)
- Add server name normalization for common variations
- Fix CLI logic to allow mcp_docs installation without server selection
- Add graceful error handling for corrupted configs
KEY FEATURES:
✅ Auto-detects existing MCP servers from multiple config locations
✅ Supports incremental installation (add new servers without breaking existing)
✅ Works with or without --install-dir argument
✅ Handles server name variations (sequential vs sequential-thinking, etc.)
✅ Maintains metadata persistence across installation sessions
✅ Graceful fallback when config files are corrupted
✅ Compatible with both interactive and non-interactive modes
TESTED SCENARIOS:
- Fresh installation with no MCP servers ✅
- Auto-detection with existing servers ✅
- Incremental server additions ✅
- Mixed mode (new + existing servers) ✅
- Error handling with corrupted configs ✅
- Default vs custom installation directories ✅
- Interactive vs command-line modes ✅
Files changed:
- setup/cli/commands/install.py: Allow mcp_docs auto-detection mode
- setup/components/mcp.py: Add comprehensive auto-detection logic
- setup/components/mcp_docs.py: Add auto-detection for documentation
🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
* Integrate SuperClaude framework flags into help command
ENHANCEMENT:
- Add comprehensive flag documentation to /sc:help command
- Include all 25 SuperClaude framework flags with descriptions
- Organize flags into logical categories (Mode, MCP, Analysis, Execution, Output)
- Add practical usage examples showing flag combinations
- Include flag priority rules and precedence hierarchy
NEW SECTIONS ADDED:
✅ Mode Activation Flags (5 flags): --brainstorm, --introspect, --task-manage, --orchestrate, --token-efficient
✅ MCP Server Flags (8 flags): --c7, --seq, --magic, --morph, --serena, --play, --all-mcp, --no-mcp
✅ Analysis Depth Flags (3 flags): --think, --think-hard, --ultrathink
✅ Execution Control Flags (6 flags): --delegate, --concurrency, --loop, --iterations, --validate, --safe-mode
✅ Output Optimization Flags (3 flags): --uc, --scope, --focus
✅ Flag Priority Rules: Clear hierarchy and precedence guidelines
✅ Usage Examples: 4 practical examples showing real-world flag combinations
IMPACT:
- Users can now discover all SuperClaude capabilities from /sc:help
- Single source of truth for commands AND flags
- Improved discoverability of advanced features
- Clear guidance on flag usage and combinations
- Help content nearly doubled (68 → 148 lines) with valuable reference information
Files changed:
- SuperClaude/Commands/help.md: Integrate FLAGS.md content with structured tables and examples
🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
* Remove non-existent commands from modes.md documentation
PROBLEM FIXED:
- Documentation contained references to fake/non-existent commands
- Commands like sc:fix, sc:simple-pix, sc:update, sc:develop, sc:modernize, sc:simple-fix don't exist in CLI
- Confusing users who try to use these commands and get errors
- Inconsistency between documentation and actual SuperClaude command availability
COMMANDS REMOVED/REPLACED:
❌ /sc:simple-fix → ✅ /sc:troubleshoot (real command)
❌ /sc:develop → ✅ /sc:implement (real command)
❌ /sc:modernize → ✅ /sc:improve (real command)
AFFECTED FILES:
- Docs/User-Guide/modes.md: Fixed all non-existent command references
- Docs/User-Guide-jp/modes.md: Fixed Japanese translation with same issues
- Docs/User-Guide-zh/modes.md: Fixed Chinese translation with same issues
VERIFICATION:
✅ All remaining /sc: commands verified to exist in SuperClaude/Commands/
✅ No more references to fake commands in any language version
✅ Examples now use only real, working SuperClaude commands
✅ User experience improved - no more confusion from non-working commands
REAL COMMANDS REFERENCED:
- /sc:analyze, /sc:brainstorm, /sc:help, /sc:implement
- /sc:improve, /sc:reflect, /sc:troubleshoot
- All verified to exist in CLI implementation
🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
* Version bump to 4.1.4
CHANGELOG:
✅ Added comprehensive flag documentation to /sc:help command
✅ Fixed MCP incremental installation and auto-detection system
✅ Cleaned up documentation by removing non-existent commands
✅ Enhanced user experience with complete capability reference
VERSION UPDATES:
- Updated VERSION file: 4.1.3 → 4.1.4
- Updated pyproject.toml: 4.1.3 → 4.1.4
- Updated package.json: 4.1.3 → 4.1.4
- Updated all Python __init__.py fallback versions
- Updated all documentation references across all languages
- Updated setup/data/features.json component versions
- Updated CHANGELOG.md with comprehensive 4.1.4 release notes
SCOPE OF CHANGES:
📦 Core files: VERSION, pyproject.toml, package.json, __init__.py files
📚 Documentation: All .md files across English, Japanese, Chinese
🔧 Setup files: features.json, base.py version references
📝 Project files: README files, CHANGELOG, SECURITY, CONTRIBUTING
VERIFICATION:
✅ No remaining 4.1.3 references found
✅ 29 files now properly reference 4.1.4
✅ All language versions consistently updated
✅ Package metadata properly versioned for distribution
🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
---------
Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Happy <yesreply@happy.engineering>
2025-09-20 10:38:42 +02:00
# Example output: SuperClaude 4.1.4
2025-08-21 19:03:25 +02:00
2025-08-22 19:18:44 +02:00
# Claude Code CLI version check
claude --version
2025-08-18 11:58:55 +02:00
2025-08-22 19:18:44 +02:00
# Check installed components
python3 -m SuperClaude install --list-components | grep mcp
2025-08-21 19:03:25 +02:00
# Example output: Shows installed MCP components
2025-08-18 11:58:55 +02:00
```
2025-08-18 12:45:06 +02:00
### 💬 Claude Code Testing (Type in Claude Code Chat)
```
# Test basic /sc: command
/sc:brainstorm "test project"
2025-08-21 19:03:25 +02:00
# Example behavior: Interactive requirements discovery starts
2025-08-18 12:45:06 +02:00
# Test command help
/sc:help
2025-08-21 19:03:25 +02:00
# Example behavior: List of available commands
2025-08-18 12:45:06 +02:00
```
2025-08-18 11:58:55 +02:00
**If tests fail**: Check [Installation Guide ](../Getting-Started/installation.md ) or [Troubleshooting ](#troubleshooting )
2025-08-21 19:03:25 +02:00
### 📝 Command Quick Reference
2025-08-18 12:45:06 +02:00
2025-08-21 19:03:25 +02:00
| Command Type | Where to Run | Format | Purpose | Example |
|-------------|--------------|--------|---------|----------|
| ** 🖥️ Installation** | Terminal/CMD | `SuperClaude [command]` | Setup and maintenance | `SuperClaude install` |
| ** 🔧 Configuration** | Terminal/CMD | `python3 -m SuperClaude [command]` | Advanced configuration | `python3 -m SuperClaude --version` |
| ** 💬 Slash Commands** | Claude Code | `/sc:[command]` | Workflow automation | `/sc:implement "feature"` |
2025-08-21 19:05:51 +02:00
| ** 🤖 Agent Invocation** | Claude Code | `@agent-[name]` | Manual specialist activation | `@agent-security "review"` |
2025-08-21 19:03:25 +02:00
| ** ⚡ Enhanced Flags** | Claude Code | `/sc:[command] --flags` | Behavior modification | `/sc:analyze --think-hard` |
2025-08-18 12:45:06 +02:00
2025-08-21 19:05:51 +02:00
> **Remember**: All `/sc:` commands and `@agent-` invocations work inside Claude Code chat, not your terminal. They trigger Claude Code to read specific context files from the SuperClaude framework.
2025-08-18 12:45:06 +02:00
2025-08-18 11:58:55 +02:00
## Table of Contents
- [Essential Commands ](#essential-commands ) - Start here (8 core commands)
- [Common Workflows ](#common-workflows ) - Command combinations that work
added spec-panel, which transforms the project specs though the lens … (#346)
Introduces a multi-expert specification review and improvement system
powered by renowned software engineering and specification experts. This
command transforms technical specifications through the lens of industry
experts, providing actionable feedback and systematic improvement
recommendations.
🎯 Key Features
Expert Panel System
- 10 Industry Experts: Karl Wiegers, Gojko Adzic, Alistair Cockburn,
Martin Fowler, Michael Nygard, Sam Newman, Gregor Hohpe, Lisa Crispin,
Janet Gregory, and Kelsey Hightower
- Domain Specialization: Requirements engineering, architecture,
testing,
compliance, and cloud-native patterns
- Authentic Methodologies: Each expert applies their real-world
frameworks and critique styles
Analysis Modes
- Discussion Mode: Collaborative improvement through expert dialogue
- Critique Mode: Systematic review with prioritized recommendations
- Socratic Mode: Learning-focused questioning for deeper understanding
Focus Areas
- Requirements: Clarity, completeness, testability validation
- Architecture: Interface design, scalability, maintainability analysis
- Testing: Quality attributes, coverage, edge case identification
- Compliance: Regulatory requirements, security, operational excellence
🔧 Technical Implementation
Command Structure
/sc:spec-panel [content|@file] [--mode discussion|critique|socratic]
[--focus area] [--iterations N]
MCP Integration
- Sequential MCP: Expert panel coordination and structured analysis
- Context7 MCP: Industry patterns and best practices
- Persona System: Technical Writer, System Architect, Quality Engineer
activation
Quality Metrics
- Clarity Score (0-10): Language precision and understandability
- Completeness Score (0-10): Coverage of essential elements
- Testability Score (0-10): Measurability and validation capability
- Consistency Score (0-10): Internal coherence assessment
📊 Output Examples
Expert Critique Format
KARL WIEGERS - Requirements Engineering:
❌ CRITICAL: Password complexity requirements not specified
📝 RECOMMENDATION: Add requirement "System SHALL enforce password
complexity: minimum 8 characters, mixed case, numbers"
🎯 PRIORITY: High - Security vulnerability without standards
📊 QUALITY IMPACT: +35% security compliance, +20% completeness
Improvement Roadmap
- Immediate: Critical security and clarity issues
- Short-term: Architecture refinements and testing strategies
- Long-term: Evolution planning and advanced optimizations
🚀 Integration Patterns
Workflow
1. Generate specification using
https://github.com/github/spec-kit/blob/main/spec-driven.md
2. Review and improve with expert panel
3. Iterative refinement based on feedback
CI/CD Integration
- Specification validation in development workflow
- Quality gate enforcement with automated checks
- Version control integration for evolution tracking
📈 Quality Impact
Based on an example review:
- Security Completeness: +35% improvement
- Requirements Clarity: +14% improvement
- Testability Score: +19% improvement
- Production Readiness: +47% improvement
- Overall Quality: +24% improvement
🎓 Learning Features
Educational Value
- Socratic questioning mode for skill development
- Expert methodology exposure and learning
- Progressive specification writing guidance
- Best practice pattern recognition
Mentoring Integration
- Step-by-step improvement guidance
- Industry standard alignment
- Professional specification writing techniques
🔗 Files Changed
- SuperClaude/Commands/spec-panel.md - Complete command specification
🧪 Testing
Includes comprehensive examples:
- API specification review with security focus
- Requirements workshop with collaborative analysis
- Architecture validation with socratic questioning
- Multi-iteration improvement workflows
This feature significantly enhances SuperClaude's specification analysis
capabilities, providing professional-grade review and improvement
guidance through authentic expert perspectives and proven methodologies.
2025-09-09 17:01:56 +02:00
- [Full Command Reference ](#full-command-reference ) - All 23 commands organized by category
2025-08-18 11:58:55 +02:00
- [Troubleshooting ](#troubleshooting ) - Common issues and solutions
- [Command Index ](#command-index ) - Find commands by category
---
## Essential Commands
2025-08-21 19:03:25 +02:00
**Core workflow commands for immediate productivity:**
2025-08-18 11:58:55 +02:00
### `/sc:brainstorm` - Project Discovery
**Purpose**: Interactive requirements discovery and project planning
**Syntax**: `/sc:brainstorm "your idea"` `[--strategy systematic|creative]`
**Use Cases**:
- New project planning: `/sc:brainstorm "e-commerce platform"`
- Feature exploration: `/sc:brainstorm "user authentication system"`
- Problem solving: `/sc:brainstorm "slow database queries"`
2025-09-15 15:03:33 +00:00
### `/sc:help` - Command Reference
**Purpose**: Displays a list of all available `/sc` commands and their descriptions.
**Syntax**: `/sc:help`
**Use Cases**:
- Discovering available commands: `/sc:help`
- Getting a quick reminder of command names: `/sc:help`
2025-08-18 11:58:55 +02:00
### `/sc:implement` - Feature Development
**Purpose**: Full-stack feature implementation with intelligent specialist routing
**Syntax**: `/sc:implement "feature description"` `[--type frontend|backend|fullstack] [--focus security|performance]`
**Use Cases**:
2025-08-21 19:03:25 +02:00
- Authentication: `/sc:implement "JWT login system"`
- UI components: `/sc:implement "responsive dashboard"`
- APIs: `/sc:implement "REST user endpoints"`
- Database: `/sc:implement "user schema with relationships"`
2025-08-18 11:58:55 +02:00
### `/sc:analyze` - Code Assessment
**Purpose**: Comprehensive code analysis across quality, security, and performance
2025-08-21 19:03:25 +02:00
**Syntax**: `/sc:analyze [path]` `[--focus quality|security|performance|architecture]`
2025-08-18 11:58:55 +02:00
2025-08-21 19:03:25 +02:00
**Use Cases**:
- Project health: `/sc:analyze .`
- Security audit: `/sc:analyze --focus security`
- Performance review: `/sc:analyze --focus performance`
2025-08-18 11:58:55 +02:00
feat: Add comprehensive business panel analysis system (#323)
* feat: Add comprehensive business panel analysis system
Implements /sc:business-panel command with 9 expert personas (Christensen, Porter, Drucker, Godin, Kim/Mauborgne, Collins, Taleb, Meadows, Doumont), three-phase adaptive methodology (Discussion/Debate/Socratic), intelligent mode selection, and cross-framework synthesis with business-specific symbol system.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: sarosh.quraishi@gmail.com
* docs: Update README and commands guide for business panel feature
- Update command count from 21 to 22 across all documentation
- Add Business Panel to behavioral modes (5 → 6 modes)
- Add /sc:business-panel to commands guide with full documentation
- Include expert panel details and usage examples
- Update command index and complexity classification
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: sarosh.quraishi@gmail.com
2025-08-29 14:25:34 +02:00
### `/sc:business-panel` - Strategic Business Analysis
**Purpose**: Multi-expert business strategy analysis with 9 renowned thought leaders
**Syntax**: `/sc:business-panel "content"` `[--mode discussion|debate|socratic] [--experts "name1,name2"]`
**Use Cases**:
- Strategy evaluation: `/sc:business-panel "our go-to-market strategy"`
- Competitive analysis: `/sc:business-panel @competitor_analysis.pdf --mode debate`
- Innovation assessment: `/sc:business-panel "AI product idea" --experts "christensen,drucker"`
- Strategic learning: `/sc:business-panel "competitive strategy" --mode socratic`
**Expert Panel**: Christensen, Porter, Drucker, Godin, Kim/Mauborgne, Collins, Taleb, Meadows, Doumont
added spec-panel, which transforms the project specs though the lens … (#346)
Introduces a multi-expert specification review and improvement system
powered by renowned software engineering and specification experts. This
command transforms technical specifications through the lens of industry
experts, providing actionable feedback and systematic improvement
recommendations.
🎯 Key Features
Expert Panel System
- 10 Industry Experts: Karl Wiegers, Gojko Adzic, Alistair Cockburn,
Martin Fowler, Michael Nygard, Sam Newman, Gregor Hohpe, Lisa Crispin,
Janet Gregory, and Kelsey Hightower
- Domain Specialization: Requirements engineering, architecture,
testing,
compliance, and cloud-native patterns
- Authentic Methodologies: Each expert applies their real-world
frameworks and critique styles
Analysis Modes
- Discussion Mode: Collaborative improvement through expert dialogue
- Critique Mode: Systematic review with prioritized recommendations
- Socratic Mode: Learning-focused questioning for deeper understanding
Focus Areas
- Requirements: Clarity, completeness, testability validation
- Architecture: Interface design, scalability, maintainability analysis
- Testing: Quality attributes, coverage, edge case identification
- Compliance: Regulatory requirements, security, operational excellence
🔧 Technical Implementation
Command Structure
/sc:spec-panel [content|@file] [--mode discussion|critique|socratic]
[--focus area] [--iterations N]
MCP Integration
- Sequential MCP: Expert panel coordination and structured analysis
- Context7 MCP: Industry patterns and best practices
- Persona System: Technical Writer, System Architect, Quality Engineer
activation
Quality Metrics
- Clarity Score (0-10): Language precision and understandability
- Completeness Score (0-10): Coverage of essential elements
- Testability Score (0-10): Measurability and validation capability
- Consistency Score (0-10): Internal coherence assessment
📊 Output Examples
Expert Critique Format
KARL WIEGERS - Requirements Engineering:
❌ CRITICAL: Password complexity requirements not specified
📝 RECOMMENDATION: Add requirement "System SHALL enforce password
complexity: minimum 8 characters, mixed case, numbers"
🎯 PRIORITY: High - Security vulnerability without standards
📊 QUALITY IMPACT: +35% security compliance, +20% completeness
Improvement Roadmap
- Immediate: Critical security and clarity issues
- Short-term: Architecture refinements and testing strategies
- Long-term: Evolution planning and advanced optimizations
🚀 Integration Patterns
Workflow
1. Generate specification using
https://github.com/github/spec-kit/blob/main/spec-driven.md
2. Review and improve with expert panel
3. Iterative refinement based on feedback
CI/CD Integration
- Specification validation in development workflow
- Quality gate enforcement with automated checks
- Version control integration for evolution tracking
📈 Quality Impact
Based on an example review:
- Security Completeness: +35% improvement
- Requirements Clarity: +14% improvement
- Testability Score: +19% improvement
- Production Readiness: +47% improvement
- Overall Quality: +24% improvement
🎓 Learning Features
Educational Value
- Socratic questioning mode for skill development
- Expert methodology exposure and learning
- Progressive specification writing guidance
- Best practice pattern recognition
Mentoring Integration
- Step-by-step improvement guidance
- Industry standard alignment
- Professional specification writing techniques
🔗 Files Changed
- SuperClaude/Commands/spec-panel.md - Complete command specification
🧪 Testing
Includes comprehensive examples:
- API specification review with security focus
- Requirements workshop with collaborative analysis
- Architecture validation with socratic questioning
- Multi-iteration improvement workflows
This feature significantly enhances SuperClaude's specification analysis
capabilities, providing professional-grade review and improvement
guidance through authentic expert perspectives and proven methodologies.
2025-09-09 17:01:56 +02:00
### `/sc:spec-panel` - Expert Specification Review
**Purpose**: Multi-expert specification review and improvement using renowned specification and software engineering experts
**Syntax**: `/sc:spec-panel [content|@file]` `[--mode discussion|critique|socratic] [--focus requirements|architecture|testing|compliance]`
**Use Cases**:
- Specification review: `/sc:spec-panel @api_spec.yml --mode critique --focus requirements,architecture`
- Requirements workshop: `/sc:spec-panel "user story content" --mode discussion`
- Architecture validation: `/sc:spec-panel @microservice.spec.yml --mode socratic --focus architecture`
- Compliance review: `/sc:spec-panel @security_requirements.yml --focus compliance`
- Iterative improvement: `/sc:spec-panel @complex_system.spec.yml --iterations 3`
**Expert Panel**: Wiegers, Adzic, Cockburn, Fowler, Nygard, Newman, Hohpe, Crispin, Gregory, Hightower
2025-08-18 11:58:55 +02:00
### `/sc:troubleshoot` - Problem Diagnosis
**Purpose**: Systematic issue diagnosis with root cause analysis
2025-08-21 19:03:25 +02:00
**Syntax**: `/sc:troubleshoot "issue description"` `[--type build|runtime|performance]`
2025-08-18 11:58:55 +02:00
2025-08-21 19:03:25 +02:00
**Use Cases**:
- Runtime errors: `/sc:troubleshoot "500 error on login"`
- Build failures: `/sc:troubleshoot --type build`
- Performance problems: `/sc:troubleshoot "slow page load"`
2025-08-18 11:58:55 +02:00
### `/sc:test` - Quality Assurance
**Purpose**: Comprehensive testing with coverage analysis
2025-08-21 19:03:25 +02:00
**Syntax**: `/sc:test` `[--type unit|integration|e2e] [--coverage] [--fix]`
2025-08-18 11:58:55 +02:00
2025-08-21 19:03:25 +02:00
**Use Cases**:
- Full test suite: `/sc:test --coverage`
- Unit testing: `/sc:test --type unit --watch`
- E2E validation: `/sc:test --type e2e`
2025-08-18 11:58:55 +02:00
### `/sc:improve` - Code Enhancement
**Purpose**: Apply systematic code improvements and optimizations
2025-08-21 19:03:25 +02:00
**Syntax**: `/sc:improve [path]` `[--type performance|quality|security] [--preview]`
2025-08-18 11:58:55 +02:00
2025-08-21 19:03:25 +02:00
**Use Cases**:
- General improvements: `/sc:improve src/`
- Performance optimization: `/sc:improve --type performance`
- Security hardening: `/sc:improve --type security`
2025-08-18 11:58:55 +02:00
### `/sc:document` - Documentation Generation
**Purpose**: Generate comprehensive documentation for code and APIs
2025-08-21 19:03:25 +02:00
**Syntax**: `/sc:document [path]` `[--type api|user-guide|technical] [--format markdown|html]`
2025-08-18 11:58:55 +02:00
2025-08-21 19:03:25 +02:00
**Use Cases**:
- API docs: `/sc:document --type api`
- User guides: `/sc:document --type user-guide`
- Technical docs: `/sc:document --type technical`
2025-08-18 11:58:55 +02:00
### `/sc:workflow` - Implementation Planning
**Purpose**: Generate structured implementation plans from requirements
2025-08-21 19:03:25 +02:00
**Syntax**: `/sc:workflow "feature description"` `[--strategy agile|waterfall] [--format markdown]`
2025-08-18 11:58:55 +02:00
2025-08-21 19:03:25 +02:00
**Use Cases**:
- Feature planning: `/sc:workflow "user authentication"`
- Sprint planning: `/sc:workflow --strategy agile`
- Architecture planning: `/sc:workflow "microservices migration"`
2025-08-18 11:58:55 +02:00
---
## Common Workflows
2025-08-21 19:03:25 +02:00
**Proven command combinations:**
2025-08-18 11:58:55 +02:00
### New Project Setup
```bash
2025-08-21 19:03:25 +02:00
/sc:brainstorm "project concept" # Define requirements
/sc:design "system architecture" # Create technical design
/sc:workflow "implementation plan" # Generate development roadmap
2025-08-18 11:58:55 +02:00
```
### Feature Development
```bash
2025-08-21 19:03:25 +02:00
/sc:implement "feature name" # Build the feature
/sc:test --coverage # Validate with tests
/sc:document --type api # Generate documentation
2025-08-18 11:58:55 +02:00
```
### Code Quality Improvement
```bash
2025-08-21 19:03:25 +02:00
/sc:analyze --focus quality # Assess current state
/sc:improve --preview # Preview improvements
/sc:test --coverage # Validate changes
2025-08-18 11:58:55 +02:00
```
### Bug Investigation
```bash
2025-08-21 19:03:25 +02:00
/sc:troubleshoot "issue description" # Diagnose the problem
/sc:analyze --focus problem-area # Deep analysis
/sc:improve --fix --safe-mode # Apply targeted fixes
2025-08-18 11:58:55 +02:00
```
added spec-panel, which transforms the project specs though the lens … (#346)
Introduces a multi-expert specification review and improvement system
powered by renowned software engineering and specification experts. This
command transforms technical specifications through the lens of industry
experts, providing actionable feedback and systematic improvement
recommendations.
🎯 Key Features
Expert Panel System
- 10 Industry Experts: Karl Wiegers, Gojko Adzic, Alistair Cockburn,
Martin Fowler, Michael Nygard, Sam Newman, Gregor Hohpe, Lisa Crispin,
Janet Gregory, and Kelsey Hightower
- Domain Specialization: Requirements engineering, architecture,
testing,
compliance, and cloud-native patterns
- Authentic Methodologies: Each expert applies their real-world
frameworks and critique styles
Analysis Modes
- Discussion Mode: Collaborative improvement through expert dialogue
- Critique Mode: Systematic review with prioritized recommendations
- Socratic Mode: Learning-focused questioning for deeper understanding
Focus Areas
- Requirements: Clarity, completeness, testability validation
- Architecture: Interface design, scalability, maintainability analysis
- Testing: Quality attributes, coverage, edge case identification
- Compliance: Regulatory requirements, security, operational excellence
🔧 Technical Implementation
Command Structure
/sc:spec-panel [content|@file] [--mode discussion|critique|socratic]
[--focus area] [--iterations N]
MCP Integration
- Sequential MCP: Expert panel coordination and structured analysis
- Context7 MCP: Industry patterns and best practices
- Persona System: Technical Writer, System Architect, Quality Engineer
activation
Quality Metrics
- Clarity Score (0-10): Language precision and understandability
- Completeness Score (0-10): Coverage of essential elements
- Testability Score (0-10): Measurability and validation capability
- Consistency Score (0-10): Internal coherence assessment
📊 Output Examples
Expert Critique Format
KARL WIEGERS - Requirements Engineering:
❌ CRITICAL: Password complexity requirements not specified
📝 RECOMMENDATION: Add requirement "System SHALL enforce password
complexity: minimum 8 characters, mixed case, numbers"
🎯 PRIORITY: High - Security vulnerability without standards
📊 QUALITY IMPACT: +35% security compliance, +20% completeness
Improvement Roadmap
- Immediate: Critical security and clarity issues
- Short-term: Architecture refinements and testing strategies
- Long-term: Evolution planning and advanced optimizations
🚀 Integration Patterns
Workflow
1. Generate specification using
https://github.com/github/spec-kit/blob/main/spec-driven.md
2. Review and improve with expert panel
3. Iterative refinement based on feedback
CI/CD Integration
- Specification validation in development workflow
- Quality gate enforcement with automated checks
- Version control integration for evolution tracking
📈 Quality Impact
Based on an example review:
- Security Completeness: +35% improvement
- Requirements Clarity: +14% improvement
- Testability Score: +19% improvement
- Production Readiness: +47% improvement
- Overall Quality: +24% improvement
🎓 Learning Features
Educational Value
- Socratic questioning mode for skill development
- Expert methodology exposure and learning
- Progressive specification writing guidance
- Best practice pattern recognition
Mentoring Integration
- Step-by-step improvement guidance
- Industry standard alignment
- Professional specification writing techniques
🔗 Files Changed
- SuperClaude/Commands/spec-panel.md - Complete command specification
🧪 Testing
Includes comprehensive examples:
- API specification review with security focus
- Requirements workshop with collaborative analysis
- Architecture validation with socratic questioning
- Multi-iteration improvement workflows
This feature significantly enhances SuperClaude's specification analysis
capabilities, providing professional-grade review and improvement
guidance through authentic expert perspectives and proven methodologies.
2025-09-09 17:01:56 +02:00
### Specification Development
```bash
/sc:spec-panel @existing_spec .yml --mode critique # Expert review
/sc:spec-panel @improved_spec .yml --iterations 2 # Iterative refinement
/sc:document --type technical # Generate documentation
```
2025-08-18 11:58:55 +02:00
## Full Command Reference
### Development Commands
2025-08-21 19:03:25 +02:00
| Command | Purpose | Best For |
|---------|---------|----------|
| **workflow** | Implementation planning | Project roadmaps, sprint planning |
| **implement** | Feature development | Full-stack features, API development |
| **build** | Project compilation | CI/CD, production builds |
| **design** | System architecture | API specs, database schemas |
### Analysis Commands
| Command | Purpose | Best For |
|---------|---------|----------|
| **analyze** | Code assessment | Quality audits, security reviews |
feat: Add comprehensive business panel analysis system (#323)
* feat: Add comprehensive business panel analysis system
Implements /sc:business-panel command with 9 expert personas (Christensen, Porter, Drucker, Godin, Kim/Mauborgne, Collins, Taleb, Meadows, Doumont), three-phase adaptive methodology (Discussion/Debate/Socratic), intelligent mode selection, and cross-framework synthesis with business-specific symbol system.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: sarosh.quraishi@gmail.com
* docs: Update README and commands guide for business panel feature
- Update command count from 21 to 22 across all documentation
- Add Business Panel to behavioral modes (5 → 6 modes)
- Add /sc:business-panel to commands guide with full documentation
- Include expert panel details and usage examples
- Update command index and complexity classification
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: sarosh.quraishi@gmail.com
2025-08-29 14:25:34 +02:00
| **business-panel** | Strategic analysis | Business decisions, competitive assessment |
added spec-panel, which transforms the project specs though the lens … (#346)
Introduces a multi-expert specification review and improvement system
powered by renowned software engineering and specification experts. This
command transforms technical specifications through the lens of industry
experts, providing actionable feedback and systematic improvement
recommendations.
🎯 Key Features
Expert Panel System
- 10 Industry Experts: Karl Wiegers, Gojko Adzic, Alistair Cockburn,
Martin Fowler, Michael Nygard, Sam Newman, Gregor Hohpe, Lisa Crispin,
Janet Gregory, and Kelsey Hightower
- Domain Specialization: Requirements engineering, architecture,
testing,
compliance, and cloud-native patterns
- Authentic Methodologies: Each expert applies their real-world
frameworks and critique styles
Analysis Modes
- Discussion Mode: Collaborative improvement through expert dialogue
- Critique Mode: Systematic review with prioritized recommendations
- Socratic Mode: Learning-focused questioning for deeper understanding
Focus Areas
- Requirements: Clarity, completeness, testability validation
- Architecture: Interface design, scalability, maintainability analysis
- Testing: Quality attributes, coverage, edge case identification
- Compliance: Regulatory requirements, security, operational excellence
🔧 Technical Implementation
Command Structure
/sc:spec-panel [content|@file] [--mode discussion|critique|socratic]
[--focus area] [--iterations N]
MCP Integration
- Sequential MCP: Expert panel coordination and structured analysis
- Context7 MCP: Industry patterns and best practices
- Persona System: Technical Writer, System Architect, Quality Engineer
activation
Quality Metrics
- Clarity Score (0-10): Language precision and understandability
- Completeness Score (0-10): Coverage of essential elements
- Testability Score (0-10): Measurability and validation capability
- Consistency Score (0-10): Internal coherence assessment
📊 Output Examples
Expert Critique Format
KARL WIEGERS - Requirements Engineering:
❌ CRITICAL: Password complexity requirements not specified
📝 RECOMMENDATION: Add requirement "System SHALL enforce password
complexity: minimum 8 characters, mixed case, numbers"
🎯 PRIORITY: High - Security vulnerability without standards
📊 QUALITY IMPACT: +35% security compliance, +20% completeness
Improvement Roadmap
- Immediate: Critical security and clarity issues
- Short-term: Architecture refinements and testing strategies
- Long-term: Evolution planning and advanced optimizations
🚀 Integration Patterns
Workflow
1. Generate specification using
https://github.com/github/spec-kit/blob/main/spec-driven.md
2. Review and improve with expert panel
3. Iterative refinement based on feedback
CI/CD Integration
- Specification validation in development workflow
- Quality gate enforcement with automated checks
- Version control integration for evolution tracking
📈 Quality Impact
Based on an example review:
- Security Completeness: +35% improvement
- Requirements Clarity: +14% improvement
- Testability Score: +19% improvement
- Production Readiness: +47% improvement
- Overall Quality: +24% improvement
🎓 Learning Features
Educational Value
- Socratic questioning mode for skill development
- Expert methodology exposure and learning
- Progressive specification writing guidance
- Best practice pattern recognition
Mentoring Integration
- Step-by-step improvement guidance
- Industry standard alignment
- Professional specification writing techniques
🔗 Files Changed
- SuperClaude/Commands/spec-panel.md - Complete command specification
🧪 Testing
Includes comprehensive examples:
- API specification review with security focus
- Requirements workshop with collaborative analysis
- Architecture validation with socratic questioning
- Multi-iteration improvement workflows
This feature significantly enhances SuperClaude's specification analysis
capabilities, providing professional-grade review and improvement
guidance through authentic expert perspectives and proven methodologies.
2025-09-09 17:01:56 +02:00
| **spec-panel** | Specification review | Requirements validation, architecture analysis |
2025-08-21 19:03:25 +02:00
| **troubleshoot** | Problem diagnosis | Bug investigation, performance issues |
| **explain** | Code explanation | Learning, code reviews |
2025-08-18 11:58:55 +02:00
### Quality Commands
2025-08-21 19:03:25 +02:00
| Command | Purpose | Best For |
|---------|---------|----------|
| **improve** | Code enhancement | Performance optimization, refactoring |
| **cleanup** | Technical debt | Dead code removal, organization |
| **test** | Quality assurance | Test automation, coverage analysis |
| **document** | Documentation | API docs, user guides |
### Project Management
| Command | Purpose | Best For |
|---------|---------|----------|
| **estimate** | Project estimation | Timeline planning, resource allocation |
| **task** | Task management | Complex workflows, task tracking |
| **spawn** | Meta-orchestration | Large-scale projects, parallel execution |
2025-08-18 11:58:55 +02:00
### Utility Commands
2025-08-21 19:03:25 +02:00
| Command | Purpose | Best For |
|---------|---------|----------|
2025-09-15 15:03:33 +00:00
| **help** | List all commands | Discovering available commands |
2025-08-21 19:03:25 +02:00
| **git** | Version control | Commit management, branch strategies |
| **index** | Command discovery | Exploring capabilities, finding commands |
### Session Commands
| Command | Purpose | Best For |
|---------|---------|----------|
| **load** | Context loading | Session initialization, project onboarding |
| **save** | Session persistence | Checkpointing, context preservation |
| **reflect** | Task validation | Progress assessment, completion validation |
| **select-tool** | Tool optimization | Performance optimization, tool selection |
2025-08-18 11:58:55 +02:00
---
## Command Index
2025-08-21 19:03:25 +02:00
**By Function:**
- **Planning**: brainstorm, design, workflow, estimate
- **Development**: implement, build, git
added spec-panel, which transforms the project specs though the lens … (#346)
Introduces a multi-expert specification review and improvement system
powered by renowned software engineering and specification experts. This
command transforms technical specifications through the lens of industry
experts, providing actionable feedback and systematic improvement
recommendations.
🎯 Key Features
Expert Panel System
- 10 Industry Experts: Karl Wiegers, Gojko Adzic, Alistair Cockburn,
Martin Fowler, Michael Nygard, Sam Newman, Gregor Hohpe, Lisa Crispin,
Janet Gregory, and Kelsey Hightower
- Domain Specialization: Requirements engineering, architecture,
testing,
compliance, and cloud-native patterns
- Authentic Methodologies: Each expert applies their real-world
frameworks and critique styles
Analysis Modes
- Discussion Mode: Collaborative improvement through expert dialogue
- Critique Mode: Systematic review with prioritized recommendations
- Socratic Mode: Learning-focused questioning for deeper understanding
Focus Areas
- Requirements: Clarity, completeness, testability validation
- Architecture: Interface design, scalability, maintainability analysis
- Testing: Quality attributes, coverage, edge case identification
- Compliance: Regulatory requirements, security, operational excellence
🔧 Technical Implementation
Command Structure
/sc:spec-panel [content|@file] [--mode discussion|critique|socratic]
[--focus area] [--iterations N]
MCP Integration
- Sequential MCP: Expert panel coordination and structured analysis
- Context7 MCP: Industry patterns and best practices
- Persona System: Technical Writer, System Architect, Quality Engineer
activation
Quality Metrics
- Clarity Score (0-10): Language precision and understandability
- Completeness Score (0-10): Coverage of essential elements
- Testability Score (0-10): Measurability and validation capability
- Consistency Score (0-10): Internal coherence assessment
📊 Output Examples
Expert Critique Format
KARL WIEGERS - Requirements Engineering:
❌ CRITICAL: Password complexity requirements not specified
📝 RECOMMENDATION: Add requirement "System SHALL enforce password
complexity: minimum 8 characters, mixed case, numbers"
🎯 PRIORITY: High - Security vulnerability without standards
📊 QUALITY IMPACT: +35% security compliance, +20% completeness
Improvement Roadmap
- Immediate: Critical security and clarity issues
- Short-term: Architecture refinements and testing strategies
- Long-term: Evolution planning and advanced optimizations
🚀 Integration Patterns
Workflow
1. Generate specification using
https://github.com/github/spec-kit/blob/main/spec-driven.md
2. Review and improve with expert panel
3. Iterative refinement based on feedback
CI/CD Integration
- Specification validation in development workflow
- Quality gate enforcement with automated checks
- Version control integration for evolution tracking
📈 Quality Impact
Based on an example review:
- Security Completeness: +35% improvement
- Requirements Clarity: +14% improvement
- Testability Score: +19% improvement
- Production Readiness: +47% improvement
- Overall Quality: +24% improvement
🎓 Learning Features
Educational Value
- Socratic questioning mode for skill development
- Expert methodology exposure and learning
- Progressive specification writing guidance
- Best practice pattern recognition
Mentoring Integration
- Step-by-step improvement guidance
- Industry standard alignment
- Professional specification writing techniques
🔗 Files Changed
- SuperClaude/Commands/spec-panel.md - Complete command specification
🧪 Testing
Includes comprehensive examples:
- API specification review with security focus
- Requirements workshop with collaborative analysis
- Architecture validation with socratic questioning
- Multi-iteration improvement workflows
This feature significantly enhances SuperClaude's specification analysis
capabilities, providing professional-grade review and improvement
guidance through authentic expert perspectives and proven methodologies.
2025-09-09 17:01:56 +02:00
- **Analysis**: analyze, business-panel, spec-panel, troubleshoot, explain
2025-08-21 19:03:25 +02:00
- **Quality**: improve, cleanup, test, document
- **Management**: task, spawn, load, save, reflect
2025-09-15 15:03:33 +00:00
- **Utility**: help, index, select-tool
2025-08-18 11:58:55 +02:00
2025-08-21 19:03:25 +02:00
**By Complexity:**
2025-09-15 15:03:33 +00:00
- **Beginner**: brainstorm, implement, analyze, test, help
added spec-panel, which transforms the project specs though the lens … (#346)
Introduces a multi-expert specification review and improvement system
powered by renowned software engineering and specification experts. This
command transforms technical specifications through the lens of industry
experts, providing actionable feedback and systematic improvement
recommendations.
🎯 Key Features
Expert Panel System
- 10 Industry Experts: Karl Wiegers, Gojko Adzic, Alistair Cockburn,
Martin Fowler, Michael Nygard, Sam Newman, Gregor Hohpe, Lisa Crispin,
Janet Gregory, and Kelsey Hightower
- Domain Specialization: Requirements engineering, architecture,
testing,
compliance, and cloud-native patterns
- Authentic Methodologies: Each expert applies their real-world
frameworks and critique styles
Analysis Modes
- Discussion Mode: Collaborative improvement through expert dialogue
- Critique Mode: Systematic review with prioritized recommendations
- Socratic Mode: Learning-focused questioning for deeper understanding
Focus Areas
- Requirements: Clarity, completeness, testability validation
- Architecture: Interface design, scalability, maintainability analysis
- Testing: Quality attributes, coverage, edge case identification
- Compliance: Regulatory requirements, security, operational excellence
🔧 Technical Implementation
Command Structure
/sc:spec-panel [content|@file] [--mode discussion|critique|socratic]
[--focus area] [--iterations N]
MCP Integration
- Sequential MCP: Expert panel coordination and structured analysis
- Context7 MCP: Industry patterns and best practices
- Persona System: Technical Writer, System Architect, Quality Engineer
activation
Quality Metrics
- Clarity Score (0-10): Language precision and understandability
- Completeness Score (0-10): Coverage of essential elements
- Testability Score (0-10): Measurability and validation capability
- Consistency Score (0-10): Internal coherence assessment
📊 Output Examples
Expert Critique Format
KARL WIEGERS - Requirements Engineering:
❌ CRITICAL: Password complexity requirements not specified
📝 RECOMMENDATION: Add requirement "System SHALL enforce password
complexity: minimum 8 characters, mixed case, numbers"
🎯 PRIORITY: High - Security vulnerability without standards
📊 QUALITY IMPACT: +35% security compliance, +20% completeness
Improvement Roadmap
- Immediate: Critical security and clarity issues
- Short-term: Architecture refinements and testing strategies
- Long-term: Evolution planning and advanced optimizations
🚀 Integration Patterns
Workflow
1. Generate specification using
https://github.com/github/spec-kit/blob/main/spec-driven.md
2. Review and improve with expert panel
3. Iterative refinement based on feedback
CI/CD Integration
- Specification validation in development workflow
- Quality gate enforcement with automated checks
- Version control integration for evolution tracking
📈 Quality Impact
Based on an example review:
- Security Completeness: +35% improvement
- Requirements Clarity: +14% improvement
- Testability Score: +19% improvement
- Production Readiness: +47% improvement
- Overall Quality: +24% improvement
🎓 Learning Features
Educational Value
- Socratic questioning mode for skill development
- Expert methodology exposure and learning
- Progressive specification writing guidance
- Best practice pattern recognition
Mentoring Integration
- Step-by-step improvement guidance
- Industry standard alignment
- Professional specification writing techniques
🔗 Files Changed
- SuperClaude/Commands/spec-panel.md - Complete command specification
🧪 Testing
Includes comprehensive examples:
- API specification review with security focus
- Requirements workshop with collaborative analysis
- Architecture validation with socratic questioning
- Multi-iteration improvement workflows
This feature significantly enhances SuperClaude's specification analysis
capabilities, providing professional-grade review and improvement
guidance through authentic expert perspectives and proven methodologies.
2025-09-09 17:01:56 +02:00
- **Intermediate**: workflow, design, business-panel, spec-panel, improve, document
2025-08-21 19:03:25 +02:00
- **Advanced**: spawn, task, select-tool, reflect
2025-08-18 11:58:55 +02:00
## Troubleshooting
2025-08-21 19:03:25 +02:00
**Command Issues:**
- **Command not found**: Verify installation: `python3 -m SuperClaude --version`
- **No response**: Restart Claude Code session
2025-08-22 19:18:44 +02:00
- **Processing delays**: Use `--no-mcp` to test without MCP servers
2025-08-18 11:58:55 +02:00
2025-08-21 19:03:25 +02:00
**Quick Fixes:**
- Reset session: `/sc:load` to reinitialize
- Check status: `SuperClaude install --list-components`
- Get help: [Troubleshooting Guide ](../Reference/troubleshooting.md )
2025-08-18 11:58:55 +02:00
2025-08-21 19:03:25 +02:00
## Next Steps
2025-08-18 11:58:55 +02:00
2025-08-21 19:03:25 +02:00
- [Flags Guide ](flags.md ) - Control command behavior
- [Agents Guide ](agents.md ) - Specialist activation
- [Examples Cookbook ](../Reference/examples-cookbook.md ) - Real usage patterns
