2025-07-14 18:34:01 +02:00
|
|
|
# Changelog
|
|
|
|
|
|
|
|
|
|
All notable changes to SuperClaude will be documented in this file.
|
|
|
|
|
|
|
|
|
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
|
|
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
|
|
|
|
|
|
|
|
## [Unreleased]
|
|
|
|
|
|
2025-08-23 15:05:12 +02:00
|
|
|
## [4.0.8] - 2025-01-23
|
|
|
|
|
|
|
|
|
|
### Changed
|
|
|
|
|
- Version bump for PyPI release
|
|
|
|
|
- Updated all version references across project files
|
|
|
|
|
|
|
|
|
|
### Technical
|
|
|
|
|
- Prepared package for PyPI distribution
|
|
|
|
|
- Validated package structure and dependencies
|
|
|
|
|
|
2025-08-23 12:52:10 +02:00
|
|
|
## [4.0.7] - 2025-01-23
|
|
|
|
|
|
|
|
|
|
### Added
|
|
|
|
|
- Automatic update checking for PyPI and NPM packages
|
|
|
|
|
- `--no-update-check` flag to skip update checks
|
|
|
|
|
- `--auto-update` flag for automatic updates without prompting
|
|
|
|
|
- Environment variable `SUPERCLAUDE_AUTO_UPDATE` support
|
|
|
|
|
- Update notifications with colored banners showing available version
|
|
|
|
|
- Rate limiting to check updates once per 24 hours
|
|
|
|
|
- Smart installation method detection (pip/pipx/npm/yarn)
|
|
|
|
|
- Cache files for update check timestamps (~/.claude/.update_check and .npm_update_check)
|
|
|
|
|
|
|
|
|
|
### Fixed
|
|
|
|
|
- Component validation now correctly uses pipx-installed version instead of source code
|
|
|
|
|
|
|
|
|
|
### Technical
|
|
|
|
|
- Added `setup/utils/updater.py` for PyPI update checking logic
|
|
|
|
|
- Added `bin/checkUpdate.js` for NPM update checking logic
|
|
|
|
|
- Integrated update checks into main entry points (SuperClaude/__main__.py and bin/cli.js)
|
|
|
|
|
- Non-blocking update checks with 2-second timeout to avoid delays
|
|
|
|
|
|
2025-07-14 18:34:01 +02:00
|
|
|
### Changed
|
2025-08-22 20:39:46 +02:00
|
|
|
- **BREAKING**: Agent system restructured to 14 specialized agents
|
2025-07-14 18:34:01 +02:00
|
|
|
- **BREAKING**: Commands now use `/sc:` namespace to avoid conflicts with user custom commands
|
|
|
|
|
- Commands are now installed in `~/.claude/commands/sc/` subdirectory
|
2025-08-15 21:30:29 +02:00
|
|
|
- All 21 commands updated: `/analyze` → `/sc:analyze`, `/build` → `/sc:build`, etc.
|
2025-07-14 18:34:01 +02:00
|
|
|
- Automatic migration from old command locations to new `sc/` subdirectory
|
2025-08-15 21:30:29 +02:00
|
|
|
- **BREAKING**: Documentation reorganization - Docs/ directory renamed to Guides/
|
2025-07-14 18:34:01 +02:00
|
|
|
|
|
|
|
|
### Added
|
2025-08-22 20:39:46 +02:00
|
|
|
- **NEW AGENTS**: 14 specialized domain agents with enhanced capabilities
|
2025-08-15 21:30:29 +02:00
|
|
|
- backend-architect.md, devops-architect.md, frontend-architect.md
|
|
|
|
|
- learning-guide.md, performance-engineer.md, python-expert.md
|
|
|
|
|
- quality-engineer.md, refactoring-expert.md, requirements-analyst.md
|
2025-08-22 20:39:46 +02:00
|
|
|
- root-cause-analyst.md, security-engineer.md, socratic-mentor.md
|
2025-08-15 21:30:29 +02:00
|
|
|
- **NEW MODE**: MODE_Orchestration.md for intelligent tool selection mindset (5 total behavioral modes)
|
2025-07-14 20:16:57 +02:00
|
|
|
- **NEW COMMAND**: `/sc:implement` for feature and code implementation (addresses v2 user feedback)
|
2025-08-15 21:30:29 +02:00
|
|
|
- **NEW FILE**: CLAUDE.md for project-specific Claude Code instructions
|
2025-07-14 18:34:01 +02:00
|
|
|
- Migration logic to move existing commands to new namespace automatically
|
|
|
|
|
- Enhanced uninstaller to handle both old and new command locations
|
|
|
|
|
- Improved command conflict prevention
|
|
|
|
|
- Better command organization and discoverability
|
2025-08-15 21:30:29 +02:00
|
|
|
- Comprehensive PyPI publishing infrastructure
|
|
|
|
|
- API key management during SuperClaude MCP setup
|
|
|
|
|
|
|
|
|
|
### Removed
|
|
|
|
|
- **BREAKING**: Removed Templates/ directory (legacy templates no longer needed)
|
2025-08-22 20:39:46 +02:00
|
|
|
- **BREAKING**: Removed legacy agents and replaced with enhanced 14-agent system
|
2025-08-15 21:30:29 +02:00
|
|
|
|
|
|
|
|
### Improved
|
|
|
|
|
- Refactored Modes and MCP documentation for concise behavioral guidance
|
|
|
|
|
- Enhanced project cleanup and gitignore for PyPI publishing
|
|
|
|
|
- Implemented uninstall and update safety enhancements
|
|
|
|
|
- Better agent specialization and domain expertise focus
|
2025-07-14 18:34:01 +02:00
|
|
|
|
|
|
|
|
### Technical Details
|
|
|
|
|
- Commands now accessible as `/sc:analyze`, `/sc:build`, `/sc:improve`, etc.
|
|
|
|
|
- Migration preserves existing functionality while preventing naming conflicts
|
|
|
|
|
- Installation process detects and migrates existing commands automatically
|
|
|
|
|
- Tab completion support for `/sc:` prefix to discover all SuperClaude commands
|
2025-08-15 21:30:29 +02:00
|
|
|
- Guides/ directory replaces Docs/ for improved organization
|
2025-07-14 18:34:01 +02:00
|
|
|
|
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
|
|
|
## [4.0.6] - 2025-08-23
|
|
|
|
|
|
|
|
|
|
### Fixed
|
|
|
|
|
- Component validation now correctly checks .superclaude-metadata.json instead of settings.json (#291)
|
|
|
|
|
- Standardized version numbers across all components to 4.0.6
|
|
|
|
|
- Fixed agent validation to check for correct filenames (architect vs specialist/engineer)
|
|
|
|
|
- Fixed package.json version inconsistency (was 4.0.5)
|
|
|
|
|
|
|
|
|
|
### Changed
|
|
|
|
|
- Bumped version from 4.0.4 to 4.0.6 across entire project
|
|
|
|
|
- All component versions now synchronized at 4.0.6
|
|
|
|
|
- Cleaned up metadata file structure for consistency
|
|
|
|
|
|
2025-08-22 21:13:05 +02:00
|
|
|
## [4.0.4] - 2025-08-22
|
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
|
|
|
|
|
|
|
|
### Added
|
|
|
|
|
- **Agent System**: 13 specialized domain experts replacing personas
|
|
|
|
|
- **Behavioral Modes**: 4 intelligent modes for different workflows (Brainstorming, Introspection, Task Management, Token Efficiency)
|
|
|
|
|
- **Session Lifecycle**: /sc:load and /sc:save for cross-session persistence with Serena MCP
|
|
|
|
|
- **New Commands**: /sc:brainstorm, /sc:reflect, /sc:save, /sc:select-tool (21 total commands)
|
|
|
|
|
- **Serena MCP**: Semantic code analysis and memory management
|
|
|
|
|
- **Morphllm MCP**: Intelligent file editing with Fast Apply capability
|
2025-08-15 21:30:29 +02:00
|
|
|
- **Core Components**: Python-based framework integration (completely redesigned and implemented)
|
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
|
|
|
- **Templates**: Comprehensive templates for creating new components
|
|
|
|
|
- **Python-Ultimate-Expert Agent**: Master Python architect for production-ready code
|
|
|
|
|
|
|
|
|
|
### Changed
|
|
|
|
|
- Commands expanded from 16 to 21 specialized commands
|
|
|
|
|
- Personas replaced with 13 specialized Agents
|
|
|
|
|
- Enhanced MCP integration (6 servers total)
|
|
|
|
|
- Improved token efficiency (30-50% reduction with Token Efficiency Mode)
|
|
|
|
|
- Session management now uses Serena integration for persistence
|
|
|
|
|
- Framework structure reorganized for better modularity
|
|
|
|
|
|
|
|
|
|
### Improved
|
|
|
|
|
- Task management with multi-layer orchestration (TodoWrite, /task, /spawn, /loop)
|
|
|
|
|
- Quality gates with 8-step validation cycle
|
|
|
|
|
- Performance monitoring and optimization
|
|
|
|
|
- Cross-session context preservation
|
|
|
|
|
- Intelligent routing with ORCHESTRATOR.md enhancements
|
|
|
|
|
|
2025-07-14 18:34:01 +02:00
|
|
|
## [3.0.0] - 2025-07-14
|
|
|
|
|
|
|
|
|
|
### Added
|
|
|
|
|
- Initial release of SuperClaude v3.0
|
|
|
|
|
- 15 specialized slash commands for development tasks
|
|
|
|
|
- Smart persona auto-activation system
|
|
|
|
|
- MCP server integration (Context7, Sequential, Magic, Playwright)
|
|
|
|
|
- Unified CLI installer with multiple installation profiles
|
|
|
|
|
- Comprehensive documentation and user guides
|
|
|
|
|
- Token optimization framework
|
|
|
|
|
- Task management system
|
|
|
|
|
|
|
|
|
|
### Features
|
|
|
|
|
- **Commands**: analyze, build, cleanup, design, document, estimate, explain, git, improve, index, load, spawn, task, test, troubleshoot
|
|
|
|
|
- **Personas**: architect, frontend, backend, analyzer, security, mentor, refactorer, performance, qa, devops, scribe
|
|
|
|
|
- **MCP Servers**: Official library documentation, complex analysis, UI components, browser automation
|
|
|
|
|
- **Installation**: Quick, minimal, and developer profiles with component selection
|