2025-08-22 23:05:55 +02:00
< div align = "center" >
# 🚀 SuperClaude Framework
### **Transform Claude Code into a Structured Development Platform**
< p align = "center" >
Fixed Some Bugs (#355)
* 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: Jules <jules-ai-assistant@users.noreply.github.com>
---------
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
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>
2025-09-13 17:28:52 +05:30
< img src = "https://img.shields.io/badge/version-4.1.0-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** |
|:------------:|:----------:|:---------:|:---------------:|
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** | **14** | **6** | **6** |
2025-08-22 23:05:55 +02:00
| Slash Commands | Specialized AI | Behavioral | Integrations |
< / 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-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 >
