@thanh01.pmt/curriculum-kit 1.4.41 → 1.4.43

package/dist/templates/CODE_template.md

@@ -0,0 +1,70 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "CODE"
+created_by: "Curriculum OS Builder"
+phase: "P3"
+deliverable: "P3-T3"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Technical Overview & Architecture Blueprint"
+  - "Hardware Pinout & Wiring Configuration Matrix"
+  - "Starter Code Sandbox"
+  - "Verified Reference Solution Code"
+  - "Automated Test / Verification Script"
+  - "Common Syntax & Runtime Pitfalls Matrix"
+---
+
+# CODE LAB: [LESSON TITLE]
+
+## [REQUIRED] Technical Overview & Architecture Blueprint
+> How the code in this lab is structured and why. Reference the canonical
+> identifiers (files, types, functions) from the LESSON Code Symbol Ledger —
+> use those exact names, do not invent alternatives.
+
+- **Architecture:** [Mermaid or ASCII diagram of the components/data flow]
+- **Key decisions:** [2-4 bullets on design choices students should notice]
+
+## [CONDITIONAL] Hardware Pinout & Wiring Configuration Matrix
+> INCLUDE this section ONLY for lessons whose activity contract involves
+> physical hardware wiring. For pure software / theory lessons, OMIT the
+> entire section — do not emit placeholder wiring tables.
+
+| Component | Pin / Connection | Notes |
+|---|---|---|
+| [Component] | [Pin] | [Why this wiring] |
+
+## [REQUIRED] Starter Code Sandbox
+> Skeleton the students start from, with explicit TODO comments marking every
+> point they must implement.
+
+```[language]
+// [Starter code with TODO markers]
+```
+
+## [REQUIRED] Verified Reference Solution Code
+> 100% syntactically valid, production-ready, fully commented. Must satisfy
+> the verification script below.
+
+```[language]
+// [Complete reference solution]
+```
+
+## [REQUIRED] Automated Test / Verification Script
+> How to compile / run / verify: exact commands and expected output.
+
+```bash
+# [Verify commands]
+```
+
+- **Expected result:** [What success looks like]
+
+## [REQUIRED] Common Syntax & Runtime Pitfalls Matrix
+> Extract the Common Mistakes table VERBATIM from the canonical knowledge
+> context (KX). Do not re-invent or paraphrase — one canonical list per lesson.
+
+| Pitfall | Symptom | Fix |
+|---|---|---|
+| [From KX Common Mistakes] | [What the student sees] | [Concrete correction] |

package/dist/templates/CONTENT_CONTINUITY_template.md

@@ -0,0 +1,38 @@
+---
+id: "UNIT_CODE-CONTINUITY"
+title: "Content Continuity: [PROJECT_NAME]"
+type: "CONTENT_CONTINUITY"
+created_by: "Antigravity"
+phase: "P3"
+deliverable: "P3-CONT"
+version: "v2.1"
+date: "YYYY-MM-DD"
+---
+
+# CONTENT CONTINUITY: [PROJECT_NAME]
+
+## 1. Storyline & Character Development
+- **Main Character:** [Character name, e.g., Jarvis, Explorer...]
+- **Evolution:** 
+    - [Describe how the storyline develops across Units]
+
+## 2. Pedagogical Analogies & Concepts
+
+### Unit [XX]: [Topic Name]
+| Lesson | Concept | Analogy | Notes |
+|:---:|---|---|---|
+| U01_M01_L01 | [Concept] | **[Analogy]** | [Notes] |
+
+## 3. Multimedia Assets Log
+| Asset ID | Tier | Type | Content Description |
+|---|:---:|:---:|---|
+| [ID] | [1-4] | [Image/Video] | [Description] |
+
+## 4. Hardware & Materials Used
+| Component | First Seen | Role in Storyline |
+|---|---|---|
+| [Component] | [Lesson ID] | [Role in storyline] |
+
+---
+- **Global Standard:** v2.1 (Consistency Core).
+- **Last Sync:** YYYY-MM-DD.

package/dist/templates/CONTENT_STYLE_GUIDE_template.md

@@ -0,0 +1,49 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "CONTENT_STYLE_GUIDE"
+created_by: "Curriculum OS Builder"
+phase: "{{PHASE}}"
+deliverable: "P2-T3"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Voice & Tone"
+  - "Standard Terminology (Glossary)"
+  - "Examples & Context Rules"
+  - "Lesson Content Standards"
+---
+
+# CONTENT STYLE GUIDE
+
+
+## [REQUIRED] Voice & Tone
+- **Primary Persona:** [E.g., Encouraging mentor / Professional engineer / Storyteller]
+- **Target Audience Toning:** [E.g., Simple language for kids, technical rigor for seniors]
+- **Prohibited Phrases:** [E.g., "This is easy", "Just click this"]
+
+## [REQUIRED] Standard Terminology (Glossary)
+| Concept (English) | Standard Translation | Synonyms to Avoid | Context Notes |
+|---|---|---|---|
+| Variable | [translation] | [avoid] | Use the glossary translation for clarity |
+| Loop | [translation] | [avoid] | Avoid the non-coding term in coding context |
+| Debug | [translation] | [avoid] | Use the glossary translation for professionalism |
+
+## [REQUIRED] Examples & Context Rules
+- **Preferred Sources:** [E.g., Vietnamese daily life, urban/rural student context, popular games]
+- **Prohibited Contexts:** [E.g., Violence, military, weapons, religion, politics, heavy winter/snow examples for tropical regions]
+- **Explanation Structure:** [E.g., Analogy first -> Technical application second]
+
+## [REQUIRED] Lesson Content Standards
+_Every lesson written by @content must follow this flow:_
+1. **Warm-up / Hook:** [Scenario-based, e.g., opening question, short story]
+2. **Core Concepts:** [Maximum paragraphs per concept, use of bullet points]
+3. **Guided Practice:** [Code snippets with line-by-line comments]
+4. **Independent Practice:** [Space reserved for @activity inclusion]
+5. **Wrap-up & Checkpoint:** [Summary format, formative quiz type]
+
+## [OPTIONAL] Formatting & Code
+- **Code Blocks:** [E.g., Always use \`\`\`python, detailed comments on important functions]
+- **Visuals:** [E.g., Prefer Mermaid diagrams for algorithmic flowcharts]
+- **Markdown:** [E.g., Use **bold** for new keywords, `inline code` for variable names]

package/dist/templates/CURRICULUM_FRAMEWORK_template.md

@@ -0,0 +1,63 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "CURRICULUM_FRAMEWORK"
+created_by: "Curriculum OS Builder"
+phase: "{{PHASE}}"
+deliverable: "P2-T1"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Course Overview"
+  - "Global Learning Objectives"
+  - "Structural Hierarchy (Unit & Module)"
+  - "Scope & Sequence (Detailed Roadmap)"
+  - "Standard Lesson Format"
+---
+
+# CURRICULUM FRAMEWORK
+
+_Based on: LEARNER_PROFILE.md v[X]_
+
+## [REQUIRED] Course Overview
+- **Official Course Name:** [Name]
+- **Short Description:** [1–2 sentences for client/marketing materials]
+- **Primary Platform/Tools:** [E.g., Arduino Uno, Scratch 3.0, Python]
+- **Total Units:** [Number]
+- **Total Lessons:** [Number]
+- **Total Duration:** [Calculated in minutes/hours]
+
+## [REQUIRED] Global Learning Objectives
+By the end of this course, students will be able to:
+1. [Bloom Verb + Specific Content + Condition]
+2. [Bloom Verb + Specific Content + Condition]
+3. [Bloom Verb + Specific Content + Condition]
+_Note: Each objective must be measurable and observable._
+
+## [REQUIRED] Structural Hierarchy (Unit & Module)
+| Unit (UXX) | Module (UXXMYY) | Lessons | Module Objective | Lesson Codes |
+|---|---|:---:|---|---|
+| U01: [Unit 1 Name] | U01_M01: [Module Name] | [Qty] | [Specific objectives for U01_M01] | U01_M01_L01 – U01_M01_L03 |
+| U02: [Unit 2 Name] | U02_M01: [Module Name] | [Qty] | [Specific objectives for U02_M01] | U02_M01_L01 – U02_M01_L04 |
+
+## [REQUIRED] Scope & Sequence (Detailed Roadmap)
+**CONTRACT — mỗi buổi học (session) PHẢI có đúng 1 dòng, đủ 10 cột, mã bài dạng UXX_MYY_LZZ:**
+| # | Lesson Code | Title | Unit | Module | Learning Objective (Students will be able to...) | Key Concepts (Học gì) | Hands-on Deliverable (Làm được gì) | Prerequisites | Bloom | Duration (mins) |
+|---|---|---|---|---|---|---|---|---|---|:---:|
+| 01 | U01_M01_L01 | [Session title] | U01 | U01_M01 | [Measurable objective with Bloom verb: e.g. "Xác định được 4 thành phần của mạch LED"] | [Concept 1, Concept 2] | [Concrete artifact: e.g. "Mạch LED nháy cơ bản chạy trên kit thật"] | None | Understand | 90 |
+| 02 | U01_M01_L02 | [Session title] | U01 | U01_M01 | [Measurable objective] | [Concepts] | [Concrete deliverable] | U01_M01_L01 | Apply | 90 |
+
+_Rules: (a) KHÔNG truncate bằng '...' — viết ĐỦ số dòng bằng tổng số buổi của khóa; (b) Prerequisites chỉ tham chiếu mã bài TRƯỚC đó (không forward-reference); (c) Objective dùng động từ Bloom đo được (xác định/giải thích/vận dụng/thiết kế/đánh giá), không dùng 'hiểu/biết' trừu tượng; (d) Hands-on Deliverable là sản phẩm CỤ THỂ học sinh mang được ra khỏi buổi học; (e) Duration cộng lại đúng Tổng Duration của Course Overview._
+
+## [REQUIRED] Standard Lesson Format
+- **Theory Duration:** [X mins]
+- **Practice Duration:** [Y mins]
+- **Homework Included:** [Yes / No]
+- **Mini-project at end of Unit/Module:** [Yes / No]
+- **Session Resumption Protocol:** [Recap protocol for non-consecutive weekly classes]
+
+## [OPTIONAL] Standards Alignment
+| Learning Objective | Standard Code (CSTA / K12 CS / local) | Alignment Level |
+|---|---|---|
+| [Objective 1] | [E.g., TH-8.2] | [Full / Partial] |

package/dist/templates/DEPENDENCY_MAP_template.md

@@ -0,0 +1,65 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "DEPENDENCY_MAP"
+created_by: "Curriculum OS Builder"
+phase: "{{PHASE}}"
+deliverable: "{{DELIVERABLE_CODE}}"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Document Dependency Hierarchy"
+  - "Cascade Impact Rules"
+  - "Cascade Processing Protocol"
+---
+
+# CURRICULUM DEPENDENCY MAP: {{PROJECT_NAME}}
+
+_Tracks the logical flow and technical prerequisites between units and lessons to prevent fragmentation._
+
+## [REQUIRED] Document Dependency Hierarchy
+Data flows top-down. An arrow `└──` means the document below MUST read the document above before it is produced.
+
+```text
+LEARNER_PROFILE.md (Source: Client)
+ └── CURRICULUM_FRAMEWORK.md (reads Profile to design)
+      ├── ART_DIRECTION.md (reads Profile & Framework)
+      ├── CONTENT_STYLE_GUIDE.md (reads Profile & Framework)
+      ├── _content/U[XX]/L[YY]/ (lesson folders containing the artifacts)
+      │    ├── LESSON_U[XX]_M[ZZ]_L[YY].md (detailed lesson plan - reads Framework & Style Guide)
+      │    ├── ACT_U[XX]_M[ZZ]_L[YY].md (hands-on activity - reads Lesson)
+      │    └── QUIZ_U[XX]_M[ZZ]_L[YY].md (question bank & rubrics - reads Lesson & Framework)
+      │          └── CONTENT_CONTINUITY.md (registers terminology & seamless pedagogy)
+      └── ALIGNMENT_MATRIX.md (cross-checks and truth-syncs the whole system)
+            └── PACKAGES (final deliverables: Teacher, Student, Parent, Client)
+```
+
+## [REQUIRED] Cascade Impact Rules
+When a Scope Change request or Version update occurs, `@reviewer` MUST cross-check the table below to identify the affected files:
+
+| If this file changes MAJOR/MINOR... | ...then these files MUST be Reviewed/Rewritten |
+|---|---|
+| **LEARNER_PROFILE** | Everything (Framework, Lessons, Activities, Quizzes). Usually requires a restart (special gate). |
+| **CURRICULUM_FRAMEWORK** | Lessons (`LESSON_U[XX]_M[ZZ]_L[YY]`) of the changed module, `ACT_U[XX]_M[ZZ]_L[YY]`, `QUIZ_U[XX]_M[ZZ]_L[YY]`, `ALIGNMENT_MATRIX`. |
+| **CONTENT_STYLE_GUIDE** | All `LESSON_U[XX]_M[ZZ]_L[YY]` (only Tone/Style revision, no structure change), `CONTENT_CONTINUITY`. |
+| **ART_DIRECTION** | Regenerate the illustrations or circuit diagram designs affected by the new Style. |
+| **LESSON_U[XX]_M[ZZ]_L[YY] (Theory)**| `ACT_U[XX]_M[ZZ]_L[YY]` (materials may change), `QUIZ_U[XX]_M[ZZ]_L[YY]` (criteria may change), `ALIGNMENT_MATRIX`. |
+| **ACT_U[XX]_M[ZZ]_L[YY] (Hands-on)** | `QUIZ_U[XX]_M[ZZ]_L[YY]` (practical product assessment criteria may change). |
+
+## [REQUIRED] Cascade Processing Protocol
+1. Identify the original file that changed.
+2. Follow the "Propagation Rules" above to list the affected files.
+3. Build the **Cascade Impact Map** table into `PROJECT_STATUS.md` (Open Issues section) and mark 🔴 (needs rewrite) or 🟡 (needs review).
+4. Assign `@content`, `@activity`, `@assessor` to process in top-down order of the dependency diagram.
+
+## [OPTIONAL] Tool & Platform Dependencies
+| Component | Minimum Version | Required For |
+|---|---|---|
+| Arduino IDE | 2.0+ | All hardware projects |
+| Python | 3.10+ | AI and Data units |
+| n8n | 1.0+ | Automation units |
+
+---
+- **Global Standard:** v4.6 (Operational-First).
+- **Status:** ALIGNED TEMPLATE (Modular-First Architecture Alignment).

package/dist/templates/EXIT_TICKET_template.md

@@ -0,0 +1,85 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "EXIT_TICKET"
+created_by: "Curriculum OS Builder"
+phase: "{{PHASE}}"
+deliverable: "P3-T10"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Target Learning Objectives"
+  - "Recall & Conceptual Anchor"
+  - "Application & Bug Hunt"
+  - "Metacognitive Reflection & Confidence Check"
+  - "Scoring & Teacher Intervention Trigger"
+---
+<!-- INJECT_BODY -->
+
+# FORMATIVE EXIT TICKET: [LESSON TITLE]
+_Unit: U[X] | Module: M[X.X] | Lesson: Lesson [XX] | Estimated Time: 5-7 mins_
+
+## [REQUIRED] Target Learning Objectives
+- **Target LO 1 (ULO):** [The universal conceptual objective being assessed, e.g., "The learner will be able to understand the immutability of declarative views."]
+- **Target LO 2 (CIO/SIO):** [The concrete technical objective, e.g., "The learner will be able to bind state variables to UI controls using @State."]
+
+---
+
+## [REQUIRED] Part 1: Recall & Conceptual Anchor (Prompt 1)
+> *Objective: Test core mental model without allowing rote syntax memorization.*
+
+**Question 1:**  
+[Present a conceptual scenario or analogy comparison. E.g., "In SwiftUI, why does modifying a regular local variable inside `body` fail to trigger a screen re-render, whereas mutating a `@State` property causes the View to update?"]
+
+- **Student Answer Area:**  
+  ```text
+  [Write 1-2 concise sentences explaining the difference in runtime mechanism]
+  ```
+
+---
+
+## [REQUIRED] Part 2: Application & Bug Hunt (Prompt 2)
+> *Objective: Test code diagnosis and precise correction in ≤ 3 lines of modification.*
+
+**Code Snippet:**  
+```swift
+// [Provide a minimal 4-8 line realistic code snippet containing exactly 1 bug or missing annotation]
+struct CounterDisplay: View {
+    var counter: Int = 0 // Line containing deliberate bug
+    
+    var body: some View {
+        Button("Increment: \(counter)") {
+            counter += 1
+        }
+    }
+}
+```
+
+**Task:**  
+1. **Identify the Compiler/Runtime Error:** [E.g., "Cannot assign to property: 'self' is immutable"]
+2. **Corrected Line:**  
+   ```swift
+   // [Write the single corrected line of code]
+   ```
+
+---
+
+## [REQUIRED] Part 3: Metacognitive Reflection & Confidence Check (Prompt 3)
+> *Objective: Empower student self-regulation and provide immediate diagnostic signals.*
+
+**Traffic Light Self-Assessment:**  
+- [ ] 🟢 **Green (Mastered):** "I can build and explain this concept to a peer without any hints."
+- [ ] 🟡 **Yellow (Needs Practice):** "I understand the concept but got stuck on syntax or error messages."
+- [ ] 🔴 **Red (Blocked):** "I need help understanding why this architecture is used."
+
+**One Lingering Question (Exit Ticket Note):**  
+```text
+[What is one question you still have before leaving today's lab?]
+```
+
+---
+
+## [REQUIRED] Scoring & Teacher Intervention Trigger
+- **Proficiency Threshold:** Green/Yellow check + Correct Answer to Part 2 Bug Hunt.
+- **Intervention Protocol:** If $\ge 25\%$ of students mark 🔴 Red or miss Part 2, start next session with a 5-minute Live Debugging Warm-up.

package/dist/templates/EXT_template.md

@@ -0,0 +1,35 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "EXT"
+created_by: "Curriculum OS Builder"
+phase: "{{PHASE}}"
+deliverable: "P3-T8"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+---
+
+# EXTENSION TASKS: [LESSON TITLE]
+
+## For: Advanced Students / Extra Time
+
+### Challenge 1: [Challenge Name] (Difficulty: ⭐⭐⭐)
+**Description:**
+[Advanced task requirement, e.g., code optimization, adding new features, connecting additional modules].
+
+**Clues & Suggestions:**
+- Refer to documentation for `[Concept/Function]`.
+- Suggested Approach: [1-2 basic steps].
+
+**Expected Outcome:**
+[Description of the final product/result].
+
+### Challenge 2: [Challenge Name] (Difficulty: ⭐⭐⭐⭐)
+**Description:**
+[More difficult task requiring synthesis of multiple concepts].
+
+**Clues & Suggestions:**
+[Hints if applicable].
+
+**Expected Outcome:**
+[Description].

package/dist/templates/GLOSSARY_template.md

@@ -0,0 +1,108 @@
+---
+id: __ID__
+title: "__TITLE__"
+type: __TYPE__
+template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Term Glossary"
+---
+
+<!-- 
+  Created by: Curriculum OS Builder
+  Phase: P3 | Deliverable: Glossary Artifact
+  Version: v1.0 | Date: 2026-05-09
+-->
+
+# 📖 TERM GLOSSARY: [MODULE / TOPIC NAME]
+
+_Created by: @content (Terminology Mode) | Version: v[X] | Date: [DATE]_
+_Unit: U[X] | Module: M[X.X] | Audience: Grade [XX] ([AGE] years old)_
+
+> **How to use:**
+> - 📘 Read **top to bottom** — terms are ordered from basic to advanced.
+> - 🔗 Terms with `→ See more` links help you go deeper.
+> - 💡 The **Analogy** section helps you remember — read it carefully!
+
+---
+
+## [REQUIRED] Term Glossary
+
+<!-- 
+  INSTRUCTIONS FOR @content:
+  Repeat the entry block below for each term.
+  Order from prerequisite → advanced (basic terms first).
+  Minimum 8 terms, maximum 15 terms per module.
+-->
+
+---
+
+### 📌 [Term Name] *(English Term)*
+
+**Bloom's Level:** [🔵 Remember / 🟡 Understand / 🟠 Apply]
+
+**Simple definition:**
+[Max 2 sentences, age-appropriate language — NO jargon]
+
+**💡 Memory analogy:**
+> *"[This term] is like [familiar everyday object/situation]..."*
+
+**Real-world example:**
+```[python/cpp/text]
+[1-3 line code snippet OR 1-sentence real-world application description]
+```
+
+**⚠️ Common mistake:**
+> Many students confuse [this term] with **[similar term]** because [reason]. The key difference is: [short explanation].
+
+**→ See more:** [Related term 1], [Related term 2]
+
+---
+
+### 📌 [Term Name 2] *(English Term 2)*
+
+**Bloom's Level:** [🔵 Remember / 🟡 Understand / 🟠 Apply]
+
+**Simple definition:**
+[...]
+
+**💡 Memory analogy:**
+> *"[...]"*
+
+**Real-world example:**
+```
+[...]
+```
+
+**⚠️ Common mistake:**
+> [...]
+
+**→ See more:** [...]
+
+---
+
+<!-- Add further entries with the same structure -->
+
+---
+
+## [OPTIONAL] Quick Reference Table
+
+_For quick revision before tests:_
+
+| Term (EN) | Translation (target language) | Bloom's | Mnemonic keywords |
+|---|---|:---:|---|
+| [English Term 1] | [Translation 1] | 🔵 | [1-2 key words] |
+| [English Term 2] | [Translation 2] | 🟡 | [1-2 key words] |
+| [English Term 3] | [Translation 3] | 🟠 | [1-2 key words] |
+
+---
+
+## [OPTIONAL] Standardized Terms
+
+_International technical terms — use the English form in code and documentation (Plan C):_
+
+| Technical term | Note | Do not use |
+|---|---|---|
+| `Serial.begin()` | UART initialization function in Arduino | `serial_start()`, `init_serial()` |
+| `GPIO` | General Purpose Input/Output | localized term (in code) |
+| `PWM` | Pulse Width Modulation | localized term (in code) |
+| [Add term] | [Note] | [Term to avoid] |

package/dist/templates/GRAPHIC_ORGANIZER_template.md

@@ -0,0 +1,100 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "GRAPHIC_ORGANIZER"
+created_by: "Curriculum OS Builder"
+phase: "{{PHASE}}"
+deliverable: "P3-T18"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Visual Paradigm Overview"
+  - "Organizer 1: Architectural Data Flow (Mermaid Flowchart)"
+  - "Organizer 2: Comparative Analysis (Mermaid / Markdown Venn)"
+  - "Organizer 3: State Machine & Lifecycle (Mermaid StateDiagram)"
+  - "Student Fill-in Worksheet Format"
+---
+<!-- INJECT_BODY -->
+
+# VISUAL GRAPHIC ORGANIZERS: [LESSON / UNIT TITLE]
+_Unit: U[X] | Module: M[X.X] | Format: Mermaid Markdown Diagrams + Fill-in Printable Worksheets_
+
+## [REQUIRED] Visual Paradigm Overview
+- **Cognitive Purpose:** Unload mental processing burden through spatial diagramming and dual-coding theory (Paivio).
+- **Output Formats:** Interactive Mermaid.js rendered diagrams + Printable student fill-in worksheets.
+
+---
+
+## [REQUIRED] Organizer 1: Architectural Data Flow (Mermaid Flowchart)
+
+```mermaid
+graph TD
+    classDef input fill:#1e3a8a,stroke:#3b82f6,stroke-width:2px,color:#fff;
+    classDef state fill:#78350f,stroke:#f59e0b,stroke-width:2px,color:#fff;
+    classDef engine fill:#14532d,stroke:#22c55e,stroke-width:2px,color:#fff;
+    classDef view fill:#4c1d95,stroke:#a855f7,stroke-width:2px,color:#fff;
+
+    A[User Gesture / Tap]:::input -->|Triggers Action Closure| B[Mutate @State Variable]:::state
+    B -->|Emits State Invalidation| C[SwiftUI Dependency Graph]:::engine
+    C -->|Executes Diffing Algorithm| D[Compute Minimal View Hierarchy]:::engine
+    D -->|Calls body getter| E[Render Updated UI Component]:::view
+
+    subgraph "Hardware & Runtime"
+        C
+        D
+    end
+```
+
+---
+
+## [REQUIRED] Organizer 2: Comparative Analysis (Venn Diagram / Matrix)
+
+```mermaid
+graph LR
+    subgraph "Imperative (UIKit / Legacy)"
+        I1["Manual View Hierarchy Updates"]
+        I2["State stored in View objects"]
+        I3["Frequent Sync Bugs & Memory Leaks"]
+    end
+
+    subgraph "Shared Core Fundamentals"
+        S1["Event Loop Driven"]
+        S2["Underlying CoreAnimation Rendering"]
+    end
+
+    subgraph "Declarative (SwiftUI / Modern)"
+        D1["State-Driven Automatic Diffing"]
+        D2["Immutable Struct View Descriptors"]
+        D3["Single Source of Truth Invariant"]
+    end
+```
+
+---
+
+## [REQUIRED] Organizer 3: State Machine & Lifecycle (State Diagram)
+
+```mermaid
+stateDiagram-v2
+    [*] --> Idle: View Instantiated
+    Idle --> Mutating: User Input Received
+    Mutating --> ComputingDiff: State Wrapper Notifies Graph
+    ComputingDiff --> Repainting: Node Delta Detected
+    Repainting --> Idle: Frame Rendered on Display (60 FPS)
+```
+
+---
+
+## [REQUIRED] Student Fill-in Worksheet Format (Offline Handout)
+```text
+┌──────────────────────────────────────────────────────────────────────────┐
+│                   STUDENT DATA FLOW FILL-IN EXERCISE                     │
+├──────────────────────────────────────────────────────────────────────────┤
+│ [ Box 1: _____________ ] ──▶ [ Box 2: _____________ ]                    │
+│           │                               │                              │
+│           ▼                               ▼                              │
+│ [ Box 3: _____________ ] ──▶ [ Box 4: Renders New Screen (60 FPS) ]      │
+│                                                                          │
+│ Word Bank: @State Mutation, User Tap, View Tree Diffing, Body Re-evaluated│
+└──────────────────────────────────────────────────────────────────────────┘
+```

package/dist/templates/GUIDE_template.md

@@ -0,0 +1,56 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "GUIDE"
+created_by: "Curriculum OS Builder"
+phase: "{{PHASE}}"
+deliverable: "P3-T5"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Objectives & Preparation"
+  - "Preparation Checklist & Workstation Setup"
+  - "Facilitation Script & Timeline"
+  - "Common Misconceptions & Diagnostic Remediation Matrix"
+  - "Differentiated Support Strategies"
+---
+
+# TEACHER GUIDE: [LESSON TITLE]
+_For Teacher Use Only | Unit [UXX] Module [MXX]_
+
+## [REQUIRED] Objectives & Preparation
+- **Pedagogical Goal:** [The main goal for the teacher to achieve during the session. Emphasize mindset shift, not just knowledge.]
+- **Technical Checklist:** [Software/hardware to install or check before class]
+
+> Misconceptions have ONE home in this document: the Remediation Matrix below.
+> Do not restate them here.
+
+## [REQUIRED] Preparation Checklist & Workstation Setup
+| Item | Qty / Setup | Verified? |
+|---|---|---|
+| [Hardware/software/resource] | [Per group or per class] | [ ] |
+
+## [REQUIRED] Facilitation Script & Timeline
+> Mirror the LESSON B-flow phase-by-phase — same phases, same minutes. Do not
+> invent a different time allocation.
+
+### [Phase 1 name] — [X mins] (from LESSON B-flow)
+- **Teacher moves:** [What the teacher says/does]
+- **Inquiry questions:** [Questions to pose]
+- **Transition:** [How to move to the next phase]
+
+<!-- Repeat per B-flow phase. -->
+
+## [REQUIRED] Common Misconceptions & Diagnostic Remediation Matrix
+> Extract the Common Mistakes table VERBATIM from the canonical knowledge
+> context (KX). Do not re-invent or paraphrase — one canonical list per lesson.
+
+| Misconception | Why Students Believe It | Diagnostic Probe | Remediation |
+|---|---|---|---|
+| [From KX Common Mistakes] | [Underlying reasoning error] | [Quick question that exposes it] | [Concrete reteach action] |
+
+## [REQUIRED] Differentiated Support Strategies
+- **Support (struggling students):** [Concrete scaffolds during activities]
+- **Extension (advanced students):** [What to hand them — reference EXT artifact]
+- **Enrichment Question:** [1-2 deep-thinking questions]