2025-08-22 23:05:55 +02:00
< div align = "center" >
# 🚀 SuperClaude Framework
### **Transform Claude Code into a Structured Development Platform**
< p align = "center" >
2025-09-13 17:44:35 +05:30
< a href = "https://github.com/hesreallyhim/awesome-claude-code/" >
< img src = "https://awesome.re/mentioned-badge-flat.svg" alt = "Mentioned in Awesome Claude Code" >
< / a >
2025-09-17 18:45:04 +05:30
< a href = "https://github.com/SuperClaude-Org/SuperGemini_Framework" target = "_blank" >
2025-09-17 18:44:28 +05:30
< img src = "https://img.shields.io/badge/Try-SuperGemini_Framework-blue" alt = "Try SuperGemini Framework" / >
< / a >
< a href = "https://github.com/SuperClaude-Org/SuperQwen_Framework" target = "_blank" >
< img src = "https://img.shields.io/badge/Try-SuperQwen_Framework-orange" alt = "Try SuperQwen Framework" / >
< / a >
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
< img src = "https://img.shields.io/badge/version-4.1.4-blue" alt = "Version" >
2025-08-24 11:58:56 +05:30
< img src = "https://img.shields.io/badge/License-MIT-yellow.svg" alt = "License" >
< img src = "https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt = "PRs Welcome" >
2025-08-22 23:05:55 +02:00
< / p >
< p align = "center" >
2025-08-23 20:13:03 +02:00
< a href = "https://superclaude.netlify.app/" >
2025-08-24 11:58:56 +05:30
< img src = "https://img.shields.io/badge/🌐_Visit_Website-blue" alt = "Website" >
2025-08-22 23:05:55 +02:00
< / a >
< a href = "https://pypi.org/project/SuperClaude/" >
2025-08-24 11:58:56 +05:30
< img src = "https://img.shields.io/pypi/v/SuperClaude.svg?" alt = "PyPI" >
2025-08-22 23:05:55 +02:00
< / a >
< a href = "https://www.npmjs.com/package/ @bifrost_inc/superclaude " >
2025-08-24 11:58:56 +05:30
< img src = "https://img.shields.io/npm/v/ @bifrost_inc/superclaude .svg" alt = "npm" >
2025-08-22 23:05:55 +02:00
< / a >
< / p >
2025-08-28 16:24:29 +09:00
< p align = "center" >
< a href = "README.md" >
< img src = "https://img.shields.io/badge/🇺🇸_English-blue" alt = "English" >
< / a >
< a href = "README-zh.md" >
< img src = "https://img.shields.io/badge/🇨🇳_中文-red" alt = "中文" >
< / a >
< a href = "README-ja.md" >
< img src = "https://img.shields.io/badge/🇯🇵_日本語-green" alt = "日本語" >
< / a >
< / p >
2025-08-22 23:05:55 +02:00
< p align = "center" >
< a href = "#-quick-installation" > Quick Start< / a > •
< a href = "#-support-the-project" > Support< / a > •
< a href = "#-whats-new-in-v4" > Features< / a > •
< a href = "#-documentation" > Docs< / a > •
< a href = "#-contributing" > Contributing< / a >
< / p >
< / div >
2025-07-14 14:28:11 +02:00
2025-08-22 23:05:55 +02:00
---
2025-08-22 20:39:46 +02:00
2025-08-22 23:05:55 +02:00
< div align = "center" >
2025-07-16 17:38:57 +10:00
2025-08-22 23:05:55 +02:00
## 📊 **Framework Statistics**
| **Commands** | **Agents** | **Modes** | **MCP Servers** |
|:------------:|:----------:|:---------:|:---------------:|
2025-09-15 15:03:33 +00:00
| **24** | **14** | **6** | **6** |
2025-08-22 23:05:55 +02:00
| Slash Commands | Specialized AI | Behavioral | Integrations |
2025-09-15 15:03:33 +00:00
Use the new `/sc:help` command to see a full list of all available commands.
2025-08-22 23:05:55 +02:00
< / div >
---
2025-08-23 12:09:10 +02:00
< div align = "center" >
2025-08-22 23:05:55 +02:00
## 🎯 **Overview**
SuperClaude is a **meta-programming configuration framework** that transforms Claude Code into a structured development platform through behavioral instruction injection and component orchestration. It provides systematic workflow automation with powerful tools and intelligent agents.
2025-08-22 21:12:24 +02:00
2025-09-16 18:29:38 +05:30
## Disclaimer
This project is not affiliated with or endorsed by Anthropic.
Claude Code is a product built and maintained by [Anthropic ](https://www.anthropic.com/ ).
2025-08-22 23:16:40 +02:00
## ⚡ **Quick Installation**
2025-08-22 23:05:55 +02:00
### **Choose Your Installation Method**
| Method | Command | Best For |
|:------:|---------|----------|
2025-08-23 15:58:21 +02:00
| ** 🐍 pipx** | `pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install` | ** ✅ Recommended** - Linux/macOS |
| ** 📦 pip** | `pip install SuperClaude && pip upgrade SuperClaude && SuperClaude install` | Traditional Python environments |
| ** 🌐 npm** | `npm install -g @bifrost_inc/superclaude && superclaude install` | Cross-platform, Node.js users |
2025-08-22 23:05:55 +02:00
< / div >
2025-08-23 12:09:56 +02:00
< details >
Fix component validation and bump version to 4.0.6 (#292)
* ✨ Enhance documentation with advanced markdown formatting
Major improvements to documentation presentation and usability:
README.md:
- Added centered hero section with framework statistics dashboard
- Created visual support section with donation cards
- Enhanced What's New section with feature grid layout
- Reorganized documentation links into categorized table
- Added professional badges and visual separators
installation.md:
- Centered title with platform badges and quick navigation
- Consolidated 4 installation methods into unified table
- Created visual requirement cards (Required vs Optional)
- Added collapsible troubleshooting sections
- Removed 3 duplicate "What's Next" sections
- Enhanced learning journey with progression tables
quick-start.md:
- Added visual framework architecture flow diagram
- Created component statistics dashboard (21|14|6|6)
- Built comparison table for SuperClaude vs Standard Claude
- Added 4-week learning timeline with milestones
- Enhanced workflow patterns with step-by-step tables
- Created key insights cards explaining framework philosophy
All documents now feature consistent styling with centered titles,
organized tables, emojis for visual scanning, and improved navigation.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* 🔥 Remove outdated publishing and release instruction files
Cleaned up repository by removing:
- PUBLISHING.md: Outdated publishing guidelines
- RELEASE_INSTRUCTIONS.md: Old release process documentation
These files are no longer needed as the project has evolved
and the processes have been streamlined or moved elsewhere.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* 🐛 Fix component validation to check metadata file instead of settings.json
Resolves #291 - Validation errors after V4 upgrade
## Changes
- Fixed validation logic to check .superclaude-metadata.json instead of settings.json
- Standardized all component versions to 4.0.4 across the framework
- Fixed agent validation to check for correct filenames (architect vs specialist/engineer)
- Cleaned up metadata file structure for consistency
## Technical Details
The issue was caused by components registering in .superclaude-metadata.json but
validation checking settings.json for component registration. This mismatch caused
false validation errors even though components were properly installed.
## Testing
All components now validate successfully with the corrected logic.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* 🔖 Bump version to 4.0.6 across entire project
## Summary
Comprehensive version update from 4.0.4 to 4.0.6 with validation fixes
## Changes
- Updated VERSION file, pyproject.toml, and package.json
- Updated all Python __version__ declarations (8 occurrences)
- Updated all component metadata versions (6 components, 25+ occurrences)
- Updated documentation and README version badges (11 files)
- Fixed package.json inconsistency (was 4.0.5)
- Updated legacy backup.py version reference (was 3.0.0)
- Added CHANGELOG entry for version 4.0.6
## Files Modified (26 total)
- Core: VERSION, pyproject.toml, package.json
- Python: SuperClaude/__init__.py, __main__.py, setup/__init__.py, cli/base.py
- Components: core.py, commands.py, agents.py, mcp.py, mcp_docs.py, modes.py
- Docs: README.md, CONTRIBUTING.md, SECURITY.md, installation.md, quick-start.md
- Config: features.json, backup.py, update.py
- User: ~/.claude/.superclaude-metadata.json
## Verification
All version references now consistently show 4.0.6
Historical references in CHANGELOG preserved as intended
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* 📝 Update README.md installation instructions
---------
Signed-off-by: NomenAK <39598727+NomenAK@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
2025-08-23 12:08:09 +02:00
< summary > < b > ⚠️ IMPORTANT: Upgrading from SuperClaude V3< / b > < / summary >
**If you have SuperClaude V3 installed, you SHOULD uninstall it before installing V4:**
```bash
# Uninstall V3 first
Remove all related files and directories :
*.md *.json and commands/
# Then install V4
2025-08-23 12:37:58 +02:00
pipx install SuperClaude & & pipx upgrade SuperClaude & & SuperClaude install
Fix component validation and bump version to 4.0.6 (#292)
* ✨ Enhance documentation with advanced markdown formatting
Major improvements to documentation presentation and usability:
README.md:
- Added centered hero section with framework statistics dashboard
- Created visual support section with donation cards
- Enhanced What's New section with feature grid layout
- Reorganized documentation links into categorized table
- Added professional badges and visual separators
installation.md:
- Centered title with platform badges and quick navigation
- Consolidated 4 installation methods into unified table
- Created visual requirement cards (Required vs Optional)
- Added collapsible troubleshooting sections
- Removed 3 duplicate "What's Next" sections
- Enhanced learning journey with progression tables
quick-start.md:
- Added visual framework architecture flow diagram
- Created component statistics dashboard (21|14|6|6)
- Built comparison table for SuperClaude vs Standard Claude
- Added 4-week learning timeline with milestones
- Enhanced workflow patterns with step-by-step tables
- Created key insights cards explaining framework philosophy
All documents now feature consistent styling with centered titles,
organized tables, emojis for visual scanning, and improved navigation.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* 🔥 Remove outdated publishing and release instruction files
Cleaned up repository by removing:
- PUBLISHING.md: Outdated publishing guidelines
- RELEASE_INSTRUCTIONS.md: Old release process documentation
These files are no longer needed as the project has evolved
and the processes have been streamlined or moved elsewhere.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* 🐛 Fix component validation to check metadata file instead of settings.json
Resolves #291 - Validation errors after V4 upgrade
## Changes
- Fixed validation logic to check .superclaude-metadata.json instead of settings.json
- Standardized all component versions to 4.0.4 across the framework
- Fixed agent validation to check for correct filenames (architect vs specialist/engineer)
- Cleaned up metadata file structure for consistency
## Technical Details
The issue was caused by components registering in .superclaude-metadata.json but
validation checking settings.json for component registration. This mismatch caused
false validation errors even though components were properly installed.
## Testing
All components now validate successfully with the corrected logic.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* 🔖 Bump version to 4.0.6 across entire project
## Summary
Comprehensive version update from 4.0.4 to 4.0.6 with validation fixes
## Changes
- Updated VERSION file, pyproject.toml, and package.json
- Updated all Python __version__ declarations (8 occurrences)
- Updated all component metadata versions (6 components, 25+ occurrences)
- Updated documentation and README version badges (11 files)
- Fixed package.json inconsistency (was 4.0.5)
- Updated legacy backup.py version reference (was 3.0.0)
- Added CHANGELOG entry for version 4.0.6
## Files Modified (26 total)
- Core: VERSION, pyproject.toml, package.json
- Python: SuperClaude/__init__.py, __main__.py, setup/__init__.py, cli/base.py
- Components: core.py, commands.py, agents.py, mcp.py, mcp_docs.py, modes.py
- Docs: README.md, CONTRIBUTING.md, SECURITY.md, installation.md, quick-start.md
- Config: features.json, backup.py, update.py
- User: ~/.claude/.superclaude-metadata.json
## Verification
All version references now consistently show 4.0.6
Historical references in CHANGELOG preserved as intended
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* 📝 Update README.md installation instructions
---------
Signed-off-by: NomenAK <39598727+NomenAK@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
2025-08-23 12:08:09 +02:00
```
**✅ What gets preserved during upgrade:**
- ✓ Your custom slash commands (outside `commands/sc/` )
- ✓ Your custom content in `CLAUDE.md`
2025-08-23 12:25:56 +02:00
- ✓ Claude Code's `.claude.json` , `.credentials.json` , `settings.json` and `settings.local.json`
Fix component validation and bump version to 4.0.6 (#292)
* ✨ Enhance documentation with advanced markdown formatting
Major improvements to documentation presentation and usability:
README.md:
- Added centered hero section with framework statistics dashboard
- Created visual support section with donation cards
- Enhanced What's New section with feature grid layout
- Reorganized documentation links into categorized table
- Added professional badges and visual separators
installation.md:
- Centered title with platform badges and quick navigation
- Consolidated 4 installation methods into unified table
- Created visual requirement cards (Required vs Optional)
- Added collapsible troubleshooting sections
- Removed 3 duplicate "What's Next" sections
- Enhanced learning journey with progression tables
quick-start.md:
- Added visual framework architecture flow diagram
- Created component statistics dashboard (21|14|6|6)
- Built comparison table for SuperClaude vs Standard Claude
- Added 4-week learning timeline with milestones
- Enhanced workflow patterns with step-by-step tables
- Created key insights cards explaining framework philosophy
All documents now feature consistent styling with centered titles,
organized tables, emojis for visual scanning, and improved navigation.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* 🔥 Remove outdated publishing and release instruction files
Cleaned up repository by removing:
- PUBLISHING.md: Outdated publishing guidelines
- RELEASE_INSTRUCTIONS.md: Old release process documentation
These files are no longer needed as the project has evolved
and the processes have been streamlined or moved elsewhere.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* 🐛 Fix component validation to check metadata file instead of settings.json
Resolves #291 - Validation errors after V4 upgrade
## Changes
- Fixed validation logic to check .superclaude-metadata.json instead of settings.json
- Standardized all component versions to 4.0.4 across the framework
- Fixed agent validation to check for correct filenames (architect vs specialist/engineer)
- Cleaned up metadata file structure for consistency
## Technical Details
The issue was caused by components registering in .superclaude-metadata.json but
validation checking settings.json for component registration. This mismatch caused
false validation errors even though components were properly installed.
## Testing
All components now validate successfully with the corrected logic.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* 🔖 Bump version to 4.0.6 across entire project
## Summary
Comprehensive version update from 4.0.4 to 4.0.6 with validation fixes
## Changes
- Updated VERSION file, pyproject.toml, and package.json
- Updated all Python __version__ declarations (8 occurrences)
- Updated all component metadata versions (6 components, 25+ occurrences)
- Updated documentation and README version badges (11 files)
- Fixed package.json inconsistency (was 4.0.5)
- Updated legacy backup.py version reference (was 3.0.0)
- Added CHANGELOG entry for version 4.0.6
## Files Modified (26 total)
- Core: VERSION, pyproject.toml, package.json
- Python: SuperClaude/__init__.py, __main__.py, setup/__init__.py, cli/base.py
- Components: core.py, commands.py, agents.py, mcp.py, mcp_docs.py, modes.py
- Docs: README.md, CONTRIBUTING.md, SECURITY.md, installation.md, quick-start.md
- Config: features.json, backup.py, update.py
- User: ~/.claude/.superclaude-metadata.json
## Verification
All version references now consistently show 4.0.6
Historical references in CHANGELOG preserved as intended
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* 📝 Update README.md installation instructions
---------
Signed-off-by: NomenAK <39598727+NomenAK@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
2025-08-23 12:08:09 +02:00
- ✓ Any custom agents and files you've added
**⚠️ Note:** Other SuperClaude-related `.json` files from V3 may cause conflicts and should be removed.
< / details >
2025-08-22 23:05:55 +02:00
< details >
< summary > < b > 💡 Troubleshooting PEP 668 Errors< / b > < / summary >
```bash
# Option 1: Use pipx (Recommended)
pipx install SuperClaude
# Option 2: User installation
pip install --user SuperClaude
# Option 3: Force installation (use with caution)
pip install --break-system-packages SuperClaude
2025-07-17 11:39:18 +05:30
```
2025-08-22 23:05:55 +02:00
< / details >
2025-07-14 14:28:11 +02:00
2025-08-22 23:05:55 +02:00
---
2025-08-22 20:39:46 +02:00
2025-08-22 23:05:55 +02:00
< div align = "center" >
2025-08-22 20:39:46 +02:00
2025-08-22 23:05:55 +02:00
## 💖 **Support the Project**
2025-08-22 20:39:46 +02:00
2025-08-23 11:31:46 +02:00
> Hey, let's be real - maintaining SuperClaude takes time and resources.
2025-08-22 23:11:05 +02:00
>
2025-08-23 11:31:46 +02:00
> *The Claude Max subscription alone runs $100/month for testing, and that's before counting the hours spent on documentation, bug fixes, and feature development.*
> *If you're finding value in SuperClaude for your daily work, consider supporting the project.*
> *Even a few dollars helps cover the basics and keeps development active.*
2025-08-22 23:11:05 +02:00
>
2025-08-23 11:31:46 +02:00
> Every contributor matters, whether through code, feedback, or support. Thanks for being part of this community! 🙏
2025-08-22 23:05:55 +02:00
< table >
< tr >
< td align = "center" width = "33%" >
### ☕ **Ko-fi**
2025-08-24 11:58:56 +05:30
[](https://ko-fi.com/superclaude)
2025-08-22 23:05:55 +02:00
*One-time contributions*
< / td >
< td align = "center" width = "33%" >
### 🎯 **Patreon**
2025-08-24 11:58:56 +05:30
[](https://patreon.com/superclaude)
2025-08-22 23:05:55 +02:00
*Monthly support*
< / td >
< td align = "center" width = "33%" >
### 💜 **GitHub**
2025-08-24 11:58:56 +05:30
[](https://github.com/sponsors/SuperClaude-Org)
2025-08-22 20:39:46 +02:00
2025-08-22 23:05:55 +02:00
*Flexible tiers*
< / td >
< / tr >
< / table >
2025-07-14 14:28:11 +02:00
2025-08-22 23:05:55 +02:00
### **Your Support Enables:**
2025-07-14 14:28:11 +02:00
2025-08-22 23:05:55 +02:00
| Item | Cost/Impact |
|------|-------------|
| 🔬 **Claude Max Testing** | $100/month for validation & testing |
| ⚡ **Feature Development** | New capabilities & improvements |
| 📚 **Documentation** | Comprehensive guides & examples |
| 🤝 **Community Support** | Quick issue responses & help |
| 🔧 **MCP Integration** | Testing new server connections |
| 🌐 **Infrastructure** | Hosting & deployment costs |
2025-08-22 23:10:23 +02:00
> **Note:** No pressure though - the framework stays open source regardless. Just knowing people use and appreciate it is motivating. Contributing code, documentation, or spreading the word helps too! 🙏
2025-08-22 23:05:55 +02:00
< / div >
---
< div align = "center" >
2025-08-22 23:16:40 +02:00
## 🎉 **What's New in V4**
2025-08-22 23:05:55 +02:00
2025-08-22 23:16:40 +02:00
> *Version 4 brings significant improvements based on community feedback and real-world usage patterns.*
2025-08-22 23:05:55 +02:00
< table >
< tr >
< td width = "50%" >
### 🤖 **Smarter Agent System**
**14 specialized agents** with domain expertise:
- Security engineer catches real vulnerabilities
- Frontend architect understands UI patterns
- Automatic coordination based on context
- Domain-specific expertise on demand
< / td >
< td width = "50%" >
### 📝 **Improved Namespace**
**`/sc:` prefix** for all commands:
- No conflicts with custom commands
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
- 23 commands covering full lifecycle
2025-08-22 23:05:55 +02:00
- From brainstorming to deployment
- Clean, organized command structure
< / td >
< / tr >
< tr >
< td width = "50%" >
### 🔧 **MCP Server Integration**
**6 powerful servers** working together:
- **Context7** → Up-to-date documentation
- **Sequential** → Complex analysis
- **Magic** → UI component generation
- **Playwright** → Browser testing
- **Morphllm** → Bulk transformations
- **Serena** → Session persistence
< / td >
< td width = "50%" >
### 🎯 **Behavioral Modes**
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
**6 adaptive modes** for different contexts:
2025-08-22 23:05:55 +02:00
- **Brainstorming** → Asks right questions
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** → Multi-expert strategic analysis
2025-08-22 23:05:55 +02:00
- **Orchestration** → Efficient tool coordination
- **Token-Efficiency** → 30-50% context savings
- **Task Management** → Systematic organization
- **Introspection** → Meta-cognitive analysis
< / td >
< / tr >
< tr >
< td width = "50%" >
### ⚡ **Optimized Performance**
**Smaller framework, bigger projects:**
- Reduced framework footprint
- More context for your code
- Longer conversations possible
- Complex operations enabled
< / td >
< td width = "50%" >
### 📚 **Documentation Overhaul**
**Complete rewrite** for developers:
- Real examples & use cases
- Common pitfalls documented
- Practical workflows included
- Better navigation structure
< / td >
< / tr >
< / table >
2025-08-22 23:16:40 +02:00
< / div >
2025-07-14 14:28:11 +02:00
2025-08-22 23:16:40 +02:00
---
2025-08-22 20:49:39 +02:00
2025-08-22 23:05:55 +02:00
< div align = "center" >
2025-08-22 20:49:39 +02:00
2025-08-22 23:16:40 +02:00
## 📚 **Documentation**
2025-08-22 23:05:55 +02:00
### **Complete Guide to SuperClaude**
2025-08-22 20:49:39 +02:00
2025-08-22 23:05:55 +02:00
< table >
< tr >
< th align = "center" > 🚀 Getting Started< / th >
< th align = "center" > 📖 User Guides< / th >
< th align = "center" > 🛠️ Developer Resources< / th >
< th align = "center" > 📋 Reference< / th >
< / tr >
< tr >
< td valign = "top" >
2025-08-22 20:49:39 +02:00
2025-08-22 23:05:55 +02:00
- 📝 [**Quick Start Guide** ](Docs/Getting-Started/quick-start.md )
*Get up and running fast*
2025-08-22 20:49:39 +02:00
2025-08-22 23:05:55 +02:00
- 💾 [**Installation Guide** ](Docs/Getting-Started/installation.md )
*Detailed setup instructions*
2025-08-22 20:49:39 +02:00
2025-08-22 23:05:55 +02:00
< / td >
< td valign = "top" >
2025-08-22 20:49:39 +02:00
2025-08-22 23:05:55 +02:00
- 🎯 [**Commands Reference** ](Docs/User-Guide/commands.md )
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
*All 23 slash commands*
2025-08-22 20:49:39 +02:00
2025-08-22 23:05:55 +02:00
- 🤖 [**Agents Guide** ](Docs/User-Guide/agents.md )
*14 specialized agents*
2025-08-22 21:23:35 +02:00
2025-08-22 23:05:55 +02:00
- 🎨 [**Behavioral Modes** ](Docs/User-Guide/modes.md )
2025-08-23 23:20:25 +02:00
*5 adaptive modes*
2025-07-14 14:28:11 +02:00
2025-08-22 23:05:55 +02:00
- 🚩 [**Flags Guide** ](Docs/User-Guide/flags.md )
*Control behaviors*
2025-07-14 14:28:11 +02:00
2025-08-22 23:05:55 +02:00
- 🔧 [**MCP Servers** ](Docs/User-Guide/mcp-servers.md )
*6 server integrations*
docs: Comprehensive documentation update for SuperClaude V4 Beta
Updated all root documentation to reflect V4 Beta capabilities:
Root Documentation:
- VERSION: Updated to 4.0.0-beta.1
- README.md: Complete rewrite with V4 features (21 commands, 13 agents, 6 MCP servers)
- ARCHITECTURE_OVERVIEW.md: Updated for V4 Beta with correct counts and new features
- CHANGELOG.md: Added comprehensive V4.0.0-beta.1 release section
- ROADMAP.md: Added V4 Beta current status and updated future vision
- CONTRIBUTING.md: Updated architecture, testing, and contribution guidelines
- SECURITY.md: Added V4 security features and version support table
- MANIFEST.in: Updated to include new V4 directories
- pyproject.toml: Updated URLs and description for V4 Beta
User Documentation:
- commands-guide.md: Updated to 21 commands with new V4 commands
- superclaude-user-guide.md: Comprehensive V4 Beta features documentation
- flags-guide.md: Updated with new V4 flags and agent system
- installation-guide.md: V4 Beta installation including hooks system
- agents-guide.md: NEW - Complete guide for 13 specialized agents
- personas-guide.md: Renamed to personas-guide-v3-legacy.md
Key V4 Beta Features Documented:
- 21 specialized commands (added: brainstorm, reflect, save, select-tool)
- 13 domain expert agents replacing persona system
- 6 MCP servers (added Morphllm and Serena)
- 4 Behavioral Modes (Brainstorming, Introspection, Task Management, Token Efficiency)
- Session Lifecycle with cross-session persistence
- Redesigned Hooks System with Python integration
- SuperClaude-Lite minimal implementation
- Comprehensive Templates system
All documentation maintains friendly, accessible tone while accurately reflecting V4 Beta's advanced capabilities.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-05 14:44:37 +02:00
2025-08-22 23:05:55 +02:00
- 💼 [**Session Management** ](Docs/User-Guide/session-management.md )
*Save & restore state*
2025-07-14 14:28:11 +02:00
2025-08-22 23:05:55 +02:00
< / td >
< td valign = "top" >
docs: Comprehensive documentation update for SuperClaude V4 Beta
Updated all root documentation to reflect V4 Beta capabilities:
Root Documentation:
- VERSION: Updated to 4.0.0-beta.1
- README.md: Complete rewrite with V4 features (21 commands, 13 agents, 6 MCP servers)
- ARCHITECTURE_OVERVIEW.md: Updated for V4 Beta with correct counts and new features
- CHANGELOG.md: Added comprehensive V4.0.0-beta.1 release section
- ROADMAP.md: Added V4 Beta current status and updated future vision
- CONTRIBUTING.md: Updated architecture, testing, and contribution guidelines
- SECURITY.md: Added V4 security features and version support table
- MANIFEST.in: Updated to include new V4 directories
- pyproject.toml: Updated URLs and description for V4 Beta
User Documentation:
- commands-guide.md: Updated to 21 commands with new V4 commands
- superclaude-user-guide.md: Comprehensive V4 Beta features documentation
- flags-guide.md: Updated with new V4 flags and agent system
- installation-guide.md: V4 Beta installation including hooks system
- agents-guide.md: NEW - Complete guide for 13 specialized agents
- personas-guide.md: Renamed to personas-guide-v3-legacy.md
Key V4 Beta Features Documented:
- 21 specialized commands (added: brainstorm, reflect, save, select-tool)
- 13 domain expert agents replacing persona system
- 6 MCP servers (added Morphllm and Serena)
- 4 Behavioral Modes (Brainstorming, Introspection, Task Management, Token Efficiency)
- Session Lifecycle with cross-session persistence
- Redesigned Hooks System with Python integration
- SuperClaude-Lite minimal implementation
- Comprehensive Templates system
All documentation maintains friendly, accessible tone while accurately reflecting V4 Beta's advanced capabilities.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-05 14:44:37 +02:00
2025-08-22 23:05:55 +02:00
- 🏗️ [**Technical Architecture** ](Docs/Developer-Guide/technical-architecture.md )
*System design details*
2025-07-14 14:28:11 +02:00
2025-08-22 23:05:55 +02:00
- 💻 [**Contributing Code** ](Docs/Developer-Guide/contributing-code.md )
*Development workflow*
2025-07-14 14:28:11 +02:00
2025-08-22 23:05:55 +02:00
- 🧪 [**Testing & Debugging** ](Docs/Developer-Guide/testing-debugging.md )
*Quality assurance*
2025-07-14 14:28:11 +02:00
2025-08-22 23:05:55 +02:00
< / td >
< td valign = "top" >
- 📓 [**Examples Cookbook** ](Docs/Reference/examples-cookbook.md )
*Real-world recipes*
2025-08-22 20:49:39 +02:00
2025-08-22 23:05:55 +02:00
- 🔍 [**Troubleshooting** ](Docs/Reference/troubleshooting.md )
*Common issues & fixes*
< / td >
< / tr >
< / table >
< / div >
---
< div align = "center" >
2025-08-22 23:16:40 +02:00
## 🤝 **Contributing**
2025-08-22 23:05:55 +02:00
### **Join the SuperClaude Community**
We welcome contributions of all kinds! Here's how you can help:
| Priority | Area | Description |
|:--------:|------|-------------|
| 📝 **High** | Documentation | Improve guides, add examples, fix typos |
| 🔧 **High** | MCP Integration | Add server configs, test integrations |
| 🎯 **Medium** | Workflows | Create command patterns & recipes |
| 🧪 **Medium** | Testing | Add tests, validate features |
| 🌐 **Low** | i18n | Translate docs to other languages |
< p align = "center" >
< a href = "CONTRIBUTING.md" >
2025-08-24 11:58:56 +05:30
< img src = "https://img.shields.io/badge/📖_Read-Contributing_Guide-blue" alt = "Contributing Guide" >
2025-08-22 23:05:55 +02:00
< / a >
< a href = "https://github.com/SuperClaude-Org/SuperClaude_Framework/graphs/contributors" >
2025-08-24 11:58:56 +05:30
< img src = "https://img.shields.io/badge/👥_View-All_Contributors-green" alt = "Contributors" >
2025-08-22 23:05:55 +02:00
< / a >
< / p >
< / div >
---
< div align = "center" >
2025-08-22 23:16:40 +02:00
## ⚖️ **License**
2025-08-22 23:05:55 +02:00
This project is licensed under the **MIT License** - see the [LICENSE ](LICENSE ) file for details.
< p align = "center" >
2025-08-24 11:58:56 +05:30
< img src = "https://img.shields.io/badge/License-MIT-yellow.svg?" alt = "MIT License" >
2025-08-22 23:05:55 +02:00
< / p >
< / div >
---
< div align = "center" >
2025-08-22 20:49:39 +02:00
2025-08-22 23:16:40 +02:00
## ⭐ **Star History**
2025-08-23 23:18:56 +02:00
< a href = "https://www.star-history.com/ #SuperClaude -Org/SuperClaude_Framework&Timeline" >
< picture >
< source media = "(prefers-color-scheme: dark)" srcset = "https://api.star-history.com/svg?repos=SuperClaude-Org/SuperClaude_Framework&type=Timeline&theme=dark" / >
< source media = "(prefers-color-scheme: light)" srcset = "https://api.star-history.com/svg?repos=SuperClaude-Org/SuperClaude_Framework&type=Timeline" / >
< img alt = "Star History Chart" src = "https://api.star-history.com/svg?repos=SuperClaude-Org/SuperClaude_Framework&type=Timeline" / >
< / picture >
2025-08-22 20:49:39 +02:00
< / a >
2025-08-22 23:05:55 +02:00
< / div >
2025-08-22 22:40:28 +02:00
---
2025-08-22 23:05:55 +02:00
< div align = "center" >
### **🚀 Built with passion by the SuperClaude community**
< p align = "center" >
< sub > Made with ❤️ for developers who push boundaries< / sub >
< / p >
< p align = "center" >
< a href = "#-superclaude-framework" > Back to Top ↑< / a >
< / p >
< / div >
