mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
3e40322d0a
Major reorganization of SuperClaude V4 Beta directories: - Moved SuperClaude-Lite content to Framework-Hooks/ - Renamed SuperClaude/ directories to Framework/ for clarity - Created separate Framework-Lite/ for lightweight variant - Consolidated hooks system under Framework-Hooks/ This restructuring aligns with the V4 Beta architecture: - Framework/: Full framework with all features - Framework-Lite/: Lightweight variant - Framework-Hooks/: Hooks system implementation Part of SuperClaude V4 Beta development roadmap. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
11 KiB
11 KiB
| name | description | allowed-tools | category | complexity | scope | mcp-integration | performance-profile | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| select-tool | Intelligent MCP tool selection based on complexity scoring and operation analysis |
|
special | high | meta |
|
specialized |
/sc:select-tool - Intelligent MCP Tool Selection
Purpose
Analyze requested operations and determine the optimal MCP tool (Serena or Morphllm) based on sophisticated complexity scoring, operation type classification, and performance requirements. This meta-system command provides intelligent routing to ensure optimal tool selection with <100ms decision time and >95% accuracy.
Usage
/sc:select-tool [operation] [--analyze] [--explain] [--force serena|morphllm]
Arguments
operation- Description of the operation to perform and analyze--analyze- Show detailed complexity analysis and scoring breakdown--explain- Explain the selection decision with confidence metrics--force serena|morphllm- Override automatic selection for testing--validate- Validate selection against actual operation requirements--dry-run- Preview selection decision without tool activation
Specialized Execution Flow
1. Unique Analysis Phase
- Operation Parsing: Extract operation type, scope, language, and complexity indicators
- Context Evaluation: Analyze file count, dependencies, and framework requirements
- Performance Assessment: Evaluate speed vs accuracy trade-offs for operation
2. Specialized Processing
- Complexity Scoring Algorithm: Apply multi-dimensional scoring based on file count, operation type, dependencies, and language complexity
- Decision Logic Matrix: Use sophisticated routing rules combining direct mappings and threshold-based selection
- Tool Capability Matching: Match operation requirements to specific tool capabilities
3. Custom Integration
- MCP Server Coordination: Seamless integration with Serena and Morphllm servers
- Framework Routing: Automatic integration with other SuperClaude commands
- Performance Optimization: Sub-100ms decision time with confidence scoring
4. Specialized Validation
- Accuracy Verification: >95% correct tool selection rate validation
- Performance Monitoring: Track decision time and execution success rates
- Fallback Testing: Verify fallback paths and error recovery
5. Custom Output Generation
- Decision Explanation: Detailed analysis output with confidence metrics
- Performance Metrics: Tool selection effectiveness and timing data
- Integration Guidance: Recommendations for command workflow optimization
Custom Architecture Features
Specialized System Integration
- Multi-Tool Coordination: Intelligent routing between Serena (LSP, symbols) and Morphllm (patterns, speed)
- Command Integration: Automatic selection logic used by refactor, edit, implement, and improve commands
- Performance Monitoring: Real-time tracking of selection accuracy and execution success
Unique Processing Capabilities
- Complexity Scoring: Multi-dimensional algorithm considering file count, operation type, dependencies, and language
- Decision Matrix: Sophisticated routing logic with direct mappings and threshold-based selection
- Capability Matching: Operation requirements matched to specific tool strengths
Custom Performance Characteristics
- Sub-100ms Decisions: Ultra-fast tool selection with performance guarantees
- 95%+ Accuracy: High-precision tool selection validated through execution tracking
- Optimal Performance: Best tool selection for operation characteristics
Advanced Specialized Features
Intelligent Routing Algorithm
- Direct Operation Mapping: symbol_operations → Serena, pattern_edits → Morphllm, memory_operations → Serena
- Complexity-Based Selection: score > 0.6 → Serena, score < 0.4 → Morphllm, 0.4-0.6 → feature-based
- Feature Requirement Analysis: needs_lsp → Serena, needs_patterns → Morphllm, needs_semantic → Serena, needs_speed → Morphllm
Multi-Dimensional Complexity Analysis
- File Count Scoring: Logarithmic scaling for multi-file operations
- Operation Type Weighting: Refactoring > renaming > editing complexity hierarchy
- Dependency Analysis: Cross-file dependencies increase complexity scores
- Language Complexity: Framework and language-specific complexity factors
Performance Optimization Patterns
- Decision Caching: Cache frequent operation patterns for instant selection
- Fallback Strategies: Serena → Morphllm → Native tools fallback chain
- Availability Checking: Real-time tool availability with graceful degradation
Specialized Tool Coordination
Custom Tool Integration
- Serena MCP: Symbol operations, multi-file refactoring, LSP integration, semantic analysis
- Morphllm MCP: Pattern-based edits, token optimization, fast apply capabilities, simple modifications
- Native Tools: Fallback coordination when MCP servers unavailable
Unique Tool Patterns
- Hybrid Intelligence: Serena for complex analysis, Morphllm for efficient execution
- Progressive Fallback: Intelligent degradation from advanced to basic tools
- Performance-Aware Selection: Speed vs capability trade-offs based on operation urgency
Tool Performance Optimization
- Sub-100ms Selection: Lightning-fast decision making with complexity scoring
- Accuracy Tracking: >95% correct selection rate with continuous validation
- Resource Awareness: Tool availability and performance characteristic consideration
Custom Error Handling
Specialized Error Categories
- Tool Unavailability: Graceful fallback when selected MCP server unavailable
- Selection Ambiguity: Handling edge cases where multiple tools could work
- Performance Degradation: Recovery when tool selection doesn't meet performance targets
Custom Recovery Strategies
- Progressive Fallback: Serena → Morphllm → Native tools with capability preservation
- Alternative Selection: Re-analyze with different parameters when initial selection fails
- Graceful Degradation: Clear explanation of limitations when optimal tools unavailable
Error Prevention
- Real-time Availability: Check tool availability before selection commitment
- Confidence Scoring: Provide uncertainty indicators for borderline selections
- Validation Hooks: Pre-execution validation of tool selection appropriateness
Integration Patterns
SuperClaude Framework Integration
- Automatic Command Integration: Used by refactor, edit, implement, improve commands
- Performance Monitoring: Integration with framework performance tracking
- Quality Gates: Selection validation within SuperClaude quality assurance cycle
Custom MCP Integration
- Serena Coordination: Symbol analysis, multi-file operations, LSP integration
- Morphllm Coordination: Pattern recognition, token optimization, fast apply operations
- Availability Management: Real-time server status and capability assessment
Specialized System Coordination
- Command Workflow: Seamless integration with other SuperClaude commands
- Performance Tracking: Selection effectiveness and execution success monitoring
- Framework Evolution: Continuous improvement of selection algorithms
Performance & Scalability
Specialized Performance Requirements
- Decision Time: <100ms for tool selection regardless of operation complexity
- Selection Accuracy: >95% correct tool selection validated through execution tracking
- Success Rate: >90% successful execution with selected tools
Custom Resource Management
- Memory Efficiency: Lightweight complexity scoring with minimal resource usage
- CPU Optimization: Fast decision algorithms with minimal computational overhead
- Cache Management: Intelligent caching of frequent operation patterns
Scalability Characteristics
- Operation Complexity: Scales from simple edits to complex multi-file refactoring
- Project Size: Handles projects from single files to large codebases
- Performance Consistency: Maintains sub-100ms decisions across all scales
Examples
Basic Specialized Operation
/sc:select-tool "fix typo in README.md"
# Result: Morphllm (simple edit, single file, token optimization beneficial)
Advanced Specialized Usage
/sc:select-tool "extract authentication logic into separate service" --analyze --explain
# Result: Serena (high complexity, architectural change, needs LSP and semantic analysis)
System-Level Operation
/sc:select-tool "rename function getUserData to fetchUserProfile across all files" --validate
# Result: Serena (symbol operation, multi-file scope, cross-file dependencies)
Meta-Operation Example
/sc:select-tool "convert all var declarations to const in JavaScript files" --dry-run --explain
# Result: Morphllm (pattern-based operation, token optimization, framework patterns)
Quality Standards
Specialized Validation Criteria
- Selection Accuracy: >95% correct tool selection validated through execution outcomes
- Performance Guarantee: <100ms decision time with complexity scoring and analysis
- Success Rate Validation: >90% successful execution with selected tools
Custom Success Metrics
- Decision Confidence: Confidence scoring for selection decisions with uncertainty indicators
- Execution Effectiveness: Track actual performance of selected tools vs alternatives
- Integration Success: Seamless integration with SuperClaude command ecosystem
Specialized Compliance Requirements
- Framework Integration: Full compliance with SuperClaude orchestration patterns
- Performance Standards: Meet or exceed specified timing and accuracy requirements
- Quality Assurance: Integration with SuperClaude quality gate validation cycle
Boundaries
This specialized command will:
- Analyze operations and select optimal MCP tools with >95% accuracy
- Provide sub-100ms decision time with detailed complexity scoring
- Integrate seamlessly with other SuperClaude commands for automatic tool routing
- Maintain high success rates through intelligent fallback and error recovery
This specialized command will not:
- Execute the actual operations (only selects tools for execution)
- Override user preferences when explicit tool selection is provided
- Compromise system stability through experimental or untested tool selections
- Make selections without proper availability verification and fallback planning