From f97507094653791e24a501a82995fc81e70cc98f Mon Sep 17 00:00:00 2001 From: NomenAK Date: Mon, 14 Jul 2025 20:51:44 +0200 Subject: [PATCH] feat: SuperClaude Core files v3.0 reality refresh MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Complete alignment of Core documentation with actual v3.0 implementation: ✅ COMMANDS.md - Remove 5 phantom commands (/dev-setup, /review, /scan, /deploy, /migrate) ✅ COMMANDS.md - Fix count from 21→16 commands, update wave commands 9→6 ✅ ORCHESTRATOR.md - Remove 4 broken Scripts/orchestrator_implementation.py references ✅ ORCHESTRATOR.md - Update wave tiers to match actual commands ✅ FLAGS.md - Realistic token reduction claims (60-80% → 30-50%) ✅ FLAGS.md - Remove enterprise-waves references ✅ MCP.md - Remove phantom command references from integration lists ✅ PERSONAS.md - Remove all phantom command references from optimized commands ✅ MODES.md - Update performance metrics to realistic targets ✅ All files - Verified consistency across 16 actual commands and 6 wave-enabled Core files now accurately reflect SuperClaude v3.0 capabilities rather than aspirational v4 features, improving user expectations and framework credibility. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- SuperClaude/Core/COMMANDS.md | 54 +++++--------------------------- SuperClaude/Core/FLAGS.md | 4 +-- SuperClaude/Core/MCP.md | 2 +- SuperClaude/Core/MODES.md | 2 +- SuperClaude/Core/ORCHESTRATOR.md | 12 ++----- SuperClaude/Core/PERSONAS.md | 20 +++--------- 6 files changed, 18 insertions(+), 76 deletions(-) diff --git a/SuperClaude/Core/COMMANDS.md b/SuperClaude/Core/COMMANDS.md index 2cc4251..a053d00 100644 --- a/SuperClaude/Core/COMMANDS.md +++ b/SuperClaude/Core/COMMANDS.md @@ -39,8 +39,8 @@ performance-profile: "optimization|standard|complex" **Wave Orchestration Engine**: Multi-stage command execution with compound intelligence. Auto-activates on complexity ≥0.7 + files >20 + operation_types >2. **Wave-Enabled Commands**: -- **Tier 1**: `/analyze`, `/improve`, `/build`, `/scan`, `/review` -- **Tier 2**: `/design`, `/troubleshoot`, `/task` +- **Tier 1**: `/analyze`, `/build`, `/implement`, `/improve` +- **Tier 2**: `/design`, `/task` ### Development Commands @@ -74,12 +74,6 @@ performance-profile: "standard" - **Tool Orchestration**: [Read, Write, Edit, MultiEdit, Bash, Glob, TodoWrite, Task] - **Arguments**: `[feature-description]`, `--type component|api|service|feature`, `--framework `, `--` -**`/dev-setup $ARGUMENTS`** -- **Purpose**: Development environment configuration -- **Category**: Development & Infrastructure -- **Auto-Persona**: DevOps, Backend -- **MCP Integration**: Context7, Sequential -- **Workflow**: Detect requirements → Configure environment → Setup tooling → Validate ### Analysis Commands @@ -102,20 +96,6 @@ performance-profile: "complex" **`/explain [topic] [flags]`** - Educational explanations | Auto-Persona: Mentor, Scribe | MCP: Context7, Sequential -**`/review [target] [flags]`** -```yaml ---- -command: "/review" -category: "Analysis & Quality Assurance" -purpose: "Comprehensive code review and quality analysis" -wave-enabled: true -performance-profile: "complex" ---- -``` -- **Auto-Persona**: QA, Analyzer, Architect -- **MCP Integration**: Context7 (standards), Sequential (methodology), Magic (UI review) -- **Tool Orchestration**: [Read, Grep, Glob, TodoWrite] -- **Arguments**: `[target]`, `@`, `!`, `--` ### Quality Commands @@ -134,20 +114,6 @@ performance-profile: "optimization" - **Tool Orchestration**: [Read, Grep, Glob, Edit, MultiEdit, Bash] - **Arguments**: `[target]`, `@`, `!`, `--` -**`/scan [target] [flags]`** -```yaml ---- -command: "/scan" -category: "Quality & Security" -purpose: "Security and code quality scanning" -wave-enabled: true -performance-profile: "complex" ---- -``` -- **Auto-Persona**: Security, QA, Analyzer -- **MCP Integration**: Sequential (scanning), Context7 (patterns), Playwright (dynamic testing) -- **Tool Orchestration**: [Read, Grep, Glob, Bash, TodoWrite] -- **Arguments**: `[target]`, `@`, `!`, `--` **`/cleanup [target] [flags]`** - Project cleanup and technical debt reduction | Auto-Persona: Refactorer | MCP: Sequential @@ -161,12 +127,8 @@ performance-profile: "complex" **`/test [type] [flags]`** - Testing workflows | Auto-Persona: QA | MCP: Playwright, Sequential -**`/deploy [environment] [flags]`** - Deployment operations | Auto-Persona: DevOps, Backend | MCP: Playwright, Sequential - **`/git [operation] [flags]`** - Git workflow assistant | Auto-Persona: DevOps, Scribe, QA | MCP: Sequential -**`/migrate [type] [flags]`** - Migration management | Auto-Persona: Backend, DevOps | MCP: Sequential, Context7 - **`/design [domain] [flags]`** - Design orchestration | Auto-Persona: Architect, Frontend | MCP: Magic, Sequential, Context7 ### Meta & Orchestration Commands @@ -189,17 +151,15 @@ complex: "Resource-intensive with comprehensive analysis" ``` ### Command Categories -- **Development**: build, implement, dev-setup, design -- **Analysis**: analyze, troubleshoot, explain, review -- **Quality**: improve, scan, cleanup +- **Development**: build, implement, design +- **Analysis**: analyze, troubleshoot, explain +- **Quality**: improve, cleanup - **Testing**: test - **Documentation**: document - **Planning**: estimate, task -- **Deployment**: deploy - **Version-Control**: git -- **Data-Operations**: migrate, load -- **Meta**: index, loop, spawn +- **Meta**: index, load, spawn ### Wave-Enabled Commands -9 commands: `/analyze`, `/build`, `/design`, `/implement`, `/improve`, `/review`, `/scan`, `/task` +6 commands: `/analyze`, `/build`, `/design`, `/implement`, `/improve`, `/task` diff --git a/SuperClaude/Core/FLAGS.md b/SuperClaude/Core/FLAGS.md index 10907cd..f9636d1 100644 --- a/SuperClaude/Core/FLAGS.md +++ b/SuperClaude/Core/FLAGS.md @@ -34,12 +34,12 @@ Flag system for Claude Code SuperClaude framework with auto-activation and confl - Critical system redesign analysis (~32K tokens) - Maximum depth analysis for complex problems - Auto-activates: Legacy modernization, critical vulnerabilities, performance degradation >50% -- Auto-enables `--seq --c7 --all-mcp` and suggests `--enterprise-waves` +- Auto-enables `--seq --c7 --all-mcp` for comprehensive analysis ## Compression & Efficiency Flags **`--uc` / `--ultracompressed`** -- 60-80% token reduction using symbols and structured output +- 30-50% token reduction using symbols and structured output - Auto-activates: Context usage >75% or large-scale operations - Auto-generated symbol legend, maintains technical accuracy diff --git a/SuperClaude/Core/MCP.md b/SuperClaude/Core/MCP.md index bd572c0..0ab4392 100644 --- a/SuperClaude/Core/MCP.md +++ b/SuperClaude/Core/MCP.md @@ -31,7 +31,7 @@ MCP (Model Context Protocol) server integration and orchestration system for Cla 6. Validation: Verify implementation against official documentation 7. Caching: Store successful patterns for session reuse -**Integration Commands**: `/build`, `/analyze`, `/improve`, `/review`, `/design`, `/dev-setup`, `/document`, `/explain`, `/git` +**Integration Commands**: `/build`, `/analyze`, `/improve`, `/design`, `/document`, `/explain`, `/git` **Error Recovery**: - Library not found → WebSearch for alternatives → Manual implementation diff --git a/SuperClaude/Core/MODES.md b/SuperClaude/Core/MODES.md index bce6614..f5177e9 100644 --- a/SuperClaude/Core/MODES.md +++ b/SuperClaude/Core/MODES.md @@ -304,7 +304,7 @@ Meta-cognitive analysis mode that enables Claude Code to step outside normal ope - **Cross-Server**: Coordinated caching strategies and compression optimization ### Performance Metrics -- **Target**: 30-50% realistic token reduction (vs. claimed 60-80%) +- **Target**: 30-50% token reduction with quality preservation - **Quality**: ≥95% information preservation score - **Speed**: <100ms compression decision and application time - **Integration**: Seamless SuperClaude framework compliance \ No newline at end of file diff --git a/SuperClaude/Core/ORCHESTRATOR.md b/SuperClaude/Core/ORCHESTRATOR.md index 0800fd7..be58847 100644 --- a/SuperClaude/Core/ORCHESTRATOR.md +++ b/SuperClaude/Core/ORCHESTRATOR.md @@ -28,8 +28,6 @@ Analyzes requests to understand intent, complexity, and requirements. **Validation Logic**: Resource availability, flag compatibility, risk assessment, outcome prediction, and safety recommendations. Operations with risk scores >0.8 trigger safe mode suggestions. -*Implementation: See `Scripts/orchestrator_implementation.py` - `validate_operation()`* - **Resource Management Thresholds**: - **Green Zone** (0-60%): Full operations, predictive monitoring active - **Yellow Zone** (60-75%): Resource optimization, caching, suggest --uc mode @@ -166,8 +164,6 @@ wave_operations: - **Thresholds**: Default 0.7, customizable via `--wave-threshold`, enterprise strategy lowers file thresholds - **Decision Logic**: Sum all indicators, trigger waves when total ≥ threshold -*Implementation: See `Scripts/orchestrator_implementation.py` - `detect_wave_eligibility()`* - ## 🚦 Routing Intelligence Dynamic decision trees that map detected patterns to optimal tool combinations, persona activation, and orchestration strategies. @@ -189,8 +185,8 @@ wave-strategies: ``` **Wave-Enabled Commands**: -- **Tier 1**: `/analyze`, `/improve`, `/build`, `/scan`, `/review` -- **Tier 2**: `/design`, `/troubleshoot`, `/task` +- **Tier 1**: `/analyze`, `/build`, `/implement`, `/improve` +- **Tier 2**: `/design`, `/task` ### Master Routing Table @@ -235,8 +231,6 @@ wave-strategies: - High complexity + critical quality → `--wave-mode --wave-validation` - Multiple operation types → `--wave-mode --adaptive-waves` -*Implementation: See `Scripts/orchestrator_implementation.py` - `select_tools()`* - #### Task Delegation Intelligence **Sub-Agent Delegation Decision Matrix**: @@ -270,8 +264,6 @@ wave-strategies: - **Enterprise Scale**: `enterprise_waves` - **Default**: `systematic_waves` -*Implementation: See `Scripts/orchestrator_implementation.py` - delegation & wave evaluation functions* - **Auto-Delegation Triggers**: ```yaml directory_threshold: diff --git a/SuperClaude/Core/PERSONAS.md b/SuperClaude/Core/PERSONAS.md index 18c2c9d..b52b6db 100644 --- a/SuperClaude/Core/PERSONAS.md +++ b/SuperClaude/Core/PERSONAS.md @@ -129,9 +129,7 @@ Persona system provides specialized AI behavior patterns optimized for specific **Optimized Commands**: - `/build --api` - API design and backend build optimization -- `/deploy` - Reliability and monitoring in deployment -- `/scan --security` - Backend security and vulnerability assessment -- `/migrate` - Database and system migrations with data integrity +- `/git` - Version control and deployment workflows **Auto-Activation Triggers**: - Keywords: "API", "database", "service", "reliability" @@ -169,7 +167,6 @@ Persona system provides specialized AI behavior patterns optimized for specific - `/analyze` - Systematic, evidence-based analysis - `/troubleshoot` - Root cause identification - `/explain --detailed` - Comprehensive explanations with evidence -- `/review` - Systematic quality and pattern analysis **Auto-Activation Triggers**: - Keywords: "analyze", "investigate", "root cause" @@ -204,10 +201,8 @@ Persona system provides specialized AI behavior patterns optimized for specific - **Avoided**: Magic - UI generation doesn't align with security analysis **Optimized Commands**: -- `/scan --security` - Comprehensive vulnerability and compliance scanning -- `/improve --security` - Security hardening and vulnerability remediation - `/analyze --focus security` - Security-focused system analysis -- `/review` - Security code review and architecture assessment +- `/improve --security` - Security hardening and vulnerability remediation **Auto-Activation Triggers**: - Keywords: "vulnerability", "threat", "compliance" @@ -283,7 +278,6 @@ Persona system provides specialized AI behavior patterns optimized for specific - `/improve --quality` - Code quality and maintainability - `/cleanup` - Systematic technical debt reduction - `/analyze --quality` - Code quality assessment and improvement planning -- `/review` - Quality-focused code review **Auto-Activation Triggers**: - Keywords: "refactor", "cleanup", "technical debt" @@ -321,7 +315,6 @@ Persona system provides specialized AI behavior patterns optimized for specific - `/improve --perf` - Performance optimization with metrics validation - `/analyze --focus performance` - Performance bottleneck identification - `/test --benchmark` - Performance testing and validation -- `/review` - Performance-focused code review **Auto-Activation Triggers**: - Keywords: "optimize", "performance", "bottleneck" @@ -357,9 +350,8 @@ Persona system provides specialized AI behavior patterns optimized for specific **Optimized Commands**: - `/test` - Comprehensive testing strategy and implementation -- `/scan --quality` - Quality assessment and improvement - `/troubleshoot` - Quality issue investigation and resolution -- `/review` - Quality-focused code and system review +- `/analyze --focus quality` - Quality assessment and improvement **Auto-Activation Triggers**: - Keywords: "test", "quality", "validation" @@ -394,10 +386,8 @@ Persona system provides specialized AI behavior patterns optimized for specific - **Avoided**: Magic - UI generation doesn't align with infrastructure focus **Optimized Commands**: -- `/deploy` - Comprehensive deployment automation and validation -- `/dev-setup` - Development environment automation -- `/scan --security` - Infrastructure security and compliance -- `/migrate` - Infrastructure and system migration management +- `/git` - Version control workflows and deployment coordination +- `/analyze --focus infrastructure` - Infrastructure analysis and optimization **Auto-Activation Triggers**: - Keywords: "deploy", "infrastructure", "automation"