External/SuperClaude
1
0
Fork 0
mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-29 16:16:08 +00:00
Code Issues Packages Projects Releases Wiki Activity

Restructure documentation: Create focused guide ecosystem from oversized user guide

Browse Source 
- Transform 28K+ token superclaude-user-guide.md into 4.5K token overview (84% reduction)
- Extract specialized guides: examples-cookbook.md, troubleshooting-guide.md, best-practices.md, session-management.md, technical-architecture.md
- Add comprehensive cross-references between all guides for improved navigation
- Maintain professional documentation quality with technical-writer agent approach
- Remove template files and consolidate agent naming (backend-engineer → backend-architect, etc.)
- Update all existing guides with cross-references and related guides sections
- Create logical learning paths from beginner to advanced users
- Eliminate content duplication while preserving all valuable information

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
NomenAK
2025-08-15 21:30:29 +02:00
parent 9a5e2a01ff
commit 40840dae0b
91 changed files with 7666 additions and 15055 deletions
Download Patch File Download Diff File Expand all files Collapse all files

347
README.md
View File

@@ -1,8 +1,8 @@
# SuperClaude v4 Beta 🚀
# SuperClaude v4.0.0 🚀
[![Website Preview](https://img.shields.io/badge/Visit-Website-blue?logo=google-chrome)](https://superclaude-org.github.io/SuperClaude_Website/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PyPI version](https://img.shields.io/pypi/v/SuperClaude.svg)](https://pypi.org/project/SuperClaude/)
[![Version](https://img.shields.io/badge/version-4.0.0--beta.1-blue.svg)](https://github.com/SuperClaude-Org/SuperClaude_Framework)
[![Version](https://img.shields.io/badge/version-4.0.0-blue.svg)](https://github.com/SuperClaude-Org/SuperClaude_Framework)
[![GitHub issues](https://img.shields.io/github/issues/SuperClaude-Org/SuperClaude_Framework)](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/CONTRIBUTING.md)
[![Contributors](https://img.shields.io/github/contributors/SuperClaude-Org/SuperClaude_Framework)](https://github.com/SuperClaude-Org/SuperClaude_Framework/graphs/contributors)
@@ -10,30 +10,44 @@
An intelligent framework that transforms Claude Code into a comprehensive development environment with specialized agents, behavioral modes, and advanced MCP integration.
**📢 Status**: V4 Beta is here! Major architecture overhaul with new behavioral modes, session lifecycle, and comprehensive agent system.
**📢 Status**: v4.0.0 is here! Major architecture overhaul with new behavioral modes, session lifecycle, and comprehensive agent system.
## What is SuperClaude V4? 🤔
## What is SuperClaude v4.0.0? 🤔
SuperClaude V4 represents a complete evolution of the development framework, now featuring:
SuperClaude v4.0.0 represents a complete evolution of the development framework, now featuring:
- 🛠️ **21 specialized commands** for comprehensive development workflows
- 🤖 **13 specialized agents** with domain expertise and intelligent routing
- 🧠 **4 Behavioral Modes** for different types of work (Brainstorming, Introspection, Task Management, Token Efficiency)
- 🧠 **5 Behavioral Modes** for different types of work (Brainstorming, Introspection, Task Management, Orchestration, Token Efficiency)
- 🔧 **6 MCP servers** including the powerful new Morphllm and Serena agents
- 💾 **Session Lifecycle** with persistent context via /sc:load and /sc:save
- 🎣 **Hooks System** for extensibility and customization
- ⚡ **SuperClaude-Lite** for lightweight usage
This is a complete rethink of how AI-assisted development should work - more intelligent, more capable, and more adaptable to your workflow! 🎯
## Support SuperClaude Development 💎
Help us continue advancing the future of AI-assisted development! SuperClaude v4.0.0 represents a major architectural evolution with significant improvements:
### What Your Support Enables 🚀
- **Framework Evolution** - Continued development of behavioral modes and agent intelligence
- **Claude Code Subscriptions** - Essential API access for framework development and testing
- **Documentation Quality** - Comprehensive guides and technical writing improvements
- **Community Resources** - Better tooling, examples, and educational materials
### Ways to Support 🤝
[![Support on Ko-fi](https://img.shields.io/badge/Ko--fi-Support%20Development-FF5E5B?logo=ko-fi&logoColor=white)](https://ko-fi.com/superclaude)
[![GitHub Sponsors](https://img.shields.io/badge/GitHub-Sponsor-EA4AAA?logo=github-sponsors&logoColor=white)](https://github.com/sponsors/SuperClaude-Org)
[![Support on Patreon](https://img.shields.io/badge/Patreon-Support%20Us-F96854?logo=patreon&logoColor=white)](https://patreon.com/superclaude)
## Current Status 📊
✅ **What's New in V4:**
- Complete architecture redesign with behavioral modes
- Session persistence with intelligent context management
- 13 specialized agents replacing the old persona system
✅ **What's New in v4.0.0:**
- Complete rework of behavioral foundation with 30-50% token efficiency gains
- 13 specialized agents with domain expertise and collaborative coordination
- Context-aware adaptive behavior with automatic activation
- Persistent development context across sessions with smart checkpointing
- Significant weight reduction while expanding capabilities
- Advanced MCP integration with Morphllm and Serena
- Hooks system for extensibility (now implemented!)
- SuperClaude-Lite for resource-constrained environments
✅ **What's Working Well:**
- All 21 commands with enhanced capabilities
@@ -42,10 +56,10 @@ This is a complete rethink of how AI-assisted development should work - more int
- Behavioral modes with automatic activation
- Intelligent agent routing and coordination
⚠️ **Beta Limitations:**
- Some advanced features still being refined
- Documentation being updated for new features
- Performance optimizations ongoing
✅ **Production Ready:**
- Stable release with comprehensive testing
- Full documentation and user guides
- Performance optimizations implemented
## Key Features ✨
@@ -61,23 +75,23 @@ Enhanced command suite for comprehensive development workflows:
### 13 Specialized Agents 🤖
AI specialists with deep domain expertise and intelligent coordination:
- 🏗️ **architect** - System design and architecture
- 🎨 **frontend** - UI/UX and modern frontend development
- ⚙️ **backend** - APIs, infrastructure, and server-side logic
- 🔍 **analyzer** - Debugging and system analysis
- 🛡️ **security** - Security assessment and vulnerability analysis
- ✍️ **scribe** - Technical documentation and writing
- ⚡ **performance** - Optimization and performance engineering
- 🧪 **qa** - Quality assurance and testing strategies
- 📊 **data** - Data analysis and processing
- 🤖 **devops** - Infrastructure and deployment automation
- 🔧 **sre** - Site reliability and system operations
- 💼 **product** - Product strategy and requirements
- 🎯 **specialist** - Adaptive expertise for unique domains
- 🏗️ **system-architect** - System design and architecture
- 🎨 **frontend-architect** - UI/UX and modern frontend development
- ⚙️ **backend-architect** - APIs, infrastructure, and server-side logic
- 🔍 **root-cause-analyst** - Systematic investigation and debugging
- 🛡️ **security-engineer** - Security assessment and vulnerability analysis
- ✍️ **technical-writer** - Technical documentation and writing
- ⚡ **performance-engineer** - Optimization and performance engineering
- 🧪 **quality-engineer** - Quality assurance and testing strategies
- 🐍 **python-expert** - Python development and best practices
- 🤖 **devops-architect** - Infrastructure and deployment automation
- 🔧 **refactoring-expert** - Code refactoring and clean code principles
- 📋 **requirements-analyst** - Requirements discovery and analysis
- 🎯 **learning-guide** - Teaching and educational explanations
*These agents feature intelligent routing, context awareness, and collaborative problem-solving capabilities.*
### 4 Behavioral Modes 🧠
### 5 Behavioral Modes 🧠
Revolutionary behavioral system that adapts SuperClaude's approach:
#### Brainstorming Mode
@@ -91,9 +105,14 @@ Revolutionary behavioral system that adapts SuperClaude's approach:
- **Features**: Reasoning analysis, decision validation, pattern recognition
#### Task Management Mode
- **Purpose**: Multi-layer orchestration with wave systems and delegation
- **Purpose**: Multi-layer orchestration and systematic delegation
- **Triggers**: Multi-step operations, complex builds, system-wide changes
- **Features**: Wave orchestration, sub-agent delegation, performance analytics
- **Features**: Progressive orchestration, sub-agent delegation, performance analytics
#### Orchestration Mode
- **Purpose**: Intelligent tool selection and resource optimization
- **Triggers**: Multi-tool operations, performance constraints, parallel execution
- **Features**: Smart tool selection, parallel thinking, resource management
#### Token Efficiency Mode
- **Purpose**: Intelligent optimization with symbol systems and compression
@@ -116,23 +135,16 @@ Persistent development context with intelligent management:
- **Automatic Checkpoints** - Task completion, time-based, risk-based triggers
- **Cross-Session Learning** - Accumulated insights and pattern recognition
### Hooks System 🎣
Extensible architecture for customization:
### Advanced Framework Features
Intelligent architecture with built-in capabilities:
- **Framework Coordinator** - Cross-component orchestration
- **Performance Monitor** - Real-time metrics and optimization
- **Quality Gates** - 8-step validation pipeline
- **Session Lifecycle** - Event-driven session management
### SuperClaude-Lite ⚡
Lightweight variant for resource-constrained environments:
- Streamlined feature set
- Reduced resource requirements
- Core functionality preservation
- Easy upgrade path to full SuperClaude
## ⚠️ Upgrading from v3? Important!
SuperClaude V4 is a major architectural upgrade. Clean installation recommended:
SuperClaude v4.0.0 is a major architectural upgrade. Clean installation recommended:
1. **Backup Important Data** - Save any custom configurations
2. **Clean Previous Installation**:
@@ -141,7 +153,7 @@ SuperClaude V4 is a major architectural upgrade. Clean installation recommended:
rm -rf ~/.claude/SuperClaude/
rm -rf ~/.claude/shared/
```
3. **Install V4 Beta** - Follow installation instructions below
3. **Install v4.0.0** - Follow installation instructions below
### 🔄 **Key Changes for v3 Users**
- **New Commands**: `/sc:brainstorm`, `/sc:reflect`, `/sc:save`, `/sc:select-tool`
@@ -151,56 +163,20 @@ SuperClaude V4 is a major architectural upgrade. Clean installation recommended:
## Installation 📦
SuperClaude V4 Beta installation with enhanced capabilities:
SuperClaude v4.0.0 installation with enhanced capabilities:
### Step 1: Install the Package
**Option A: From PyPI (Recommended)**
```bash
uv add SuperClaude
pip install SuperClaude
```
**Option B: From Source**
```bash
git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework
uv sync
```
### 🔧 UV / UVX Setup Guide
SuperClaude V4 fully supports installation via [`uv`](https://github.com/astral-sh/uv) for optimal performance.
### 🌀 Install with `uv`
Make sure `uv` is installed:
```bash
curl -Ls https://astral.sh/uv/install.sh | sh
```
> Or follow instructions from: [https://github.com/astral-sh/uv](https://github.com/astral-sh/uv)
Once `uv` is available:
```bash
uv venv
source .venv/bin/activate
uv pip install SuperClaude
```
### ⚡ Install with `uvx` (Cross-platform CLI)
```bash
uvx pip install SuperClaude
```
### ✅ SuperClaude-Lite Installation
For lightweight usage:
```bash
python3 -m SuperClaude install --lite
pip install -e .
```
---
@@ -216,61 +192,38 @@ brew install python3
# Download from https://python.org/downloads/
```
### Step 2: Run the V4 Installer
### Step 2: Run the v4.0.0 Installer
Enhanced installer with behavioral modes and session lifecycle:
```bash
# V4 Beta setup (recommended for most users)
# v4.0.0 setup (recommended for most users)
python3 -m SuperClaude install
# Interactive selection with V4 features
python3 -m SuperClaude install --interactive
# Minimal install (core framework only)
python3 -m SuperClaude install --minimal
# Full developer setup (all V4 features)
python3 -m SuperClaude install --profile developer
# SuperClaude-Lite installation
python3 -m SuperClaude install --lite
# See all V4 options
# See all v4.0.0 options
python3 -m SuperClaude install --help
```
### Simple bash Command Usage
```bash
# V4 Beta setup
# v4.0.0 setup
SuperClaude install
# Interactive V4 installation
SuperClaude install --interactive
# Lightweight installation
SuperClaude install --lite
# Full V4 developer setup
SuperClaude install --profile developer
```
**That's it! 🎉** The V4 installer configures everything: behavioral modes, MCP servers, session lifecycle, and hooks system.
**That's it! 🎉** The v4.0.0 installer configures everything: behavioral modes, MCP servers, and session lifecycle.
## How V4 Works 🔄
## How v4.0.0 Works 🔄
SuperClaude V4 transforms Claude Code through intelligent architecture:
SuperClaude v4.0.0 transforms Claude Code through intelligent architecture:
1. **Behavioral Modes** - Adaptive behavior based on context and task requirements
2. **Agent Coordination** - 13 specialized agents with intelligent routing and collaboration
3. **Session Lifecycle** - Persistent context with /sc:load and /sc:save commands
4. **MCP Integration** - 6 powerful servers for extended capabilities
5. **Hooks System** - Extensible architecture for customization and monitoring
6. **Quality Gates** - 8-step validation pipeline ensuring excellence
The system intelligently adapts to your workflow, automatically activating appropriate modes and agents. 🧠
## V4 Architecture Highlights 🏗️
## v4.0.0 Architecture Highlights 🏗️
### Behavioral Intelligence
- **Automatic Mode Detection** - Context-aware behavioral adaptation
@@ -289,85 +242,155 @@ The system intelligently adapts to your workflow, automatically activating appro
## Configuration ⚙️
V4 configuration with enhanced behavioral controls:
- `~/.claude/settings.json` - Main V4 configuration with modes and agents
v4.0.0 configuration with enhanced behavioral controls:
- `~/.claude/*.md` - Behavioral mode configurations
- `~/.claude/agents/` - Agent-specific customizations
- `~/.claude/commands/` - Command definitions and configurations
- `~/.serena/` - Session lifecycle and memory management
Most users can use defaults - V4 intelligently adapts to your workflow! 🎛️
Most users can use defaults - v4.0.0 intelligently adapts to your workflow! 🎛️
## Documentation 📖
Comprehensive V4 guides and documentation:
Comprehensive v4.0.0 guides and documentation:
- 📚 [**V4 User Guide**](https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/Docs/superclaude-user-guide.md) - Complete V4 overview and getting started
- 🛠️ [**Commands Guide**](https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/Docs/commands-guide.md) - All 21 commands with V4 enhancements
- 🧠 [**Behavioral Modes Guide**](https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/Docs/behavioral-modes-guide.md) - Understanding the 4 behavioral modes
- 🤖 [**Agent System Guide**](https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/Docs/agent-system-guide.md) - Working with 13 specialized agents
- 💾 [**Session Lifecycle Guide**](https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/Docs/session-lifecycle-guide.md) - /sc:load and /sc:save workflows
- 🎣 [**Hooks System Guide**](https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/Docs/hooks-guide.md) - Extending and customizing V4
- 🏳️ [**Flags Guide**](https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/Docs/flags-guide.md) - V4 command flags and behavioral controls
- 📦 [**Installation Guide**](https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/Docs/installation-guide.md) - Detailed V4 installation and setup
- 📚 [**v4.0.0 User Guide**](https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/Guides/superclaude-user-guide.md) - Complete v4.0.0 overview and getting started
- 🛠️ [**Commands Guide**](https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/Guides/commands-guide.md) - All 21 commands with v4.0.0 enhancements
- 🧠 [**Behavioral Modes Guide**](https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/Guides/behavioral-modes-guide.md) - Understanding the 5 behavioral modes
- 🤖 [**Agent System Guide**](https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/Guides/agent-system-guide.md) - Working with 13 specialized agents
- 🏳️ [**Flags Guide**](https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/Guides/flags-guide.md) - v4.0.0 command flags and behavioral controls
- 📦 [**Installation Guide**](https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/Guides/installation-guide.md) - Detailed v4.0.0 installation and setup
## Contributing 🤝
V4 opens new contribution opportunities:
- 🐛 **Bug Reports** - Help us refine the beta
- 📝 **Documentation** - V4 features need clear explanation
- 🧪 **Testing** - Beta testing across different environments
- 🎣 **Hooks Development** - Extend the hooks system
v4.0.0 opens new contribution opportunities:
- 🐛 **Bug Reports** - Help us improve the stable release
- 📝 **Documentation** - v4.0.0 features need clear explanation
- 🧪 **Testing** - Community participation across different environments
- 🔧 **Framework Development** - Extend the framework capabilities
- 🤖 **Agent Enhancement** - Improve specialized agent capabilities
- 🧠 **Behavioral Modes** - Contribute to mode intelligence
The V4 architecture is modular and extensible - many ways to contribute!
The v4.0.0 architecture is modular - many ways to contribute!
### Documentation & Community 📝
While we strive for accuracy, the rapid v4.0.0 evolution means documentation may contain errors. We rely on our community to:
- **Report Issues** - Help us identify documentation gaps or technical problems
- **Submit Improvements** - PRs for documentation fixes and enhancements are always welcome
- **Share Feedback** - Your experience helps shape future development priorities
*Every contribution, whether code, documentation, or financial support, helps make SuperClaude better for the entire development community! 🌟*
## Project Structure 📁
```
SuperClaude/
├── setup.py # PyPI setup for V4
├── SuperClaude/ # V4 Framework files
│ ├── Core/ # Behavioral mode documentation
│ ├── Commands/ # 21 specialized command definitions
│ ├── Agents/ # 13 agent specifications
│ ├── Modes/ # 4 behavioral mode configurations
│ ├── MCP/ # 6 MCP server integrations
│ ├── Hooks/ # Extensible hooks system
│ └── Config/ # V4 configuration management
├── SuperClaude-Lite/ # Lightweight variant
├── setup/ # V4 installation system
└── profiles/ # Installation profiles with V4 features
SuperClaude_Framework/
├── 📁 SuperClaude/ # Core framework documentation & behavioral definitions
│ ├── 🤖 Agents/ # 13 specialized agents with domain expertise
│ │ ├── backend-architect.md # API & server-side architecture specialist
│ │ ├── devops-architect.md # Infrastructure & deployment automation
│ │ ├── frontend-architect.md # UI/UX & modern frontend development
│ │ ├── learning-guide.md # Educational explanations & tutorials
│ │ ├── performance-engineer.md # Optimization & performance engineering
│ │ ├── python-expert.md # Python development & best practices
│ │ ├── quality-engineer.md # QA strategies & testing frameworks
│ │ ├── refactoring-expert.md # Code cleanup & architectural improvements
│ │ ├── requirements-analyst.md # Requirements discovery & analysis
│ │ ├── root-cause-analyst.md # Systematic debugging & investigation
│ │ ├── security-engineer.md # Security assessment & vulnerability analysis
│ │ ├── system-architect.md # High-level system design & architecture
│ │ └── technical-writer.md # Technical documentation & communication
│ ├── 🛠️ Commands/ # 21 specialized slash commands
│ │ ├── analyze.md # Code & project analysis
│ │ ├── brainstorm.md # Interactive requirements discovery
│ │ ├── build.md # Smart build with auto-optimization
│ │ ├── cleanup.md # Code cleanup & organization
│ │ ├── design.md # Architecture & design planning
│ │ ├── document.md # Technical documentation generation
│ │ ├── estimate.md # Project estimation & planning
│ │ ├── explain.md # Code explanation & education
│ │ ├── git.md # Advanced git operations
│ │ ├── implement.md # Feature implementation & development
│ │ ├── improve.md # Code enhancement & optimization
│ │ ├── index.md # Command registry & coordination
│ │ ├── load.md # Session initialization & context loading
│ │ ├── reflect.md # Session reflection & analysis
│ │ ├── save.md # Session persistence & context saving
│ │ ├── select-tool.md # Intelligent tool selection
│ │ ├── spawn.md # Agent spawning & coordination
│ │ ├── task.md # Task management & orchestration
│ │ ├── test.md # Testing strategies & execution
│ │ ├── troubleshoot.md # Problem diagnosis & resolution
│ │ └── workflow.md # Workflow automation & management
│ ├── 🧠 Core/ # Foundational behavioral rules & principles
│ │ ├── FLAGS.md # Behavioral flags for execution modes
│ │ ├── PRINCIPLES.md # Software engineering principles
│ │ └── RULES.md # Operational rules & guidelines
│ ├── 🔧 MCP/ # MCP server integration & configs
│ │ └── configs/ # MCP server configuration files
│ └── 🎭 Modes/ # 5 behavioral modes for adaptive behavior
│ ├── MODE_Brainstorming.md # Interactive discovery & ideation
│ ├── MODE_Introspection.md # Meta-cognitive analysis & reflection
│ ├── MODE_Orchestration.md # Intelligent tool selection & coordination
│ ├── MODE_Task_Management.md # Multi-layer orchestration & delegation
│ └── MODE_Token_Efficiency.md # Symbol-enhanced compression & optimization
├── 📚 Guides/ # Comprehensive user documentation
│ └── superclaude-user-guide.md # Complete usage guide & workflows
├── 🏗️ setup/ # Modular installation & configuration system
│ ├── cli/ # Command-line interface & operations
│ │ ├── commands/ # CLI command implementations
│ │ ├── install.py # Installation orchestration
│ │ ├── update.py # Update management
│ │ └── uninstall.py # Clean uninstallation
│ ├── components/ # Component-based installation modules
│ ├── core/ # Core installation logic & registry
│ │ ├── installer.py # Installation orchestration engine
│ │ └── registry.py # Component discovery & dependency resolution
│ ├── data/ # Installation data & metadata
│ └── services/ # Configuration management services
│ ├── claude_md.py # Dynamic CLAUDE.md generation
│ ├── config.py # Configuration management
│ └── file_ops.py # File operation utilities
├── 🔨 scripts/ # Build, validation & publishing automation
│ ├── build_and_upload.py # PyPI package building & publishing
│ ├── publish.sh # Production publishing workflow
│ └── validate_pypi_ready.py # Package validation & compliance
├── 📄 Configuration Files
│ ├── CLAUDE.md # Project-specific Claude Code instructions
│ ├── pyproject.toml # Python project configuration & dependencies
│ ├── uv.lock # Dependency lock file for reproducible builds
│ └── README.md # This comprehensive project overview
└── 📋 Documentation
├── CHANGELOG.md # Version history & release notes
├── CONTRIBUTING.md # Contribution guidelines & development setup
├── CODE_OF_CONDUCT.md # Community standards & expectations
├── SECURITY.md # Security policies & vulnerability reporting
└── PUBLISHING.md # Publishing guidelines & release procedures
```
## V4 Architecture Notes 🏗️
## v4.0.0 Architecture Notes 🏗️
The V4beta architecture focuses on:
The v4.0.0 architecture focuses on:
- **Behavioral Intelligence** - Context-aware adaptive behavior
- **Agent Orchestration** - Sophisticated multi-agent coordination
- **Session Persistence** - Continuous learning and context preservation
- **Extensibility** - Hooks system for customization and enhancement
- **Performance** - Token efficiency and resource optimization
- **Quality** - 8-step validation gates ensuring excellence
V4 represents a fundamental evolution in AI-assisted development frameworks.
v4.0.0 represents a fundamental evolution in AI-assisted development frameworks.
## FAQ 🙋
**Q: What's new in V4 compared to V3?**
A: Complete architecture overhaul with behavioral modes, session lifecycle, 13 agents, 6 MCP servers, and hooks system.
**Q: What's new in v4.0.0 compared to V3?**
A: Complete architecture overhaul with behavioral modes, session lifecycle, 13 agents, and 6 MCP servers.
**Q: Is the hooks system back?**
A: Yes! Completely redesigned and implemented with extensible architecture.
**Q: How does the new architecture work?**
A: Built on behavioral modes, intelligent agents, and session persistence for adaptive development workflows.
**Q: Should I upgrade from V3?**
A: V4 beta offers significant improvements, but clean installation recommended for stability.
A: v4.0.0 offers significant improvements, with clean installation recommended for best experience.
**Q: What is SuperClaude-Lite?**
A: Lightweight variant with core functionality for resource-constrained environments.
**Q: How stable is V4 beta?**
A: Core functionality is solid, with some advanced features still being refined. Great for development and testing!
**Q: How stable is v4.0.0?**
A: Production-ready stable release with comprehensive testing and community validation!
## SuperClaude Contributors
@@ -388,6 +411,6 @@ MIT - [See LICENSE file for details](https://opensource.org/licenses/MIT)
</a>
---
*V4 Beta: The future of AI-assisted development is here. Experience intelligent, adaptive, and powerful development workflows! 🚀*
*v4.0.0: The future of AI-assisted development is here. Experience intelligent, adaptive, and powerful development workflows! 🚀*
---