SuperClaude/CHANGELOG.md
NomenAK e470193b11 🔖 Standardize version to 4.0.3 across all components
- Update PyPI version from 4.0.0 to 4.0.3
- Align all version references (Python, NPM, documentation)
- Update VERSION file, pyproject.toml, and all __init__.py files
- Update CHANGELOG and README version badges
- Fix all version references in RELEASE_INSTRUCTIONS.md

This ensures consistency between PyPI and NPM packages.

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-22 20:43:57 +02:00

4.7 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.3] - 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