diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index 9dd215b..2196295 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -518,7 +518,7 @@ This code of conduct draws inspiration from several established community standa **Last Updated**: December 2024 (SuperClaude Framework v4.0) **Next Review**: June 2025 (Semi-annual review cycle) -**Version**: 4.0.0 (Updated for v4 community structure and governance) +**Version**: 4.0.3 (Updated for v4 community structure and governance) **Review Schedule:** - **Semi-Annual Reviews**: Policy effectiveness assessment and community feedback integration diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 59ccbde..7649fd9 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -27,7 +27,7 @@ SuperClaude Framework transforms Claude Code into a structured development platf **Good Bug Report Example:** ``` **Environment:** -- SuperClaude: 4.0.0 +- SuperClaude: 4.0.3 - OS: Ubuntu 22.04 - Claude Code: 1.5.2 - Python: 3.9.7 diff --git a/Docs/Getting-Started/installation.md b/Docs/Getting-Started/installation.md index 89e0f3f..f844f42 100644 --- a/Docs/Getting-Started/installation.md +++ b/Docs/Getting-Started/installation.md @@ -102,7 +102,7 @@ The installer will: **Verify Installation:** ```bash -python3 -m SuperClaude --version # Should show 4.0.0 +python3 -m SuperClaude --version # Should show 4.0.3 SuperClaude install --list-components ``` diff --git a/Docs/Reference/common-issues.md b/Docs/Reference/common-issues.md index 0a2af64..f58d627 100644 --- a/Docs/Reference/common-issues.md +++ b/Docs/Reference/common-issues.md @@ -13,7 +13,7 @@ Test: /sc:brainstorm "test" should ask questions ### 2. Installation Verification ```bash -python3 -m SuperClaude --version # Should show 4.0.0 +python3 -m SuperClaude --version # Should show 4.0.3 # If not working: pip install --upgrade SuperClaude @@ -59,7 +59,7 @@ pip3 install SuperClaude ``` ## Verification Checklist -- [ ] `python3 -m SuperClaude --version` returns 4.0.0 +- [ ] `python3 -m SuperClaude --version` returns 4.0.3 - [ ] `/sc:brainstorm "test"` works in Claude Code - [ ] `SuperClaude install --list-components` shows components diff --git a/Docs/Reference/troubleshooting.md b/Docs/Reference/troubleshooting.md index 157fbd3..03cf2e4 100644 --- a/Docs/Reference/troubleshooting.md +++ b/Docs/Reference/troubleshooting.md @@ -6,7 +6,7 @@ Quick fixes to advanced diagnostics for SuperClaude Framework issues. **Installation Verification:** ```bash -python3 -m SuperClaude --version # Should show 4.0.0 +python3 -m SuperClaude --version # Should show 4.0.3 SuperClaude install --list-components ``` @@ -19,7 +19,7 @@ SuperClaude install --list-components ``` **Resolution Checklist:** -- [ ] Version commands work and show 4.0.0 +- [ ] Version commands work and show 4.0.3 - [ ] `/sc:` commands respond in Claude Code - [ ] MCP servers listed: `SuperClaude install --list-components | grep mcp` diff --git a/Docs/User-Guide/commands.md b/Docs/User-Guide/commands.md index a1252aa..7b8e1ed 100644 --- a/Docs/User-Guide/commands.md +++ b/Docs/User-Guide/commands.md @@ -67,7 +67,7 @@ SuperClaude provides behavioral context files that Claude Code reads to adopt sp ```bash # Verify SuperClaude is working (primary method) python3 -m SuperClaude --version -# Example output: SuperClaude 4.0.0 +# Example output: SuperClaude 4.0.3 # Claude Code CLI version check claude --version diff --git a/PUBLISHING.md b/PUBLISHING.md index 2664849..c808484 100644 --- a/PUBLISHING.md +++ b/PUBLISHING.md @@ -54,7 +54,7 @@ pip install SuperClaude pip install git+https://github.com/SuperClaude-Org/SuperClaude_Framework.git # Specific version -pip install SuperClaude==4.0.0 +pip install SuperClaude==4.0.3 ``` **Automated Release Process:** @@ -212,7 +212,7 @@ git config tag.gpgsign true **Package Information:** **Package Name**: `SuperClaude` -**Current Version**: 4.0.0 (Major release with v4 architecture) +**Current Version**: 4.0.3 (Major release with v4 architecture) **PyPI URL**: https://pypi.org/project/SuperClaude/ **GitHub URL**: https://github.com/SuperClaude-Org/SuperClaude_Framework @@ -363,12 +363,12 @@ git push origin v4.0.1 **Version Scheme (Semantic Versioning):** -**Format**: MAJOR.MINOR.PATCH (e.g., 4.0.0) +**Format**: MAJOR.MINOR.PATCH (e.g., 4.0.3) - **MAJOR**: Breaking changes, architectural updates, incompatible API changes - **MINOR**: New features, agent additions, MCP server integrations, backward-compatible changes - **PATCH**: Bug fixes, documentation updates, security patches, backward-compatible fixes -**Current Version**: 4.0.0 +**Current Version**: 4.0.3 - Major architectural update with enhanced agent coordination - 6 MCP server integrations and 14 specialized agents - Comprehensive command system with 21 slash commands @@ -472,7 +472,7 @@ git tag -v v4.0.1 **Source Distribution Contents:** ``` -SuperClaude-4.0.0.tar.gz +SuperClaude-4.0.3.tar.gz ├── superclaude/ │ ├── __init__.py # Version and package metadata │ ├── cli.py # Main CLI entry point @@ -501,9 +501,9 @@ SuperClaude-4.0.0.tar.gz **Wheel Distribution:** ``` -SuperClaude-4.0.0-py3-none-any.whl +SuperClaude-4.0.3-py3-none-any.whl ├── superclaude/ # Compiled package code -├── SuperClaude-4.0.0.dist-info/ # Package metadata +├── SuperClaude-4.0.3.dist-info/ # Package metadata │ ├── METADATA # Package description and requirements │ ├── WHEEL # Wheel format metadata │ ├── entry_points.txt # CLI entry points @@ -637,7 +637,7 @@ which SuperClaude # Issue: "Tag validation failed" # Solution: Ensure tag follows semver pattern -git tag -d v4.0.0 && git tag v4.0.0 +git tag -d v4.0.3 && git tag v4.0.3 ``` **Publishing Support Resources:** diff --git a/README.md b/README.md index 96e012a..debb887 100644 --- a/README.md +++ b/README.md @@ -11,33 +11,6 @@ SuperClaude is a meta-programming configuration framework that transforms Claude Code into a structured development platform through behavioral instruction injection and component orchestration. It enhances Claude Code with 21 slash commands, 14 specialized agents, 6 behavioral modes, and 6 MCP server integrations for systematic workflow automation. -## What's New in V4 - -Version 4 brings significant improvements based on community feedback and real-world usage patterns. - -### 🤖 Smarter Agent System -We've expanded to 14 specialized agents that actually know their domains. The security engineer catches real vulnerabilities, the frontend architect understands modern UI patterns, and they coordinate automatically based on what you're working on. No more generic advice - you get domain expertise when you need it. - -### 📝 Namespace That Makes Sense -All commands now use `/sc:` prefix to avoid stepping on your custom commands. Simple change, but it matters when you're managing multiple command sets. The 21 commands cover the full development lifecycle from brainstorming to deployment. - -### 🔧 MCP Servers That Actually Help -Six integrated MCP servers provide real capabilities: -- **Context7** for up-to-date documentation -- **Sequential** for complex analysis and problem-solving -- **Magic** for UI component generation -- **Playwright** for browser testing -- **Morphllm** for bulk code transformations -- **Serena** for session persistence - -These aren't just wrappers; they're properly integrated tools that work together. - -### 🎯 Behavioral Modes for Different Contexts -Five modes adjust Claude's approach based on what you're doing. Brainstorming mode asks the right questions, orchestration mode coordinates tools efficiently, token-efficiency mode reduces context usage by 30-50%. It adapts to your workflow, not the other way around. - -### ⚡ Smaller Framework, Bigger Projects -We've cut the framework's footprint significantly. Less framework overhead at Claude Code startup means more context available for your actual work. The entire V4 framework uses fewer tokens to load, leaving you with more room for your codebase, longer conversations, and complex operations. It's simple math - smaller framework = larger available context for what matters. - ## Quick Start ```bash @@ -70,6 +43,33 @@ No pressure though - the framework stays open source regardless. Just knowing pe Every contributor matters, whether through code, feedback, or support. Thanks for being part of this community! 🙏 +## What's New in V4 + +Version 4 brings significant improvements based on community feedback and real-world usage patterns. + +### 🤖 Smarter Agent System +We've expanded to 14 specialized agents that actually know their domains. The security engineer catches real vulnerabilities, the frontend architect understands modern UI patterns, and they coordinate automatically based on what you're working on. No more generic advice - you get domain expertise when you need it. + +### 📝 Namespace That Makes Sense +All commands now use `/sc:` prefix to avoid stepping on your custom commands. Simple change, but it matters when you're managing multiple command sets. The 21 commands cover the full development lifecycle from brainstorming to deployment. + +### 🔧 MCP Servers That Actually Help +Six integrated MCP servers provide real capabilities: +- **Context7** for up-to-date documentation +- **Sequential** for complex analysis and problem-solving +- **Magic** for UI component generation +- **Playwright** for browser testing +- **Morphllm** for bulk code transformations +- **Serena** for session persistence + +These aren't just wrappers; they're properly integrated tools that work together. + +### 🎯 Behavioral Modes for Different Contexts +Five modes adjust Claude's approach based on what you're doing. Brainstorming mode asks the right questions, orchestration mode coordinates tools efficiently, token-efficiency mode reduces context usage by 30-50%. It adapts to your workflow, not the other way around. + +### ⚡ Smaller Framework, Bigger Projects +We've cut the framework's footprint significantly. Less framework overhead at Claude Code startup means more context available for your actual work. The entire V4 framework uses fewer tokens to load, leaving you with more room for your codebase, longer conversations, and complex operations. It's simple math - smaller framework = larger available context for what matters. + ## Documentation ### Getting Started @@ -110,3 +110,14 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed contribution guidelines. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. **Contributors:** [View all contributors](https://github.com/SuperClaude-Org/SuperClaude_Framework/graphs/contributors) + +## Star History + + + + + + Star History Chart + + +--- \ No newline at end of file diff --git a/SECURITY.md b/SECURITY.md index 8799414..fba65c7 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -723,7 +723,7 @@ For organizations requiring dedicated security support: **Last Updated**: December 2024 (SuperClaude Framework v4.0) **Next Review**: March 2025 (Quarterly review cycle) -**Version**: 4.0.0 (Updated for v4 architectural changes) +**Version**: 4.0.3 (Updated for v4 architectural changes) **Review Schedule:** - **Quarterly Reviews**: Security policy accuracy and completeness assessment diff --git a/SuperClaude/__main__.py b/SuperClaude/__main__.py index 3f9d021..b3eda59 100644 --- a/SuperClaude/__main__.py +++ b/SuperClaude/__main__.py @@ -94,7 +94,7 @@ Examples: parents=[global_parser] ) - parser.add_argument("--version", action="version", version="SuperClaude 4.0.0") + parser.add_argument("--version", action="version", version="SuperClaude 4.0.3") subparsers = parser.add_subparsers( dest="operation", @@ -202,7 +202,7 @@ def main() -> int: # No operation provided? Show help manually unless in quiet mode if not args.operation: if not args.quiet: - display_header("SuperClaude Framework v4.0.0-beta", "Unified CLI for all operations") + display_header("SuperClaude Framework v4.0.3", "Unified CLI for all operations") print(f"{Colors.CYAN}Available operations:{Colors.RESET}") for op, desc in get_operation_modules().items(): print(f" {op:<12} {desc}") diff --git a/setup/components/agents.py b/setup/components/agents.py index 754b6b8..0d2a71e 100644 --- a/setup/components/agents.py +++ b/setup/components/agents.py @@ -19,7 +19,7 @@ class AgentsComponent(Component): """Get component metadata""" return { "name": "agents", - "version": "4.0.0", + "version": "4.0.3", "description": "14 specialized AI agents with domain expertise and intelligent routing", "category": "agents" } @@ -29,7 +29,7 @@ class AgentsComponent(Component): return { "components": { "agents": { - "version": "4.0.0", + "version": "4.0.3", "installed": True, "agents_count": len(self.component_files), "install_directory": str(self.install_component_subdir) @@ -63,7 +63,7 @@ class AgentsComponent(Component): # Add component registration self.settings_manager.add_component_registration("agents", { - "version": "4.0.0", + "version": "4.0.3", "category": "agents", "agents_count": len(self.component_files), "agents_list": self.component_files diff --git a/setup/components/mcp.py b/setup/components/mcp.py index 0088387..79856ce 100644 --- a/setup/components/mcp.py +++ b/setup/components/mcp.py @@ -102,7 +102,7 @@ class MCPComponent(Component): """Get component metadata""" return { "name": "mcp", - "version": "4.0.0", + "version": "4.0.3", "description": "MCP server configuration management via .claude.json", "category": "integration" } @@ -348,7 +348,7 @@ class MCPComponent(Component): metadata_mods = { "components": { "mcp": { - "version": "4.0.0", + "version": "4.0.3", "installed": True, "servers_configured": len(self.selected_servers), "configured_servers": self.selected_servers diff --git a/setup/components/mcp_docs.py b/setup/components/mcp_docs.py index 5138bf2..58ffbb4 100644 --- a/setup/components/mcp_docs.py +++ b/setup/components/mcp_docs.py @@ -34,7 +34,7 @@ class MCPDocsComponent(Component): """Get component metadata""" return { "name": "mcp_docs", - "version": "4.0.0", + "version": "4.0.3", "description": "MCP server documentation and usage guides", "category": "documentation" } @@ -135,7 +135,7 @@ class MCPDocsComponent(Component): metadata_mods = { "components": { "mcp_docs": { - "version": "4.0.0", + "version": "4.0.3", "installed": True, "files_count": len(self.component_files), "servers_documented": self.selected_servers diff --git a/setup/components/modes.py b/setup/components/modes.py index 8374621..9d81728 100644 --- a/setup/components/modes.py +++ b/setup/components/modes.py @@ -20,7 +20,7 @@ class ModesComponent(Component): """Get component metadata""" return { "name": "modes", - "version": "4.0.0", + "version": "4.0.3", "description": "SuperClaude behavioral modes (Brainstorming, Introspection, Task Management, Token Efficiency)", "category": "modes" } @@ -69,7 +69,7 @@ class ModesComponent(Component): metadata_mods = { "components": { "modes": { - "version": "4.0.0", + "version": "4.0.3", "installed": True, "files_count": len(self.component_files) } diff --git a/setup/data/features.json b/setup/data/features.json index 368e05f..18c73d7 100644 --- a/setup/data/features.json +++ b/setup/data/features.json @@ -2,7 +2,7 @@ "components": { "core": { "name": "core", - "version": "4.0.0", + "version": "4.0.3", "description": "SuperClaude framework documentation and core files", "category": "core", "dependencies": [], @@ -11,7 +11,7 @@ }, "commands": { "name": "commands", - "version": "4.0.0", + "version": "4.0.3", "description": "SuperClaude slash command definitions", "category": "commands", "dependencies": ["core"], @@ -20,7 +20,7 @@ }, "mcp": { "name": "mcp", - "version": "4.0.0", + "version": "4.0.3", "description": "MCP server configuration management via .claude.json", "category": "integration", "dependencies": ["core"], @@ -29,7 +29,7 @@ }, "modes": { "name": "modes", - "version": "4.0.0", + "version": "4.0.3", "description": "SuperClaude behavioral modes (Brainstorming, Introspection, Task Management, Token Efficiency)", "category": "modes", "dependencies": ["core"], @@ -38,7 +38,7 @@ }, "mcp_docs": { "name": "mcp_docs", - "version": "4.0.0", + "version": "4.0.3", "description": "MCP server documentation and usage guides", "category": "documentation", "dependencies": ["core"], @@ -47,7 +47,7 @@ }, "agents": { "name": "agents", - "version": "4.0.0", + "version": "4.0.3", "description": "14 specialized AI agents with domain expertise and intelligent routing", "category": "agents", "dependencies": ["core"],