mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-29 16:16:08 +00:00

Files

NomenAK 219ff3905a feat: Optimize all 18 command files using @include reference system

Major streamlining achievement:
- Eliminate 2,733 lines of duplicate content across commands
- Reduce individual command files by ~70% (130-150 → 35-60 lines)
- Leverage existing shared/*.yml reference patterns
- Maintain full Claude Code compliance

Benefits:
• Single source of truth for universal content
• Guaranteed consistency across all commands
• Dramatically reduced maintenance overhead
• Massive token efficiency improvements

Implementation:
- Universal Legend: @include shared/universal-constants.yml#Universal Legend
- Universal Flags: @include shared/flag-inheritance.yml#Universal_Always
- Command patterns: References to appropriate shared/*.yml files
- Template system: Enhanced command-patterns.yml

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

Co-Authored-By: Claude <noreply@anthropic.com>

2025-06-24 22:46:52 +02:00

2.4 KiB

Raw Blame History

/explain - Provide detailed technical explanations

Legend

@include shared/universal-constants.yml#Universal_Legend

Purpose

Provide comprehensive explanations of concepts, code, or systems specified in $ARGUMENTS with appropriate depth and visual aids.

Syntax

/explain [flags] [concept/topic]

@include shared/flag-inheritance.yml#Universal_Always

Core Flags

--depth flag:

beginner: Basic concepts, simple language
intermediate: Standard technical depth
advanced: Deep technical details
expert: Cutting-edge & internals

--style flag:

tutorial: Step-by-step learning
reference: Quick lookup format
conversational: Natural dialogue
academic: Formal & thorough

--visual flag:

Include diagrams & flowcharts
Code examples with annotations
Architecture visualizations
Sequence diagrams for flows

Explanation Types

Code Explanation:

Line-by-line breakdown
Algorithm walkthrough
Design pattern usage
Performance implications
Edge cases & limitations

Concept Explanation:

Core principles
Real-world applications
Common misconceptions
Related concepts
Best practices

System Explanation:

Architecture overview
Component interactions
Data flow analysis
Scalability factors
Security considerations

Methodology

Structure:

Overview - What & why
Core concepts - Building blocks
Deep dive - How it works
Examples - Practical usage
Gotchas - Common pitfalls
Resources - Further learning

Techniques:

Analogies for complex concepts
Progressive complexity
Interactive examples
Visual representations
Real-world scenarios

Best Practices

Clarity:

Define terms before use
Build on prior knowledge
Use consistent terminology
Provide context
Summarize key points

Engagement:

Start with "why it matters"
Use relatable examples
Address common questions
Provide hands-on exercises
Link to resources

Examples

# Explain React hooks for beginners
/explain --depth beginner --style tutorial "React hooks"

# Deep dive into database indexing
/explain --depth advanced --visual "B-tree indexes"

# System architecture explanation
/explain --style reference --visual "microservices communication"

# Algorithm explanation with complexity
/explain --depth expert --think "quicksort optimization"

Deliverables

Comprehensive explanation document
Code examples & snippets
Visual diagrams if requested
Practice exercises
Resource links & references
Summary & key takeaways

2.4 KiB Raw Blame History