---
marp: true
theme: default
paginate: true
header: "{{HEADER_TITLE}}"
footer: "LearnWell Platform | {{LESSON_ID}}"
style: |
  section.cols2 { column-count: 2; column-gap: 2.2rem; }
  section.cols3 { column-count: 3; column-gap: 1.6rem; }
  section.cols2 h2:first-of-type, section.cols3 h2:first-of-type { margin-top: 0; column-span: all; }
  section.cols2 hr, section.cols3 hr { border: 0; height: 0; margin: 0; break-after: column; }
  blockquote { border-left: 4px solid #3b5bdb; background: #f4f6fb; padding: .3em .8em; border-radius: 6px; }
  blockquote.gold { border-left-color: #d97706; }
  blockquote.warn { border-left-color: #ef4444; }
  table { font-size: 0.82em; }
---
template_required_sections:
  - "🗺️ Agenda & Milestone Journey Map"
  - "⚡ Warm-Up: Diagnostic Quick-Fire"
  - "🧠 Prior Knowledge Recall"
  - "🎯 Hook Scenario: The Engineering Dilemma"
  - "💡 The Core Mental Model"
  - "📝 Implementation Blueprint"
  - "🔍 Anatomy & Mechanics"
  - "🚀 Quick Micro-Practice: Try It Now (3 Mins)"
  - "🥉 Starter Hint:"
  - "⏱️ Pacing & Success Check:"
  - "🛠️ Integrated Hands-On Lab: Capstone Mission"
  - "🎯 Mission Objective:"
  - "🚦 Formative Checkpoint: Status Calibration"
  - "🎟️ Exit Ticket & Metacognition (5 Mins)"
  - "🏁 Summary & Key Takeaways"
  - "🏆 Core Rules to Remember:"
---

<!-- Slide 1: Title & Inquiry Mission Hook -->
# 🚀 {{TITLE}}

### {{SUBTITLE}}

- **Target Level:** {{AUDIENCE}}
- **Toolchain / Stack:** {{TECH_STACK}}
- **Pacing:** {{DURATION_MINS}} mins

<!--
Presenter Notes:
- HOOK & PURPOSE: Introduce the lesson with high energy. Connect today's mission directly to a real industry practice.
- TIMING: Spend ~2 minutes max on this slide.
- COLD CALL: Ask 1 student: "Who has encountered [core problem] before?"
-->

---

<!-- Slide 2: Agenda & Journey Map -->
## 🗺️ Agenda & Milestone Journey Map

| Time | Stage | Focus Activity |
| :--: | ----- | -------------- |
{{AGENDA_ROWS}}

<!--
Presenter Notes:
- ROADMAP: Set clear expectations for each sprint.
- HIGHLIGHT: Emphasize that theory is kept minimal (~3-5 mins per burst) with immediate hands-on labs.
-->

---

<!-- Slide 3: Warm-Up & Prior Knowledge Recall -->
<!-- _class: cols2 -->
## ⚡ Warm-Up: Diagnostic Quick-Fire

### 🧠 Prior Knowledge Recall
- **Concept A:** {{RECALL_CONCEPT_A}}
- **Concept B:** {{RECALL_CONCEPT_B}}
- **Bridging Question:** {{RECALL_BRIDGE_QUESTION}}

***

> ⚡ **60-Second Challenge:**
> {{WARMUP_CHALLENGE_PROMPT}}

<!--
Presenter Notes:
- DIAGNOSTIC: Check if prerequisites are solid.
- SCAFFOLDING: If students struggle with Concept A, quickly remind them of [key intuition].
-->

---

<!-- Slide 4: Real-World Hook Scenario -->
<!-- _class: cols2 -->
## 🎯 Hook Scenario: The Engineering Dilemma

> ⚠️ **System Failure in Production:**
> {{HOOK_SCENARIO}}

- **Core Dilemma:** {{HOOK_CONSTRAINT}}
- **Why Naive Approach Fails:** {{HOOK_FAILURE_REASON}}

***

- **Engineering Mission:** {{HOOK_QUESTION}}
- **Success Target:** {{HOOK_METRIC}}

<!--
Presenter Notes:
- STAKES: Paint the authentic consequence of this failure (e.g. app crash, data loss, performance degradation).
- DO NOT reveal the solution yet! Keep curiosity high.
-->

---

<!-- [CONCEPT_MICRO_CYCLES_START] -->

<!-- Slide 5: Core Concept 1 - Mental Model & Analogy -->
<!-- _class: cols2 -->
## 🧠 Concept 1: {{CONCEPT_1_NAME}}

### 💡 The Core Mental Model
- **Definition:** {{CONCEPT_1_DEFINITION}}
- **Intuitive Analogy:** {{CONCEPT_1_ANALOGY}}
- **Why It Matters:** {{CONCEPT_1_BENEFIT}}

***

> 🎯 **Golden Rule:**
> {{CONCEPT_1_GOLDEN_RULE}}

<!--
Presenter Notes:
- TALK TRACK: Explain the analogy clearly using the everyday mental model.
- MISCONCEPTION ALERT: Students often confuse [A] with [B]. Clarify the boundary now.
-->

---

<!-- Slide 6: Architecture & Data Flow Visual -->
## 🔄 Architecture: {{CONCEPT_1_NAME}} Visualized

```mermaid
{{CONCEPT_1_MERMAID_DIAGRAM}}
```

- **Step 1 (Input):** {{FLOW_STEP_1}}
- **Step 2 (Transform):** {{FLOW_STEP_2}}
- **Step 3 (Output):** {{FLOW_STEP_3}}

<!--
Presenter Notes:
- DIAGRAM WALKTHROUGH: Trace the flow arrows step-by-step.
- COLD CALL CHECK: "What happens between Step 2 and Step 3 if the condition fails?"
-->

---

<!-- Slide 7: Syntax Anatomy & Code Demo (I Do) -->
<!-- _class: cols2 -->
## ⚙️ Code Anatomy: {{CONCEPT_1_NAME}}

### 📝 Implementation Blueprint
```{{TECH_LANGUAGE}}
{{CONCEPT_1_CODE_SNIPPET}}
```

***

### 🔍 Anatomy & Mechanics
- **Line 1-2:** {{CODE_EXPLANATION_L1}}
- **Line 3-4:** {{CODE_EXPLANATION_L2}}
- **Line 5+:** {{CODE_EXPLANATION_L3}}

> ⚠️ **Syntax Trap:** {{SYNTAX_TRAP_NOTE}}

<!--
Presenter Notes:
- LIVE DEMO: Point directly to the highlighted lines on screen.
- EMPHASIZE: Explain why this syntax was chosen over the legacy way.
-->

---

<!-- Slide 8: Quick Micro-Practice (We Do / You Do) -->
<!-- _class: cols2 -->
## 🚀 Quick Micro-Practice: Try It Now (3 Mins)

> 🎯 **Your Task:** {{MICRO_PRACTICE_TASK}}

### 🥉 Starter Hint:
```{{TECH_LANGUAGE}}
{{STARTER_CODE_HINT}}
```

***

### ⏱️ Pacing & Success Check:
- **Time limit:** 3 minutes at your workstation.
- **Expected result:** {{EXPECTED_MICRO_OUTPUT}}
- 🟢 Thumbs up when console prints expected output!

<!--
Presenter Notes:
- PACING: Start a 3-minute timer on your watch/phone.
- CIRCULATE: Walk the room immediately to catch students with setup or typo issues early.
-->

<!-- [CONCEPT_MICRO_CYCLES_END] -->

---

<!-- Slide 9: Integrated Hands-On Lab: Capstone Challenge -->
<!-- _class: cols2 -->
## 🛠️ Integrated Hands-On Lab: Capstone Mission

### 🎯 Mission Objective:
{{ADVANCED_LAB_GOAL}}

> 🥉 **Bronze Tier (Foundational)**
> - {{BRONZE_TASK_1}}
> - {{BRONZE_TASK_2}}

> 🥈 **Silver Tier (Standard)**
> - {{SILVER_TASK_1}}
> - {{SILVER_TASK_2}}

***

> 🥇 **Gold Tier (Mastery Extension)**
> - {{GOLD_TASK_1}}
> - {{GOLD_TASK_2}}

> ⚠️ **Gotcha Alert:**
> {{LAB_GOTCHA_WARNING}}

<!--
Presenter Notes:
- DIFFERENTIATION: Guide students to start at Bronze. Once Bronze tests pass, immediately challenge Silver.
- FACILITATION: Pair students up if anyone is stuck on environment issues.
-->

---

<!-- Slide 10: Formative Checkpoint: Traffic Light Assessment -->
<!-- _class: cols2 -->
## 🚦 Formative Checkpoint: Status Calibration

> ✅ **🟢 Green Light (Ready to Accelerate)**
> - Solved Bronze + Silver successfully.
> - Ready to tackle Gold tier or help peers!

> ⚠️ **🟡 Yellow Light (Need Quick Assist)**
> - Stuck on syntax or compilation error.
> - Check troubleshooting table on board.

***

> ⛔ **🔴 Red Light (Blocked)**
> - Core concept unclear.
> - Step back to Slide 6 architecture diagram.

> 💡 **Quick Self-Test Question:**
> {{CHECKPOINT_DIAGNOSTIC_QUESTION}}

<!--
Presenter Notes:
- FORMATION: Ask for hand signals (1 finger = Red, 2 = Yellow, 3 = Green).
- INTERVENTION: If >30% show Red/Yellow, spend 2 minutes addressing the single biggest sticking point on the whiteboard.
-->

---

<!-- Slide 11: Exit Ticket & Metacognitive Reflection -->
## 🎟️ Exit Ticket & Metacognition (5 Mins)

1. **Scenario 1 (Application):**  
   {{EXIT_Q1}}

2. **Scenario 2 (Diagnostic Trap):**  
   {{EXIT_Q2}}

3. **Metacognitive Self-Check:**  
   > *{{EXIT_REFLECTION}}*

<!--
Presenter Notes:
- ACCOUNTABILITY: Every student must submit their exit answers before leaving.
- REVIEW: Review submissions to calibrate pacing and review points for the next lesson.
-->

---

<!-- Slide 12: Summary & Key Takeaways -->
<!-- _class: cols2 -->
## 🏁 Summary & Key Takeaways

### 🏆 Core Rules to Remember:
- ✅ **Rule 1:** {{TAKEAWAY_1}}
- ✅ **Rule 2:** {{TAKEAWAY_2}}
- ✅ **Rule 3:** {{TAKEAWAY_3}}

***

> 🔮 **Next Milestone Preview:**
> {{NEXT_MILESTONE_PREVIEW}}
>
> *Coming up next: {{NEXT_TOPIC_TEASER}}*

<!--
Presenter Notes:
- WRAP-UP: Commend students for their progress and hard work today.
- CONNECTION: Show how today's foundation directly powers the next exciting milestone.
-->