Files
gh-dotclaude-marketplace-pl…/commands/teach_concept.md
2025-11-29 18:23:46 +08:00

14 KiB

model, allowed-tools, argument-hint, description
model allowed-tools argument-hint description
claude-opus-4-1 Task, Write, Read, Bash(*), Glob, Grep <concept> <learner-sophistication> [--approach=<pedagogical-method>] [--pathway=<learning-style>] Adaptive concept exploration with scaffolded discovery and multiple learning pathways

Adaptive Concept Exploration System

Transform complex concepts into accessible learning experiences through scaffolded discovery, multiple learning modalities, and adaptive complexity progression. Create personalized learning journeys that honor different ways of knowing while building deep, transferable understanding.

Learner Sophistication Framework

Novice Level (New to concept domain)

[Extended thinking: Learners need concrete examples, basic vocabulary introduction, heavy scaffolding, and emotional safety. Focus on building foundational understanding with frequent validation and encouragement.]

Characteristics:

  • Limited domain vocabulary with need for terminology introduction
  • Concrete thinking preferences with metaphor and analogy support
  • Step-by-step guidance requirements with clear progression markers
  • Anxiety about complexity with need for confidence building
  • Pattern recognition development with example-based learning

Teaching Adaptations:

  • Start with familiar analogies and concrete examples
  • Introduce vocabulary gradually with context and usage
  • Break complex ideas into digestible components
  • Provide frequent validation and encouragement
  • Create safe spaces for questions and confusion

Intermediate Level (Some domain familiarity)

[Extended thinking: Learners have basic foundation but need help connecting concepts and building systematic understanding. Ready for moderate complexity with guided discovery.]

Characteristics:

  • Basic vocabulary familiarity with need for deeper understanding
  • Pattern recognition ability with connection-making development
  • Moderate abstraction comfort with conceptual thinking emergence
  • Question formulation capability with curiosity-driven exploration
  • System thinking development with relationship awareness

Teaching Adaptations:

  • Build on existing knowledge with connection emphasis
  • Encourage question formulation and curiosity exploration
  • Introduce systematic thinking with framework building
  • Use guided discovery with structured exploration
  • Balance challenge with support for optimal growth

Advanced Level (Strong domain foundation)

[Extended thinking: Learners can handle complexity and abstraction, benefit from collaborative exploration, and are ready for nuanced understanding with edge case consideration.]

Characteristics:

  • Strong vocabulary fluency with technical communication capability
  • Abstract thinking comfort with conceptual manipulation
  • System perspective with interdisciplinary connection ability
  • Critical thinking development with assumption questioning
  • Innovation potential with creative application capability

Teaching Adaptations:

  • Engage in peer-level dialogue with intellectual partnership
  • Explore edge cases and boundary conditions
  • Encourage creative applications and innovations
  • Facilitate cross-domain connections and transfer
  • Support original thinking and paradigm questioning

Expert Level (Domain mastery)

[Extended thinking: Learners are domain experts seeking cutting-edge insights, paradigm expansion, or teaching capability development. Focus on research-level exploration and meta-cognitive development.]

Characteristics:

  • Domain mastery with deep conceptual understanding
  • Research-level thinking with paradigm awareness
  • Teaching capability with knowledge transfer skills
  • Innovation leadership with breakthrough thinking
  • Meta-cognitive sophistication with learning process awareness

Teaching Adaptations:

  • Collaborative exploration at research level
  • Paradigm challenging and assumption questioning
  • Support teaching and mentoring skill development
  • Facilitate breakthrough thinking and innovation
  • Meta-cognitive process optimization and refinement

Pedagogical Approach Framework

Socratic Method

[Extended thinking: Question-driven exploration that leads learners to discover insights through guided inquiry. Optimal for developing critical thinking and deep understanding.]

Implementation Protocol:

  • Strategic question sequencing with progressive complexity
  • Assumption exploration through targeted inquiry
  • Evidence examination with critical evaluation
  • Perspective expansion through alternative consideration
  • Insight facilitation through guided discovery

Question Categories:

  • Clarification: "What exactly do you mean when you say..."
  • Assumption: "What assumptions are underlying this idea..."
  • Evidence: "What evidence supports this perspective..."
  • Perspective: "How might others view this differently..."
  • Implication: "If this is true, what follows..."
  • Meta: "How does this connect to what we know about..."

Constructivist Approach

[Extended thinking: Building new understanding on existing knowledge foundations. Optimal for creating connections and ensuring meaningful learning.]

Implementation Protocol:

  • Prior knowledge activation with connection building
  • Conceptual bridge construction with scaffolded transitions
  • Active meaning construction with learner participation
  • Knowledge integration with existing understanding
  • Transfer facilitation with application opportunities

Building Strategies:

  • Foundation Assessment: Understanding current knowledge state
  • Bridge Creation: Connecting new concepts to familiar ideas
  • Scaffolded Construction: Progressive complexity building
  • Integration Facilitation: Weaving new and existing knowledge
  • Transfer Preparation: Application readiness development

Experiential Learning

[Extended thinking: Learning through direct experience and reflection. Optimal for practical skills and deep embodied understanding.]

Implementation Protocol:

  • Direct experience creation with hands-on engagement
  • Reflection facilitation with insight extraction
  • Conceptual connection with experience integration
  • Application extension with transfer opportunities
  • Mastery development through progressive practice

Experience Design:

  • Concrete Experience: Direct engagement with concepts
  • Reflective Observation: Thoughtful analysis of experience
  • Abstract Conceptualization: Theory connection and understanding
  • Active Experimentation: Application and testing in new contexts

Multi-Modal Integration

[Extended thinking: Engaging multiple learning channels simultaneously for comprehensive understanding. Optimal for diverse learning preferences and robust knowledge construction.]

Modality Framework:

  • Visual: Diagrams, charts, spatial representations, color coding
  • Auditory: Verbal explanation, discussion, sound patterns, rhythm
  • Kinesthetic: Movement, manipulation, gesture, physical modeling
  • Logical: Analysis, reasoning, systematic thinking, pattern recognition
  • Social: Collaboration, discussion, peer interaction, community learning

Adaptive Teaching Engine

Sophistication Detection Protocol

[Extended thinking: Dynamically assess learner level through interaction patterns, vocabulary usage, question types, and response sophistication.]

Assessment Indicators:

  • Vocabulary Analysis: Technical term usage and accuracy
  • Question Quality: Depth and sophistication of inquiries
  • Connection Making: Ability to link concepts across domains
  • Abstraction Comfort: Response to complex or abstract ideas
  • Meta-Cognitive Awareness: Self-reflection and learning process understanding

Dynamic Adaptation:

  • Real-time complexity adjustment based on comprehension signals
  • Communication style modification matching learner preferences
  • Scaffolding level calibration with support optimization
  • Challenge level tuning for optimal growth zone maintenance

Emotional Intelligence Integration

[Extended thinking: Create psychologically safe learning environments that encourage intellectual risk-taking and growth.]

Safety Creation:

  • Confusion Normalization: "Confusion is the first sign of learning"
  • Mistake Reframing: "Errors provide valuable information"
  • Growth Celebration: "Notice how your thinking has evolved"
  • Courage Encouragement: "What question are you curious about?"

Motivation Optimization:

  • Autonomy Support: Learner choice and self-direction
  • Competence Building: Progressive success and mastery
  • Purpose Connection: Meaning and relevance emphasis
  • Curiosity Cultivation: Wonder and exploration encouragement

Execution Examples

Example 1: Technical Concept for Novice

teach_concept "microservices architecture" novice --approach=constructivist --pathway=visual

Teaching Flow:

  1. Foundation Building: "Let's start with something familiar - imagine a restaurant..."
  2. Analogy Development: "Monolith is like one chef doing everything, microservices like specialized stations"
  3. Visual Representation: ASCII diagrams showing service separation and communication
  4. Vocabulary Introduction: Gradually introduce "API", "service boundary", "decoupling"
  5. Scaffolded Complexity: Move from simple 2-service example to realistic architecture
  6. Validation Points: Regular comprehension checks with encouraging feedback

Example 2: Strategic Concept for Intermediate

teach_concept "product-market fit" intermediate --approach=socratic --pathway=analytical

Teaching Flow:

  1. Prior Knowledge Activation: "What experiences have you had with products that just 'clicked'?"
  2. Guided Discovery: "What made those products different from ones that didn't catch on?"
  3. Pattern Recognition: "What patterns do you notice in successful vs. unsuccessful products?"
  4. Framework Building: Help construct understanding of market needs, product capabilities, timing
  5. Application Practice: "How would you assess product-market fit for [specific example]?"
  6. Meta-Cognitive Reflection: "What process did we just use to understand this concept?"

Example 3: Complex Concept for Advanced

teach_concept "distributed consensus algorithms" advanced --approach=experiential --pathway=kinesthetic

Teaching Flow:

  1. Concrete Experience: Simulate Byzantine Generals problem with physical demonstration
  2. Problem Exploration: "What challenges emerge when coordination requires unreliable communication?"
  3. Solution Discovery: Guide through Raft algorithm development with hands-on simulation
  4. Abstraction Building: Connect physical simulation to distributed systems concepts
  5. Edge Case Exploration: "What happens under network partitions, node failures, malicious actors?"
  6. Innovation Challenge: "How might you improve on existing consensus mechanisms?"

Advanced Learning Features

Metacognitive Development

[Extended thinking: Help learners become aware of their own learning processes and develop self-teaching capabilities.]

Self-Awareness Building:

  • Learning Process Recognition: "Notice how you approached that problem"
  • Strategy Identification: "What methods work best for your understanding?"
  • Difficulty Recognition: "What signals tell you when you need different approach?"
  • Progress Tracking: "How has your thinking evolved during our exploration?"

Self-Regulation Development:

  • Goal Setting: "What specifically do you want to understand?"
  • Strategy Selection: "Which approach feels most helpful right now?"
  • Monitoring: "How well is this explanation working for you?"
  • Adjustment: "What would help clarify this concept further?"

Transfer Facilitation

[Extended thinking: Help learners recognize patterns and principles that apply across contexts, building transferable understanding.]

Pattern Recognition Development:

  • Deep Structure Identification: "What underlying principles govern this concept?"
  • Surface Feature Distinction: "What aspects are specific vs. generalizable?"
  • Analogy Construction: "Where else might these principles apply?"
  • Cross-Domain Connection: "How does this relate to concepts in other areas?"

Application Pathway Creation:

  • Near Transfer: Applications within same domain with minor variations
  • Far Transfer: Applications across different domains with pattern recognition
  • Creative Transfer: Novel applications requiring innovative thinking
  • Meta-Transfer: Understanding transfer itself as learnable skill

Success Indicators

Learning Quality Measures

  • Conceptual Understanding: Deep vs. surface level comprehension
  • Transfer Capability: Application to novel situations and contexts
  • Retention Durability: Long-term understanding maintenance
  • Connection Richness: Integration with existing knowledge networks
  • Metacognitive Development: Learning-to-learn skill enhancement

Engagement Indicators

  • Curiosity Activation: Question generation and exploration drive
  • Intellectual Risk-Taking: Willingness to engage challenging concepts
  • Active Construction: Learner participation in meaning creation
  • Joy of Discovery: Enthusiasm and satisfaction in learning process
  • Confidence Building: Increased self-efficacy and learning courage

Teaching Effectiveness

  • Adaptive Responsiveness: Real-time adjustment to learner needs
  • Scaffolding Optimization: Right level of support for growth
  • Multiple Pathway Integration: Successful multi-modal engagement
  • Emotional Safety Creation: Supportive learning environment
  • Transfer Facilitation: Successful application to new contexts

The teach_concept command embodies transformative education principles, creating learning experiences that honor learner individuality while building deep, transferable understanding through adaptive pedagogy and multiple learning pathways.