@thanh01.pmt/curriculum-kit 1.4.41 → 1.4.43

package/docs/refs/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/docs/refs/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/docs/refs/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/docs/refs/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/docs/refs/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/docs/refs/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]

package/docs/refs/templates/HANDOUT_template.md

@@ -0,0 +1,61 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "HANDOUT"
+created_by: "Curriculum OS Builder"
+phase: "{{PHASE}}"
+deliverable: "P3-T6"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Core Concepts"
+  - "Core Syntax & Mechanism Cheat Sheet"
+  - "Visual Mental Model / Architecture Diagram"
+  - "Step-by-Step Practical Quick-Start Guide"
+  - "Self-Check Diagnostic Checklist"
+---
+
+# HANDOUT: [LESSON TITLE]
+_Student Reference Notes — keep beside you during the lesson._
+
+## [REQUIRED] 📖 Core Concepts
+> Key terms and student-friendly definitions. Source term definitions from the
+> canonical knowledge context (KX Key Terms) — align, don't re-invent.
+
+| Term | Definition (student-friendly) | Example |
+|---|---|---|
+| [Term 1] | [Plain-language explanation] | [Micro example] |
+
+## [REQUIRED] Core Syntax & Mechanism Cheat Sheet
+> Quick-scan reference table for the exact syntax/mechanics this lesson uses.
+
+| Pattern | Syntax | When to Use | Common Trap |
+|---|---|---|---|
+| [Pattern] | `[exact syntax]` | [Situation] | [Pitfall from KX] |
+
+## [REQUIRED] Visual Mental Model / Architecture Diagram
+> One Mermaid or ASCII diagram of the core mechanism, annotated.
+
+```mermaid
+graph LR
+  A[[Component 1]] --> B[[Component 2]]
+  B --> C[[Component 3]]
+```
+
+- **How to read it:** [One-paragraph walkthrough of the diagram]
+
+## [REQUIRED] Step-by-Step Practical Quick-Start Guide
+> Minimum path to a first working result, numbered, with checkpoints.
+
+1. [Step 1 — concrete action]
+   - ✅ Checkpoint: [What you should see]
+2. [Step 2]
+   - ✅ Checkpoint: [What you should see]
+
+## [REQUIRED] Self-Check Diagnostic Checklist
+> Can-do statements for self-assessment, mirroring LESSON LO evidence.
+
+- [ ] I can [can-do statement tied to LO1]
+- [ ] I can [can-do statement tied to LO2]
+- [ ] I can [can-do statement tied to LO3]

package/docs/refs/templates/HANDOVER_DOCUMENT_template.md

@@ -0,0 +1,69 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "HANDOVER_DOCUMENT"
+created_by: "Curriculum OS Builder"
+phase: "{{PHASE}}"
+deliverable: "{{DELIVERABLE_CODE}}"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+---
+
+# CURRICULUM HANDOVER DOCUMENT
+_Handover Date: [YYYY-MM-DD] | Version: v[X.X]_
+
+## 1. Handover Information
+- **Receiving Entity (Client):** [School / Center Name]
+- **Course Name:** [Full Course Title]
+- **Project ID:** [PRJ-CODE]
+- **Target Audience:** [Age Group, Grade]
+
+---
+
+## 2. Deliverables Inventory
+_The curriculum suite is packaged into 4 modules (Packages) tailored for different stakeholders:_
+
+| Package | Content Description | File Qty | Format |
+|---|---|:---:|:---:|
+| **1. Teacher Package** | Detailed Lesson Plans, Activity Guides, Answer Keys, Assessment Rubrics, Pedagogical Notes. | [X] | PDF / DOCX |
+| **2. Student Package** | Learning Workbook, Step-by-step assembly/coding guides, Cheat sheets. | [X] | PDF |
+| **3. Parent Package** | Course goal summary, sample progress reports, home engagement guides. | [X] | PDF |
+| **4. Client/Manager Package** | Syllabus/Framework, Standards Alignment Reports, Hardware/Inventory list. | [X] | PDF / DOCX |
+
+---
+
+## 3. Commitment vs. Reality Check
+| Commitment Item | Actual Delivery | Status |
+|---|---|---|
+| Total Lessons: [X] | Delivered [X] lessons | ✅ Met |
+| Duration: [Y] mins/lesson | Designed [Y] mins/lesson | ✅ Met |
+| Standards Alignment | Meets [Z/W] criteria | See Standards Report |
+
+---
+
+## 4. Scope Exclusions
+_This handover **DOES NOT** include the following items unless specified in a separate agreement:_
+- Provision of hardware equipment, components, or software licenses.
+- Direct Train-The-Trainer (TTT) sessions.
+- Physical printing of materials.
+- Integration into the school's LMS (Learning Management System).
+
+---
+
+## 5. Getting Started Guide
+To implement the curriculum effectively, please follow this sequence:
+1. **Academic Manager:** Review the *Syllabus (Client Package)* to schedule classes and procure hardware.
+2. **Classroom Teacher:** Read the *Lesson Plans (Teacher Package)* from start to finish. Print a sample *Workbook (Student Package)* for reference.
+3. **Pre-launch:** Send the *Course Summary (Parent Package)* to parents.
+
+---
+
+## 6. Post-Handover Support Policy
+- **Support Period:** 30 days from the date of this handover (Until: [YYYY-MM-DD]).
+- **Support Scope:** Clarification on lesson content, fixing technical errors in documents (typos, diagram errors, source code bugs).
+- **Contact Channel:** [Email / Support Phone Number]
+- **Committed Response Time (SLA):** Within [X] working hours.
+
+_Handover Confirmation:_
+**REPRESENTING PROVIDER**                   **REPRESENTING CLIENT**
+(Signature & Full Name)                      (Signature & Full Name)

package/docs/refs/templates/KNOWLEDGE_EXPOSITION_template.md

@@ -0,0 +1,56 @@
+# KNOWLEDGE_EXPOSITION: {{lesson_code}} — {{session_title}}
+
+---
+type: "KNOWLEDGE_EXPOSITION"
+lesson_code: "{{lesson_code}}"
+plan_hash: "{{plan_hash}}"
+generated_at: "{{generated_at}}"
+template_contract: "knowledge-exposition-v1"
+---
+
+_Self-study reference for session {{lesson_code}}. Read this before the activities.
+Scope: exactly the knowledge planned for this session — no more, no less._
+
+## [REQUIRED] Session Scope
+
+- **Objective:** {{prose_objective}}
+- **New keywords:** {{new_keywords}}
+- **Assumed known:** {{prerequisite_keywords}}
+- **Depth targets:** {{depth_targets}}
+- **You can demonstrate, after this session:** {{exit_evidence}}
+
+## [REQUIRED] Key Terms
+
+<!-- One block per term in glossary scope. Definitions MUST match GLOSSARY.json. -->
+
+{{key_terms}}
+
+## [REQUIRED] Concept Narratives
+
+<!-- One subsection per concept node in session scope, sized to its depth assignment:
+     - ulo: WHAT + WHY (technology-independent, what it is and why it exists)
+     - cio: HOW (the mechanism, how it works step by step)
+     - sio: SPECIFIC (concrete implementations, real keyword usage in this project)
+     Written for the STUDENT (self-study, no teacher). No teacher-only instructions. -->
+
+{{concept_narratives}}
+
+## [REQUIRED] Worked Micro-Examples
+
+<!-- Minimal examples traceable to references from the domain graph. -->
+
+{{worked_examples}}
+
+## [REQUIRED] Common Mistakes
+
+{{common_mistakes}}
+
+## [REQUIRED] Self-Check Questions
+
+<!-- 3-5 questions mapped to exit evidence. Answers at the very end. -->
+
+{{self_check}}
+
+---
+- **Plan reference:** {{plan_hash}}
+- **Last Updated:** {{generated_at}}

package/docs/refs/templates/LEARNER_PROFILE_template.md

@@ -0,0 +1,51 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "LEARNER_PROFILE"
+created_by: "Curriculum OS Builder"
+phase: "{{PHASE}}"
+deliverable: "P1-T1"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Foundational Info"
+  - "Entry Level"
+  - "Learning Context"
+  - "Client Objectives"
+---
+
+# LEARNER PROFILE
+
+
+## [REQUIRED] Foundational Info
+- **Age Group:** [Specific age range, e.g., 11–13 years old]
+- **Grade Level:** [E.g., Middle School / High School]
+- **Typical Class Size:** [Number of students]
+- **Learning Context:** [E.g., Public School / Coding Center / Workshop]
+
+## [REQUIRED] Entry Level
+- **Coding Experience:** [None / Basic / Intermediate / Advanced]
+- **Hardware Experience:** [None / Basic / Intermediate / Advanced]
+- **Related Prior Courses:** [List specific courses or "None"]
+
+## [REQUIRED] Learning Context
+- **Session Duration:** [Minutes]
+- **Total Sessions:** [Number]
+- **Frequency:** [E.g., 2 sessions/week]
+- **Student Equipment:** [E.g., Personal Laptop / Lab PC / Tablet]
+- **Internet Connectivity:** [Stable / Unstable / None]
+
+## [REQUIRED] Client Objectives
+- **Core Goal:** [What the client wants students to achieve - max 3 points]
+- **Standard Alignment:** [E.g., CSTA / K12 CS Framework / Local Standards]
+
+## [OPTIONAL] Student Characteristics
+- **Motivation:** [Brief description]
+- **Potential Barriers:** [Brief description]
+- **Strengths to Leverage:** [Brief description]
+
+## [OPTIONAL] Special Constraints
+- **Hardware Budget:** [Budget per student or "None"]
+- **Language Requirements:** [E.g., Bilingual English-Vietnamese]
+- **Other Client Requests:** [Description or "None"]