superclaude-org--superclaude_framework
NomenAK
40840dae0b
- Transform 28K+ token superclaude-user-guide.md into 4.5K token overview (84% reduction) - Extract specialized guides: examples-cookbook.md, troubleshooting-guide.md, best-practices.md, session-management.md, technical-architecture.md - Add comprehensive cross-references between all guides for improved navigation - Maintain professional documentation quality with technical-writer agent approach - Remove template files and consolidate agent naming (backend-engineer → backend-architect, etc.) - Update all existing guides with cross-references and related guides sections - Create logical learning paths from beginner to advanced users - Eliminate content duplication while preserving all valuable information 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
3.7 KiB
3.7 KiB
name, description, category, complexity, mcp-servers, personas
| name | description | category | complexity | mcp-servers | personas | |||||
|---|---|---|---|---|---|---|---|---|---|---|
| explain | Provide clear explanations of code, concepts, and system behavior with educational clarity | workflow | standard |
|
|
/sc:explain - Code and Concept Explanation
Triggers
- Code understanding and documentation requests for complex functionality
- System behavior explanation needs for architectural components
- Educational content generation for knowledge transfer
- Framework-specific concept clarification requirements
Usage
/sc:explain [target] [--level basic|intermediate|advanced] [--format text|examples|interactive] [--context domain]
Behavioral Flow
- Analyze: Examine target code, concept, or system for comprehensive understanding
- Assess: Determine audience level and appropriate explanation depth and format
- Structure: Plan explanation sequence with progressive complexity and logical flow
- Generate: Create clear explanations with examples, diagrams, and interactive elements
- Validate: Verify explanation accuracy and educational effectiveness
Key behaviors:
- Multi-persona coordination for domain expertise (educator, architect, security)
- Framework-specific explanations via Context7 integration
- Systematic analysis via Sequential MCP for complex concept breakdown
- Adaptive explanation depth based on audience and complexity
MCP Integration
- Sequential MCP: Auto-activated for complex multi-component analysis and structured reasoning
- Context7 MCP: Framework documentation and official pattern explanations
- Persona Coordination: Educator (learning), Architect (systems), Security (practices)
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
/sc:explain authentication.js --level basic
# Clear explanation with practical examples for beginners
# Educator persona provides learning-optimized structure
Framework Concept Explanation
/sc:explain react-hooks --level intermediate --context react
# Context7 integration for official React documentation patterns
# Structured explanation with progressive complexity
System Architecture Explanation
/sc:explain microservices-system --level advanced --format interactive
# Architect persona explains system design and patterns
# Interactive exploration with Sequential analysis breakdown
Security Concept Explanation
/sc: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