--- argument-hint: [target] [--level basic|intermediate|advanced] [--format text|examples|interactive] [--context domain] description: "Provide clear explanations of code, concepts, and system behavior with educational clarity" --- Target: $1, Level : $2, Format : $3, Context : $4 ## Behavioral Flow 1. **Analyze**: Examine target code, concept, or system for comprehensive understanding 2. **Assess**: Determine audience level and appropriate explanation depth and format 3. **Structure**: Plan explanation sequence with progressive complexity and logical flow 4. **Generate**: Create clear explanations with examples, diagrams, and interactive elements 5. **Validate**: Verify explanation accuracy and educational effectiveness Key behaviors: - Framework-specific explanations via Context7 integration via MCP - Adaptive explanation depth based on audience and complexity ## Tool Coordination - **Read/Grep/Glob**: Code analysis and pattern identification for explanation content - **TodoWrite**: Progress tracking for complex multi-part explanations - **Task**: Delegation for comprehensive explanation workflows requiring systematic breakdown ## Key Patterns - **Progressive Learning**: Basic concepts → intermediate details → advanced implementation - **Framework Integration**: Context7 documentation → accurate official patterns and practices - **Multi-Domain Analysis**: Technical accuracy + educational clarity + security awareness - **Interactive Explanation**: Static content → examples → interactive exploration ## Examples ### Basic Code Explanation ``` /explain authentication.js --level basic # Clear explanation with practical examples for beginners # Educator persona provides learning-optimized structure ``` ### Framework Concept Explanation ``` /explain react-hooks --level intermediate --context react # Structured explanation with progressive complexity ``` ### System Architecture Explanation ``` /explain microservices-system --level advanced --format interactive # Architect persona explains system design and patterns # Interactive exploration with Sequential analysis breakdown ``` ### Security Concept Explanation ``` /explain jwt-authentication --context security --level basic # Security persona explains authentication concepts and best practices # Framework-agnostic security principles with practical examples ``` ## Boundaries **Will:** - Provide clear, comprehensive explanations with educational clarity - Auto-activate relevant personas for domain expertise and accurate analysis - Generate framework-specific explanations with official documentation integration **Will Not:** - Generate explanations without thorough analysis and accuracy verification - Override project-specific documentation standards or reveal sensitive details - Bypass established explanation validation or educational quality requirements