superclaude-kiro 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +190 -0
  3. package/bin/superclaude-kiro.js +38 -0
  4. package/dist/agents/sc-analyze.json +18 -0
  5. package/dist/agents/sc-implement.json +18 -0
  6. package/dist/agents/sc-pm.json +18 -0
  7. package/dist/agents/superclaude.json +18 -0
  8. package/dist/mcp/mcp-servers.json +44 -0
  9. package/dist/steering/superclaude/sc-agent.md +80 -0
  10. package/dist/steering/superclaude/sc-analyze.md +89 -0
  11. package/dist/steering/superclaude/sc-brainstorm.md +100 -0
  12. package/dist/steering/superclaude/sc-build.md +94 -0
  13. package/dist/steering/superclaude/sc-business-panel.md +90 -0
  14. package/dist/steering/superclaude/sc-cleanup.md +93 -0
  15. package/dist/steering/superclaude/sc-design.md +88 -0
  16. package/dist/steering/superclaude/sc-document.md +88 -0
  17. package/dist/steering/superclaude/sc-estimate.md +86 -0
  18. package/dist/steering/superclaude/sc-explain.md +92 -0
  19. package/dist/steering/superclaude/sc-git.md +80 -0
  20. package/dist/steering/superclaude/sc-help.md +148 -0
  21. package/dist/steering/superclaude/sc-implement.md +97 -0
  22. package/dist/steering/superclaude/sc-improve.md +93 -0
  23. package/dist/steering/superclaude/sc-index-repo.md +169 -0
  24. package/dist/steering/superclaude/sc-index.md +86 -0
  25. package/dist/steering/superclaude/sc-load.md +93 -0
  26. package/dist/steering/superclaude/sc-pm.md +592 -0
  27. package/dist/steering/superclaude/sc-recommend.md +1008 -0
  28. package/dist/steering/superclaude/sc-reflect.md +87 -0
  29. package/dist/steering/superclaude/sc-research.md +103 -0
  30. package/dist/steering/superclaude/sc-save.md +93 -0
  31. package/dist/steering/superclaude/sc-sc.md +134 -0
  32. package/dist/steering/superclaude/sc-select-tool.md +86 -0
  33. package/dist/steering/superclaude/sc-spawn.md +85 -0
  34. package/dist/steering/superclaude/sc-spec-panel.md +428 -0
  35. package/dist/steering/superclaude/sc-task.md +89 -0
  36. package/dist/steering/superclaude/sc-test.md +93 -0
  37. package/dist/steering/superclaude/sc-troubleshoot.md +88 -0
  38. package/dist/steering/superclaude/sc-workflow.md +97 -0
  39. package/package.json +52 -0
  40. package/src/cli.js +23 -0
  41. package/src/converter.js +63 -0
  42. package/src/installer.js +319 -0
  43. package/src/utils.js +105 -0
  44. package/templates/cli-settings.json +7 -0
@@ -0,0 +1,94 @@
1
+ ---
2
+ inclusion: manual
3
+ ---
4
+
5
+ # SuperClaude: build
6
+
7
+ > Converted from Claude Code SuperClaude framework
8
+ > Original: ~/.claude/commands/sc/build.md
9
+
10
+ # /sc:build - Project Building and Packaging
11
+
12
+ ## Triggers
13
+ - Project compilation and packaging requests for different environments
14
+ - Build optimization and artifact generation needs
15
+ - Error debugging during build processes
16
+ - Deployment preparation and artifact packaging requirements
17
+
18
+ ## Usage
19
+ ```
20
+ /sc:build [target] [--type dev|prod|test] [--clean] [--optimize] [--verbose]
21
+ ```
22
+
23
+ ## Behavioral Flow
24
+ 1. **Analyze**: Project structure, build configurations, and dependency manifests
25
+ 2. **Validate**: Build environment, dependencies, and required toolchain components
26
+ 3. **Execute**: Build process with real-time monitoring and error detection
27
+ 4. **Optimize**: Build artifacts, apply optimizations, and minimize bundle sizes
28
+ 5. **Package**: Generate deployment artifacts and comprehensive build reports
29
+
30
+ Key behaviors:
31
+ - Configuration-driven build orchestration with dependency validation
32
+ - Intelligent error analysis with actionable resolution guidance
33
+ - Environment-specific optimization (dev/prod/test configurations)
34
+ - Comprehensive build reporting with timing metrics and artifact analysis
35
+
36
+ ## MCP Integration
37
+ - **Playwright MCP**: Auto-activated for build validation and UI testing during builds
38
+ - **DevOps Engineer Persona**: Activated for build optimization and deployment preparation
39
+ - **Enhanced Capabilities**: Build pipeline integration, performance monitoring, artifact validation
40
+
41
+ ## Tool Coordination
42
+ - **Bash**: Build system execution and process management
43
+ - **Read**: Configuration analysis and manifest inspection
44
+ - **Grep**: Error parsing and build log analysis
45
+ - **Glob**: Artifact discovery and validation
46
+ - **Write**: Build reports and deployment documentation
47
+
48
+ ## Key Patterns
49
+ - **Environment Builds**: dev/prod/test → appropriate configuration and optimization
50
+ - **Error Analysis**: Build failures → diagnostic analysis and resolution guidance
51
+ - **Optimization**: Artifact analysis → size reduction and performance improvements
52
+ - **Validation**: Build verification → quality gates and deployment readiness
53
+
54
+ ## Examples
55
+
56
+ ### Standard Project Build
57
+ ```
58
+ /sc:build
59
+ # Builds entire project using default configuration
60
+ # Generates artifacts and comprehensive build report
61
+ ```
62
+
63
+ ### Production Optimization Build
64
+ ```
65
+ /sc:build --type prod --clean --optimize
66
+ # Clean production build with advanced optimizations
67
+ # Minification, tree-shaking, and deployment preparation
68
+ ```
69
+
70
+ ### Targeted Component Build
71
+ ```
72
+ /sc:build frontend --verbose
73
+ # Builds specific project component with detailed output
74
+ # Real-time progress monitoring and diagnostic information
75
+ ```
76
+
77
+ ### Development Build with Validation
78
+ ```
79
+ /sc:build --type dev --validate
80
+ # Development build with Playwright validation
81
+ # UI testing and build verification integration
82
+ ```
83
+
84
+ ## Boundaries
85
+
86
+ **Will:**
87
+ - Execute project build systems using existing configurations
88
+ - Provide comprehensive error analysis and optimization recommendations
89
+ - Generate deployment-ready artifacts with detailed reporting
90
+
91
+ **Will Not:**
92
+ - Modify build system configuration or create new build scripts
93
+ - Install missing build dependencies or development tools
94
+ - Execute deployment operations beyond artifact preparation
@@ -0,0 +1,90 @@
1
+ ---
2
+ inclusion: manual
3
+ ---
4
+
5
+ # SuperClaude: business-panel
6
+
7
+ > Converted from Claude Code SuperClaude framework
8
+ > Original: ~/.claude/commands/sc/business-panel.md
9
+
10
+ # /sc:business-panel - Business Panel Analysis System
11
+
12
+ ```yaml
13
+ ---
14
+ command: "/sc:business-panel"
15
+ category: "Analysis & Strategic Planning"
16
+ purpose: "Multi-expert business analysis with adaptive interaction modes"
17
+ wave-enabled: true
18
+ performance-profile: "complex"
19
+ ---
20
+ ```
21
+
22
+ ## Overview
23
+
24
+ AI facilitated panel discussion between renowned business thought leaders analyzing documents through their distinct frameworks and methodologies.
25
+
26
+ ## Expert Panel
27
+
28
+ ### Available Experts
29
+ - **Clayton Christensen**: Disruption Theory, Jobs-to-be-Done
30
+ - **Michael Porter**: Competitive Strategy, Five Forces
31
+ - **Peter Drucker**: Management Philosophy, MBO
32
+ - **Seth Godin**: Marketing Innovation, Tribe Building
33
+ - **W. Chan Kim & Renée Mauborgne**: Blue Ocean Strategy
34
+ - **Jim Collins**: Organizational Excellence, Good to Great
35
+ - **Nassim Nicholas Taleb**: Risk Management, Antifragility
36
+ - **Donella Meadows**: Systems Thinking, Leverage Points
37
+ - **Jean-luc Doumont**: Communication Systems, Structured Clarity
38
+
39
+ ## Analysis Modes
40
+
41
+ ### Phase 1: DISCUSSION (Default)
42
+ Collaborative analysis where experts build upon each other's insights through their frameworks.
43
+
44
+ ### Phase 2: DEBATE
45
+ Adversarial analysis activated when experts disagree or for controversial topics.
46
+
47
+ ### Phase 3: SOCRATIC INQUIRY
48
+ Question-driven exploration for deep learning and strategic thinking development.
49
+
50
+ ## Usage
51
+
52
+ ### Basic Usage
53
+ ```bash
54
+ /sc:business-panel [document_path_or_content]
55
+ ```
56
+
57
+ ### Advanced Options
58
+ ```bash
59
+ /sc:business-panel [content] --experts "porter,christensen,meadows"
60
+ /sc:business-panel [content] --mode debate
61
+ /sc:business-panel [content] --focus "competitive-analysis"
62
+ /sc:business-panel [content] --synthesis-only
63
+ ```
64
+
65
+ ### Mode Commands
66
+ - `--mode discussion` - Collaborative analysis (default)
67
+ - `--mode debate` - Challenge and stress-test ideas
68
+ - `--mode socratic` - Question-driven exploration
69
+ - `--mode adaptive` - System selects based on content
70
+
71
+ ### Expert Selection
72
+ - `--experts "name1,name2,name3"` - Select specific experts
73
+ - `--focus domain` - Auto-select experts for domain
74
+ - `--all-experts` - Include all 9 experts
75
+
76
+ ### Output Options
77
+ - `--synthesis-only` - Skip detailed analysis, show synthesis
78
+ - `--structured` - Use symbol system for efficiency
79
+ - `--verbose` - Full detailed analysis
80
+ - `--questions` - Focus on strategic questions
81
+
82
+ ## Auto-Persona Activation
83
+ - **Auto-Activates**: Analyzer, Architect, Mentor personas
84
+ - **MCP Integration**: Sequential (primary), Context7 (business patterns)
85
+ - **Tool Orchestration**: Read, Grep, Write, MultiEdit, TodoWrite
86
+
87
+ ## Integration Notes
88
+ - Compatible with all thinking flags (--think, --think-hard, --ultrathink)
89
+ - Supports wave orchestration for comprehensive business analysis
90
+ - Integrates with scribe persona for professional business communication
@@ -0,0 +1,93 @@
1
+ ---
2
+ inclusion: manual
3
+ ---
4
+
5
+ # SuperClaude: cleanup
6
+
7
+ > Converted from Claude Code SuperClaude framework
8
+ > Original: ~/.claude/commands/sc/cleanup.md
9
+
10
+ # /sc:cleanup - Code and Project Cleanup
11
+
12
+ ## Triggers
13
+ - Code maintenance and technical debt reduction requests
14
+ - Dead code removal and import optimization needs
15
+ - Project structure improvement and organization requirements
16
+ - Codebase hygiene and quality improvement initiatives
17
+
18
+ ## Usage
19
+ ```
20
+ /sc:cleanup [target] [--type code|imports|files|all] [--safe|--aggressive] [--interactive]
21
+ ```
22
+
23
+ ## Behavioral Flow
24
+ 1. **Analyze**: Assess cleanup opportunities and safety considerations across target scope
25
+ 2. **Plan**: Choose cleanup approach and activate relevant personas for domain expertise
26
+ 3. **Execute**: Apply systematic cleanup with intelligent dead code detection and removal
27
+ 4. **Validate**: Ensure no functionality loss through testing and safety verification
28
+ 5. **Report**: Generate cleanup summary with recommendations for ongoing maintenance
29
+
30
+ Key behaviors:
31
+ - Multi-persona coordination (architect, quality, security) based on cleanup type
32
+ - Framework-specific cleanup patterns via Context7 MCP integration
33
+ - Systematic analysis via Sequential MCP for complex cleanup operations
34
+ - Safety-first approach with backup and rollback capabilities
35
+
36
+ ## MCP Integration
37
+ - **Sequential MCP**: Auto-activated for complex multi-step cleanup analysis and planning
38
+ - **Context7 MCP**: Framework-specific cleanup patterns and best practices
39
+ - **Persona Coordination**: Architect (structure), Quality (debt), Security (credentials)
40
+
41
+ ## Tool Coordination
42
+ - **Read/Grep/Glob**: Code analysis and pattern detection for cleanup opportunities
43
+ - **Edit/MultiEdit**: Safe code modification and structure optimization
44
+ - **TodoWrite**: Progress tracking for complex multi-file cleanup operations
45
+ - **Task**: Delegation for large-scale cleanup workflows requiring systematic coordination
46
+
47
+ ## Key Patterns
48
+ - **Dead Code Detection**: Usage analysis → safe removal with dependency validation
49
+ - **Import Optimization**: Dependency analysis → unused import removal and organization
50
+ - **Structure Cleanup**: Architectural analysis → file organization and modular improvements
51
+ - **Safety Validation**: Pre/during/post checks → preserve functionality throughout cleanup
52
+
53
+ ## Examples
54
+
55
+ ### Safe Code Cleanup
56
+ ```
57
+ /sc:cleanup src/ --type code --safe
58
+ # Conservative cleanup with automatic safety validation
59
+ # Removes dead code while preserving all functionality
60
+ ```
61
+
62
+ ### Import Optimization
63
+ ```
64
+ /sc:cleanup --type imports --preview
65
+ # Analyzes and shows unused import cleanup without execution
66
+ # Framework-aware optimization via Context7 patterns
67
+ ```
68
+
69
+ ### Comprehensive Project Cleanup
70
+ ```
71
+ /sc:cleanup --type all --interactive
72
+ # Multi-domain cleanup with user guidance for complex decisions
73
+ # Activates all personas for comprehensive analysis
74
+ ```
75
+
76
+ ### Framework-Specific Cleanup
77
+ ```
78
+ /sc:cleanup components/ --aggressive
79
+ # Thorough cleanup with Context7 framework patterns
80
+ # Sequential analysis for complex dependency management
81
+ ```
82
+
83
+ ## Boundaries
84
+
85
+ **Will:**
86
+ - Systematically clean code, remove dead code, and optimize project structure
87
+ - Provide comprehensive safety validation with backup and rollback capabilities
88
+ - Apply intelligent cleanup algorithms with framework-specific pattern recognition
89
+
90
+ **Will Not:**
91
+ - Remove code without thorough safety analysis and validation
92
+ - Override project-specific cleanup exclusions or architectural constraints
93
+ - Apply cleanup operations that compromise functionality or introduce bugs
@@ -0,0 +1,88 @@
1
+ ---
2
+ inclusion: manual
3
+ ---
4
+
5
+ # SuperClaude: design
6
+
7
+ > Converted from Claude Code SuperClaude framework
8
+ > Original: ~/.claude/commands/sc/design.md
9
+
10
+ # /sc:design - System and Component Design
11
+
12
+ ## Triggers
13
+ - Architecture planning and system design requests
14
+ - API specification and interface design needs
15
+ - Component design and technical specification requirements
16
+ - Database schema and data model design requests
17
+
18
+ ## Usage
19
+ ```
20
+ /sc:design [target] [--type architecture|api|component|database] [--format diagram|spec|code]
21
+ ```
22
+
23
+ ## Behavioral Flow
24
+ 1. **Analyze**: Examine target requirements and existing system context
25
+ 2. **Plan**: Define design approach and structure based on type and format
26
+ 3. **Design**: Create comprehensive specifications with industry best practices
27
+ 4. **Validate**: Ensure design meets requirements and maintainability standards
28
+ 5. **Document**: Generate clear design documentation with diagrams and specifications
29
+
30
+ Key behaviors:
31
+ - Requirements-driven design approach with scalability considerations
32
+ - Industry best practices integration for maintainable solutions
33
+ - Multi-format output (diagrams, specifications, code) based on needs
34
+ - Validation against existing system architecture and constraints
35
+
36
+ ## Tool Coordination
37
+ - **Read**: Requirements analysis and existing system examination
38
+ - **Grep/Glob**: Pattern analysis and system structure investigation
39
+ - **Write**: Design documentation and specification generation
40
+ - **Bash**: External design tool integration when needed
41
+
42
+ ## Key Patterns
43
+ - **Architecture Design**: Requirements → system structure → scalability planning
44
+ - **API Design**: Interface specification → RESTful/GraphQL patterns → documentation
45
+ - **Component Design**: Functional requirements → interface design → implementation guidance
46
+ - **Database Design**: Data requirements → schema design → relationship modeling
47
+
48
+ ## Examples
49
+
50
+ ### System Architecture Design
51
+ ```
52
+ /sc:design user-management-system --type architecture --format diagram
53
+ # Creates comprehensive system architecture with component relationships
54
+ # Includes scalability considerations and best practices
55
+ ```
56
+
57
+ ### API Specification Design
58
+ ```
59
+ /sc:design payment-api --type api --format spec
60
+ # Generates detailed API specification with endpoints and data models
61
+ # Follows RESTful design principles and industry standards
62
+ ```
63
+
64
+ ### Component Interface Design
65
+ ```
66
+ /sc:design notification-service --type component --format code
67
+ # Designs component interfaces with clear contracts and dependencies
68
+ # Provides implementation guidance and integration patterns
69
+ ```
70
+
71
+ ### Database Schema Design
72
+ ```
73
+ /sc:design e-commerce-db --type database --format diagram
74
+ # Creates database schema with entity relationships and constraints
75
+ # Includes normalization and performance considerations
76
+ ```
77
+
78
+ ## Boundaries
79
+
80
+ **Will:**
81
+ - Create comprehensive design specifications with industry best practices
82
+ - Generate multiple format outputs (diagrams, specs, code) based on requirements
83
+ - Validate designs against maintainability and scalability standards
84
+
85
+ **Will Not:**
86
+ - Generate actual implementation code (use /sc:implement for implementation)
87
+ - Modify existing system architecture without explicit design approval
88
+ - Create designs that violate established architectural constraints
@@ -0,0 +1,88 @@
1
+ ---
2
+ inclusion: manual
3
+ ---
4
+
5
+ # SuperClaude: document
6
+
7
+ > Converted from Claude Code SuperClaude framework
8
+ > Original: ~/.claude/commands/sc/document.md
9
+
10
+ # /sc:document - Focused Documentation Generation
11
+
12
+ ## Triggers
13
+ - Documentation requests for specific components, functions, or features
14
+ - API documentation and reference material generation needs
15
+ - Code comment and inline documentation requirements
16
+ - User guide and technical documentation creation requests
17
+
18
+ ## Usage
19
+ ```
20
+ /sc:document [target] [--type inline|external|api|guide] [--style brief|detailed]
21
+ ```
22
+
23
+ ## Behavioral Flow
24
+ 1. **Analyze**: Examine target component structure, interfaces, and functionality
25
+ 2. **Identify**: Determine documentation requirements and target audience context
26
+ 3. **Generate**: Create appropriate documentation content based on type and style
27
+ 4. **Format**: Apply consistent structure and organizational patterns
28
+ 5. **Integrate**: Ensure compatibility with existing project documentation ecosystem
29
+
30
+ Key behaviors:
31
+ - Code structure analysis with API extraction and usage pattern identification
32
+ - Multi-format documentation generation (inline, external, API reference, guides)
33
+ - Consistent formatting and cross-reference integration
34
+ - Language-specific documentation patterns and conventions
35
+
36
+ ## Tool Coordination
37
+ - **Read**: Component analysis and existing documentation review
38
+ - **Grep**: Reference extraction and pattern identification
39
+ - **Write**: Documentation file creation with proper formatting
40
+ - **Glob**: Multi-file documentation projects and organization
41
+
42
+ ## Key Patterns
43
+ - **Inline Documentation**: Code analysis → JSDoc/docstring generation → inline comments
44
+ - **API Documentation**: Interface extraction → reference material → usage examples
45
+ - **User Guides**: Feature analysis → tutorial content → implementation guidance
46
+ - **External Docs**: Component overview → detailed specifications → integration instructions
47
+
48
+ ## Examples
49
+
50
+ ### Inline Code Documentation
51
+ ```
52
+ /sc:document src/auth/login.js --type inline
53
+ # Generates JSDoc comments with parameter and return descriptions
54
+ # Adds comprehensive inline documentation for functions and classes
55
+ ```
56
+
57
+ ### API Reference Generation
58
+ ```
59
+ /sc:document src/api --type api --style detailed
60
+ # Creates comprehensive API documentation with endpoints and schemas
61
+ # Generates usage examples and integration guidelines
62
+ ```
63
+
64
+ ### User Guide Creation
65
+ ```
66
+ /sc:document payment-module --type guide --style brief
67
+ # Creates user-focused documentation with practical examples
68
+ # Focuses on implementation patterns and common use cases
69
+ ```
70
+
71
+ ### Component Documentation
72
+ ```
73
+ /sc:document components/ --type external
74
+ # Generates external documentation files for component library
75
+ # Includes props, usage examples, and integration patterns
76
+ ```
77
+
78
+ ## Boundaries
79
+
80
+ **Will:**
81
+ - Generate focused documentation for specific components and features
82
+ - Create multiple documentation formats based on target audience needs
83
+ - Integrate with existing documentation ecosystems and maintain consistency
84
+
85
+ **Will Not:**
86
+ - Generate documentation without proper code analysis and context understanding
87
+ - Override existing documentation standards or project-specific conventions
88
+ - Create documentation that exposes sensitive implementation details
@@ -0,0 +1,86 @@
1
+ ---
2
+ inclusion: manual
3
+ ---
4
+
5
+ # SuperClaude: estimate
6
+
7
+ > Converted from Claude Code SuperClaude framework
8
+ > Original: ~/.claude/commands/sc/estimate.md
9
+
10
+ # /sc:estimate - Development Estimation
11
+
12
+ ## Triggers
13
+ - Development planning requiring time, effort, or complexity estimates
14
+ - Project scoping and resource allocation decisions
15
+ - Feature breakdown needing systematic estimation methodology
16
+ - Risk assessment and confidence interval analysis requirements
17
+
18
+ ## Usage
19
+ ```
20
+ /sc:estimate [target] [--type time|effort|complexity] [--unit hours|days|weeks] [--breakdown]
21
+ ```
22
+
23
+ ## Behavioral Flow
24
+ 1. **Analyze**: Examine scope, complexity factors, dependencies, and framework patterns
25
+ 2. **Calculate**: Apply estimation methodology with historical benchmarks and complexity scoring
26
+ 3. **Validate**: Cross-reference estimates with project patterns and domain expertise
27
+ 4. **Present**: Provide detailed breakdown with confidence intervals and risk assessment
28
+ 5. **Track**: Document estimation accuracy for continuous methodology improvement
29
+
30
+ Key behaviors:
31
+ - Multi-persona coordination (architect, performance, project-manager) based on estimation scope
32
+ - Sequential MCP integration for systematic analysis and complexity assessment
33
+ - Context7 MCP integration for framework-specific patterns and historical benchmarks
34
+ - Intelligent breakdown analysis with confidence intervals and risk factors
35
+
36
+ ## MCP Integration
37
+ - **Sequential MCP**: Complex multi-step estimation analysis and systematic complexity assessment
38
+ - **Context7 MCP**: Framework-specific estimation patterns and historical benchmark data
39
+ - **Persona Coordination**: Architect (design complexity), Performance (optimization effort), Project Manager (timeline)
40
+
41
+ ## Tool Coordination
42
+ - **Read/Grep/Glob**: Codebase analysis for complexity assessment and scope evaluation
43
+ - **TodoWrite**: Estimation breakdown and progress tracking for complex estimation workflows
44
+ - **Task**: Advanced delegation for multi-domain estimation requiring systematic coordination
45
+ - **Bash**: Project analysis and dependency evaluation for accurate complexity scoring
46
+
47
+ ## Key Patterns
48
+ - **Scope Analysis**: Project requirements → complexity factors → framework patterns → risk assessment
49
+ - **Estimation Methodology**: Time-based → Effort-based → Complexity-based → Cost-based approaches
50
+ - **Multi-Domain Assessment**: Architecture complexity → Performance requirements → Project timeline
51
+ - **Validation Framework**: Historical benchmarks → cross-validation → confidence intervals → accuracy tracking
52
+
53
+ ## Examples
54
+
55
+ ### Feature Development Estimation
56
+ ```
57
+ /sc:estimate "user authentication system" --type time --unit days --breakdown
58
+ # Systematic analysis: Database design (2 days) + Backend API (3 days) + Frontend UI (2 days) + Testing (1 day)
59
+ # Total: 8 days with 85% confidence interval
60
+ ```
61
+
62
+ ### Project Complexity Assessment
63
+ ```
64
+ /sc:estimate "migrate monolith to microservices" --type complexity --breakdown
65
+ # Architecture complexity analysis with risk factors and dependency mapping
66
+ # Multi-persona coordination for comprehensive assessment
67
+ ```
68
+
69
+ ### Performance Optimization Effort
70
+ ```
71
+ /sc:estimate "optimize application performance" --type effort --unit hours
72
+ # Performance persona analysis with benchmark comparisons
73
+ # Effort breakdown by optimization category and expected impact
74
+ ```
75
+
76
+ ## Boundaries
77
+
78
+ **Will:**
79
+ - Provide systematic development estimates with confidence intervals and risk assessment
80
+ - Apply multi-persona coordination for comprehensive complexity analysis
81
+ - Generate detailed breakdown analysis with historical benchmark comparisons
82
+
83
+ **Will Not:**
84
+ - Guarantee estimate accuracy without proper scope analysis and validation
85
+ - Provide estimates without appropriate domain expertise and complexity assessment
86
+ - Override historical benchmarks without clear justification and analysis
@@ -0,0 +1,92 @@
1
+ ---
2
+ inclusion: manual
3
+ ---
4
+
5
+ # SuperClaude: explain
6
+
7
+ > Converted from Claude Code SuperClaude framework
8
+ > Original: ~/.claude/commands/sc/explain.md
9
+
10
+ # /sc:explain - Code and Concept Explanation
11
+
12
+ ## Triggers
13
+ - Code understanding and documentation requests for complex functionality
14
+ - System behavior explanation needs for architectural components
15
+ - Educational content generation for knowledge transfer
16
+ - Framework-specific concept clarification requirements
17
+
18
+ ## Usage
19
+ ```
20
+ /sc:explain [target] [--level basic|intermediate|advanced] [--format text|examples|interactive] [--context domain]
21
+ ```
22
+
23
+ ## Behavioral Flow
24
+ 1. **Analyze**: Examine target code, concept, or system for comprehensive understanding
25
+ 2. **Assess**: Determine audience level and appropriate explanation depth and format
26
+ 3. **Structure**: Plan explanation sequence with progressive complexity and logical flow
27
+ 4. **Generate**: Create clear explanations with examples, diagrams, and interactive elements
28
+ 5. **Validate**: Verify explanation accuracy and educational effectiveness
29
+
30
+ Key behaviors:
31
+ - Multi-persona coordination for domain expertise (educator, architect, security)
32
+ - Framework-specific explanations via Context7 integration
33
+ - Systematic analysis via Sequential MCP for complex concept breakdown
34
+ - Adaptive explanation depth based on audience and complexity
35
+
36
+ ## MCP Integration
37
+ - **Sequential MCP**: Auto-activated for complex multi-component analysis and structured reasoning
38
+ - **Context7 MCP**: Framework documentation and official pattern explanations
39
+ - **Persona Coordination**: Educator (learning), Architect (systems), Security (practices)
40
+
41
+ ## Tool Coordination
42
+ - **Read/Grep/Glob**: Code analysis and pattern identification for explanation content
43
+ - **TodoWrite**: Progress tracking for complex multi-part explanations
44
+ - **Task**: Delegation for comprehensive explanation workflows requiring systematic breakdown
45
+
46
+ ## Key Patterns
47
+ - **Progressive Learning**: Basic concepts → intermediate details → advanced implementation
48
+ - **Framework Integration**: Context7 documentation → accurate official patterns and practices
49
+ - **Multi-Domain Analysis**: Technical accuracy + educational clarity + security awareness
50
+ - **Interactive Explanation**: Static content → examples → interactive exploration
51
+
52
+ ## Examples
53
+
54
+ ### Basic Code Explanation
55
+ ```
56
+ /sc:explain authentication.js --level basic
57
+ # Clear explanation with practical examples for beginners
58
+ # Educator persona provides learning-optimized structure
59
+ ```
60
+
61
+ ### Framework Concept Explanation
62
+ ```
63
+ /sc:explain react-hooks --level intermediate --context react
64
+ # Context7 integration for official React documentation patterns
65
+ # Structured explanation with progressive complexity
66
+ ```
67
+
68
+ ### System Architecture Explanation
69
+ ```
70
+ /sc:explain microservices-system --level advanced --format interactive
71
+ # Architect persona explains system design and patterns
72
+ # Interactive exploration with Sequential analysis breakdown
73
+ ```
74
+
75
+ ### Security Concept Explanation
76
+ ```
77
+ /sc:explain jwt-authentication --context security --level basic
78
+ # Security persona explains authentication concepts and best practices
79
+ # Framework-agnostic security principles with practical examples
80
+ ```
81
+
82
+ ## Boundaries
83
+
84
+ **Will:**
85
+ - Provide clear, comprehensive explanations with educational clarity
86
+ - Auto-activate relevant personas for domain expertise and accurate analysis
87
+ - Generate framework-specific explanations with official documentation integration
88
+
89
+ **Will Not:**
90
+ - Generate explanations without thorough analysis and accuracy verification
91
+ - Override project-specific documentation standards or reveal sensitive details
92
+ - Bypass established explanation validation or educational quality requirements