mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-17 09:46:06 +00:00
* ✨ 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>
5.3 KiB
5.3 KiB
Changelog
All notable changes to SuperClaude will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[Unreleased]
Changed
- BREAKING: Agent system restructured to 14 specialized agents
- BREAKING: Commands now use
/sc:namespace to avoid conflicts with user custom commands - Commands are now installed in
~/.claude/commands/sc/subdirectory - All 21 commands updated:
/analyze→/sc:analyze,/build→/sc:build, etc. - Automatic migration from old command locations to new
sc/subdirectory - BREAKING: Documentation reorganization - Docs/ directory renamed to Guides/
Added
- NEW AGENTS: 14 specialized domain agents with enhanced capabilities
- 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
- root-cause-analyst.md, security-engineer.md, socratic-mentor.md
- NEW MODE: MODE_Orchestration.md for intelligent tool selection mindset (5 total behavioral modes)
- NEW COMMAND:
/sc:implementfor feature and code implementation (addresses v2 user feedback) - NEW FILE: CLAUDE.md for project-specific Claude Code instructions
- 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
- Comprehensive PyPI publishing infrastructure
- API key management during SuperClaude MCP setup
Removed
- BREAKING: Removed Templates/ directory (legacy templates no longer needed)
- BREAKING: Removed legacy agents and replaced with enhanced 14-agent system
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
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 - Guides/ directory replaces Docs/ for improved organization
[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
[4.0.4] - 2025-08-22
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
- Core Components: Python-based framework integration (completely redesigned and implemented)
- 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
[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