SuperClaude/CHANGELOG.md
NomenAK 9e685b7326
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

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:implement for 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