@thanh01.pmt/curriculum-kit 1.4.44 → 1.4.45

package/docs/refs/templates/ACT_template.md

@@ -13,6 +13,9 @@ template_required_sections:
   - "Materials & Setup"
   - "Constraints & Safety"
   - "Active Learning Workflow"
+  - "Phase 1: Planning & Design"
+  - "Phase 2: Implementation & Discovery"
+  - "Phase 3: Debugging & Testing"
   - "3-Tier Differentiation"
   - "Reflection"
 ---
@@ -21,38 +24,44 @@ template_required_sections:
 # INQUIRY-BASED ACTIVITY: [ACTIVITY TITLE]
 _Unit: U[X] | Module: M[X.X] | Lesson: Lesson [XX]_
 
-## [REQUIRED] Computational Thinking Focus
+## Computational Thinking Focus
 - **Problem Statement (Real-world Scenario):** [Describe a real problem instead of just assembly steps. E.g., "A farm weather station needs to alert when the temperature is too high."]
 - **Decomposition:** [E.g., 1. Read sensor, 2. Process logic, 3. Send alert.]
 - **Algorithm Design:** [How should students think about the Data Flow before programming?]
 
-## [REQUIRED] Materials & Setup
+## Materials & Setup
 - **Reference Material:** Students should use the **HANDOUT** for this lesson as their primary technical reference (lifeline).
 - **Hardware/Software:** [List specific devices, components, and tools required.]
 
-## [REQUIRED] Constraints & Safety
+## Constraints & Safety
 - ⚠️ **Technical/Safety:** [E.g., Careful with 5V/GND pins, API rate limits.]
 - 💡 **Design Constraint:** [Provide a constraint to stimulate thinking. E.g., "Maximum 3 nodes allowed", "Environment variables MUST be used."]
 
-## [REQUIRED] Active Learning Workflow
+## Active Learning Workflow
 
-### Phase 1: Planning & Design — [X mins]
+### Phase 1: Planning & Design
+
+> **Duration:** {{ XX }} mins
 - **Student Task:** Hand-draw (or draft in words) the algorithm flowchart or connection architecture before touching the computer/devices.
 - **Teacher Action:** Walk around to check the logic of each group. Ask inquiry questions: *"Where does the data flow from and to?", "If the sensor fails, how will the system report the error?"*
 
-### Phase 2: Implementation & Discovery — [Y mins]
+### Phase 2: Implementation & Discovery
+
+> **Duration:** {{ XX }} mins
 - **Student Task:** Apply the knowledge from the **HANDOUT** to realize the plan designed in Phase 1. Encourage self-inquiry and documentation lookup.
 - **Teacher Action:** Avoid "hand-holding." Only intervene if a group has been stuck for more than 5 minutes.
 
-### Phase 3: Debugging & Testing — [Z mins]
+### Phase 3: Debugging & Testing
+
+> **Duration:** {{ XX }} mins
 - **Testing:** Students run their system.
 - **Error Analysis:** Ask students to record any error codes or unexpected behaviors and compare them with the Troubleshooting table in the Handout.
 
-## [REQUIRED] 3-Tier Differentiation
+## 3-Tier Differentiation
 > MUST design tasks in 3 tiers to support diverse learner groups. Bronze is the minimum requirement for all students.
 - 🥉 **Bronze (Foundational):** [Core task, usually corresponding to accurately completing the basics from the Handout. E.g., Calling an API and printing the result.]
 - 🥈 **Silver (Application):** [Task with additional logic or processing steps. E.g., Adding an IF Node to check if temperature > 30.]
 - 🥇 **Gold (Enrichment/Creative):** [Challenging task requiring self-research of new tools or advanced knowledge. E.g., Sending the alert via Telegram.]
 
-## [REQUIRED] Reflection
+## Reflection
 - **Discussion Question:** [E.g., Why is Approach A better than B? Which part of the code runs the slowest?]

package/docs/refs/templates/ALIGNMENT_MATRIX_template.md

@@ -8,6 +8,11 @@ deliverable: "P3-T9"
 version: "{{VERSION}}"
 date: "{{DATE}}"
 ---
+template_required_sections:
+  - "Vertical Alignment Tracker"
+  - "Horizontal & Prerequisite Alignment Report"
+  - "Feedback & Revision Log"
+---
 
 # ALIGNMENT MATRIX
 _Updated by: @reviewer | Read by: All Agents_

package/docs/refs/templates/ART_DIRECTION_template.md

@@ -8,6 +8,13 @@ deliverable: "P2-T2"
 version: "{{VERSION}}"
 date: "{{DATE}}"
 ---
+template_required_sections:
+  - "🎨 1. Visual Identity & Mood"
+  - "🌈 2. Color Palette"
+  - "📊 3. Diagram Standards (Mermaid)"
+  - "🖼️ 4. Image Categories & Tiers"
+  - "🛠️ 5. Typography"
+---
 
 # ART DIRECTION: [Project Name]
 

package/docs/refs/templates/ASSET_MANIFEST_template.md

@@ -6,6 +6,11 @@ created_by: "Antigravity"
 version: "v4.6"
 date: "YYYY-MM-DD"
 ---
+template_required_sections:
+  - "Summary"
+  - "Referenced Assets"
+  - "Orphan Assets"
+---
 
 # 📦 ASSET MANIFEST
 _Auto-updated by Radar at: YYYY-MM-DD HH:MM:SS | Learning-asset sync status_

package/docs/refs/templates/BASELINE_STANDARD.md

@@ -8,6 +8,11 @@ deliverable: "{{DELIVERABLE_CODE}}"
 version: "{{VERSION}}"
 date: "{{DATE}}"
 ---
+template_required_sections:
+  - "CSTA K-12 Computer Science Standards"
+  - "AI4K12 - Five Big Ideas in AI"
+  - "Bloom's Taxonomy for CS/STEM"
+---
 
 # BASELINE STANDARDS (K-12 CS & AI)
 

package/docs/refs/templates/BELL_RINGER_template.md

@@ -10,25 +10,25 @@ date: "{{DATE}}"
 template_contract: "artifact-template-v1"
 template_required_sections:
   - "Weekly Objective & Schedule"
-  - "Monday: Mental Model Recall (Warm-up 1)"
-  - "Tuesday: Code Spot-Check (Warm-up 2)"
-  - "Wednesday: Bug Hunt & Fix (Warm-up 3)"
-  - "Thursday: Architecture Tracing (Warm-up 4)"
-  - "Friday: Creative Synthesis & Bridge (Warm-up 5)"
-  - "Answer Key & Scoring Guide"
+  - "Day 1 (Monday): Mental Model Recall & Analogy"
+  - "Day 2 (Tuesday): Rapid Code Tracing"
+  - "Day 3 (Wednesday): Quick Bug Hunt (Spot the Defect)"
+  - "Day 4 (Thursday): Visual Diagram Tracing"
+  - "Day 5 (Friday): Creative Synthesis & Bridge Forward"
+  - "Teacher Answer Key & Scoring Guide"
 ---
 <!-- INJECT_BODY -->
 
 # WEEKLY BELL RINGERS (5-DAY WARM-UP PACK): [UNIT / LESSON TITLE]
 _Unit: U[X] | Module: M[X.X] | Time: Exactly 3-5 Mins at Start of Each Session_
 
-## [REQUIRED] Weekly Objective & Schedule
+## Weekly Objective & Schedule
 - **Weekly Core Theme:** [E.g., "Swift Concurrency, Actors & Thread Safety"]
 - **Routine Protocol:** Display prompt on projector immediately as students enter. Students write responses in their Daily Journal before class discussion.
 
 ---
 
-## [REQUIRED] Day 1 (Monday): Mental Model Recall & Analogy
+## Day 1 (Monday): Mental Model Recall & Analogy
 > *Time: 3 Mins | Bloom: Understand*
 
 **Prompt:**  
@@ -41,7 +41,7 @@ _Unit: U[X] | Module: M[X.X] | Time: Exactly 3-5 Mins at Start of Each Session_
 
 ---
 
-## [REQUIRED] Day 2 (Tuesday): Rapid Code Tracing
+## Day 2 (Tuesday): Rapid Code Tracing
 > *Time: 4 Mins | Bloom: Apply*
 
 **Prompt:**  
@@ -58,7 +58,7 @@ func compute() async -> Int {
 
 ---
 
-## [REQUIRED] Day 3 (Wednesday): Quick Bug Hunt (Spot the Defect)
+## Day 3 (Wednesday): Quick Bug Hunt (Spot the Defect)
 > *Time: 4 Mins | Bloom: Analyze*
 
 **Prompt:**  
@@ -82,7 +82,7 @@ struct UserProfileView: View {
 
 ---
 
-## [REQUIRED] Day 4 (Thursday): Visual Diagram Tracing
+## Day 4 (Thursday): Visual Diagram Tracing
 > *Time: 4 Mins | Bloom: Analyze*
 
 **Prompt:**  
@@ -92,7 +92,7 @@ Given the following state transition flow:
 
 ---
 
-## [REQUIRED] Day 5 (Friday): Creative Synthesis & Bridge Forward
+## Day 5 (Friday): Creative Synthesis & Bridge Forward
 > *Time: 5 Mins | Bloom: Evaluate / Create*
 
 **Prompt:**  
@@ -100,7 +100,7 @@ Given the following state transition flow:
 
 ---
 
-## [REQUIRED] Teacher Answer Key & Scoring Guide
+## Teacher Answer Key & Scoring Guide
 - **Monday:** Shared memory without synchronization causes overlapping writes (data races). Actors queue requests in an isolated mailbox.
 - **Tuesday:** The spawned `Task` executes asynchronously and may not finish before `return total` executes.
 - **Wednesday:** `resetName()` mutates `name` on `self` struct; in SwiftUI, mutating `@State` is valid because the property wrapper stores value externally on heap, but function should be private or state mutated directly in button action.

package/docs/refs/templates/CHANGELOG_template.md

@@ -6,6 +6,9 @@ created_by: "Curriculum OS Builder"
 version: "{{VERSION}}"
 date: "{{DATE}}"
 ---
+template_required_sections:
+  - "📜 Historical Log"
+---
 
 # CHANGELOG: [Project Name]
 _This file maintains a persistent, append-only record of all significant changes to the project._

package/docs/refs/templates/CHOICE_BOARD_template.md

@@ -11,7 +11,10 @@ template_contract: "artifact-template-v1"
 template_required_sections:
   - "Learning Goals & Rule of Choice"
   - "The 9-Square Activity Matrix"
-  - "Activity Detailed Blueprints"
+  - "Activity Detailed Blueprints (Selected Modules)"
+  - "Detail: Square 1 — The Bug Hunter"
+  - "Detail: Square 2 — The Architect's Blueprint"
+  - "Detail: ⭐ Square 5 — Core Master Challenge (Mandatory Center Option)"
   - "Universal Assessment Rubric"
 ---
 <!-- INJECT_BODY -->
@@ -19,7 +22,7 @@ template_required_sections:
 # 9-SQUARE CHOICE BOARD: [LESSON / UNIT TITLE]
 _Unit: U[X] | Module: M[X.X] | Target Competency: [Core Competency Name]_
 
-## [REQUIRED] Learning Goals & Rule of Choice
+## Learning Goals & Rule of Choice
 - **Core Concept Anchor:** [All options must demonstrate mastery of this central invariant, e.g., "State Isolation & Safe Concurrent Mutation"].
 - **Rule of Choice (Tic-Tac-Toe / Point Model):**
   - *Option A (Tic-Tac-Toe):* Complete 3 activities in a row (Horizontal, Vertical, or Diagonal).
@@ -27,7 +30,7 @@ _Unit: U[X] | Module: M[X.X] | Target Competency: [Core Competency Name]_
 
 ---
 
-## [REQUIRED] The 9-Square Activity Matrix
+## The 9-Square Activity Matrix
 
 | Column 1: Analytical & Code | Column 2: Visual & Architecture | Column 3: Creative & Applied |
 | :--- | :--- | :--- |
@@ -37,7 +40,7 @@ _Unit: U[X] | Module: M[X.X] | Target Competency: [Core Competency Name]_
 
 ---
 
-## [REQUIRED] Activity Detailed Blueprints (Selected Modules)
+## Activity Detailed Blueprints (Selected Modules)
 
 ### Detail: Square 1 — The Bug Hunter
 - **Input Source Code:** Provided in `Assets/Lab/BrokenProject.zip`.
@@ -56,7 +59,7 @@ _Unit: U[X] | Module: M[X.X] | Target Competency: [Core Competency Name]_
 
 ---
 
-## [REQUIRED] Universal Assessment Rubric
+## Universal Assessment Rubric
 | Criteria | Exemplary (4) | Proficient (3) | Developing (2) | Beginning (1) |
 | :--- | :--- | :--- | :--- | :--- |
 | **Technical Accuracy** | 100% executable, idiomatic syntax, zero race conditions. | Compiles and runs; minor non-critical styling issue. | Runs with partial errors or missing edge cases. | Does not compile or contains critical syntax bugs. |

package/docs/refs/templates/CODE_template.md

@@ -16,10 +16,9 @@ template_required_sections:
   - "Automated Test / Verification Script"
   - "Common Syntax & Runtime Pitfalls Matrix"
 ---
-
 # CODE LAB: [LESSON TITLE]
 
-## [REQUIRED] Technical Overview & Architecture Blueprint
+## 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.
@@ -36,7 +35,7 @@ template_required_sections:
 |---|---|---|
 | [Component] | [Pin] | [Why this wiring] |
 
-## [REQUIRED] Starter Code Sandbox
+## Starter Code Sandbox
 > Skeleton the students start from, with explicit TODO comments marking every
 > point they must implement.
 
@@ -44,7 +43,7 @@ template_required_sections:
 // [Starter code with TODO markers]
 ```
 
-## [REQUIRED] Verified Reference Solution Code
+## Verified Reference Solution Code
 > 100% syntactically valid, production-ready, fully commented. Must satisfy
 > the verification script below.
 
@@ -52,7 +51,7 @@ template_required_sections:
 // [Complete reference solution]
 ```
 
-## [REQUIRED] Automated Test / Verification Script
+## Automated Test / Verification Script
 > How to compile / run / verify: exact commands and expected output.
 
 ```bash
@@ -61,7 +60,7 @@ template_required_sections:
 
 - **Expected result:** [What success looks like]
 
-## [REQUIRED] Common Syntax & Runtime Pitfalls Matrix
+## 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.
 

package/docs/refs/templates/CONTENT_CONTINUITY_template.md

@@ -8,6 +8,12 @@ deliverable: "P3-CONT"
 version: "v2.1"
 date: "YYYY-MM-DD"
 ---
+template_required_sections:
+  - "Storyline & Character Development"
+  - "Pedagogical Analogies & Concepts"
+  - "Multimedia Assets Log"
+  - "Hardware & Materials Used"
+---
 
 # CONTENT CONTINUITY: [PROJECT_NAME]
 

package/docs/refs/templates/CONTENT_STYLE_GUIDE_template.md

@@ -14,28 +14,27 @@ template_required_sections:
   - "Examples & Context Rules"
   - "Lesson Content Standards"
 ---
-
 # CONTENT STYLE GUIDE
 
 
-## [REQUIRED] Voice & Tone
+## 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)
+## 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
+## 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
+## 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]

package/docs/refs/templates/CURRICULUM_FRAMEWORK_template.md

@@ -15,12 +15,11 @@ template_required_sections:
   - "Scope & Sequence (Detailed Roadmap)"
   - "Standard Lesson Format"
 ---
-
 # CURRICULUM FRAMEWORK
 
 _Based on: LEARNER_PROFILE.md v[X]_
 
-## [REQUIRED] Course Overview
+## 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]
@@ -28,20 +27,20 @@ _Based on: LEARNER_PROFILE.md v[X]_
 - **Total Lessons:** [Number]
 - **Total Duration:** [Calculated in minutes/hours]
 
-## [REQUIRED] Global Learning Objectives
+## 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)
+## 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)
+## 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) |
 |---|---|---|---|---|---|---|---|---|---|:---:|
@@ -50,7 +49,7 @@ _Note: Each objective must be measurable and observable._
 
 _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
+## Standard Lesson Format
 - **Theory Duration:** [X mins]
 - **Practice Duration:** [Y mins]
 - **Homework Included:** [Yes / No]

package/docs/refs/templates/DEPENDENCY_MAP_template.md

@@ -13,12 +13,11 @@ template_required_sections:
   - "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
+## Document Dependency Hierarchy
 Data flows top-down. An arrow `└──` means the document below MUST read the document above before it is produced.
 
 ```text
@@ -35,7 +34,7 @@ LEARNER_PROFILE.md (Source: Client)
             └── PACKAGES (final deliverables: Teacher, Student, Parent, Client)
 ```
 
-## [REQUIRED] Cascade Impact Rules
+## 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 |
@@ -47,7 +46,7 @@ When a Scope Change request or Version update occurs, `@reviewer` MUST cross-che
 | **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
+## 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).

package/docs/refs/templates/EXIT_TICKET_template.md

@@ -10,9 +10,9 @@ date: "{{DATE}}"
 template_contract: "artifact-template-v1"
 template_required_sections:
   - "Target Learning Objectives"
-  - "Recall & Conceptual Anchor"
-  - "Application & Bug Hunt"
-  - "Metacognitive Reflection & Confidence Check"
+  - "Part 1: Recall & Conceptual Anchor (Prompt 1)"
+  - "Part 2: Application & Bug Hunt (Prompt 2)"
+  - "Part 3: Metacognitive Reflection & Confidence Check (Prompt 3)"
   - "Scoring & Teacher Intervention Trigger"
 ---
 <!-- INJECT_BODY -->
@@ -20,13 +20,13 @@ template_required_sections:
 # 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 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)
+## Part 1: Recall & Conceptual Anchor (Prompt 1)
 > *Objective: Test core mental model without allowing rote syntax memorization.*
 
 **Question 1:**  
@@ -39,7 +39,7 @@ _Unit: U[X] | Module: M[X.X] | Lesson: Lesson [XX] | Estimated Time: 5-7 mins_
 
 ---
 
-## [REQUIRED] Part 2: Application & Bug Hunt (Prompt 2)
+## Part 2: Application & Bug Hunt (Prompt 2)
 > *Objective: Test code diagnosis and precise correction in ≤ 3 lines of modification.*
 
 **Code Snippet:**  
@@ -65,7 +65,7 @@ struct CounterDisplay: View {
 
 ---
 
-## [REQUIRED] Part 3: Metacognitive Reflection & Confidence Check (Prompt 3)
+## Part 3: Metacognitive Reflection & Confidence Check (Prompt 3)
 > *Objective: Empower student self-regulation and provide immediate diagnostic signals.*
 
 **Traffic Light Self-Assessment:**  
@@ -80,6 +80,6 @@ struct CounterDisplay: View {
 
 ---
 
-## [REQUIRED] Scoring & Teacher Intervention Trigger
+## 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

@@ -8,6 +8,9 @@ deliverable: "P3-T8"
 version: "{{VERSION}}"
 date: "{{DATE}}"
 ---
+template_required_sections:
+  - "For: Advanced Students / Extra Time"
+---
 
 # EXTENSION TASKS: [LESSON TITLE]
 

package/docs/refs/templates/GLOSSARY_template.md

@@ -6,7 +6,6 @@ template_contract: "artifact-template-v1"
 template_required_sections:
   - "Term Glossary"
 ---
-
 <!-- 
   Created by: Curriculum OS Builder
   Phase: P3 | Deliverable: Glossary Artifact
@@ -25,7 +24,7 @@ _Unit: U[X] | Module: M[X.X] | Audience: Grade [XX] ([AGE] years old)_
 
 ---
 
-## [REQUIRED] Term Glossary
+## Term Glossary
 
 <!-- 
   INSTRUCTIONS FOR @content:

package/docs/refs/templates/GRAPHIC_ORGANIZER_template.md

@@ -11,22 +11,22 @@ 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"
+  - "Organizer 2: Comparative Analysis (Venn Diagram / Matrix)"
+  - "Organizer 3: State Machine & Lifecycle (State Diagram)"
+  - "Student Fill-in Worksheet Format (Offline Handout)"
 ---
 <!-- 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
+## 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)
+## Organizer 1: Architectural Data Flow (Mermaid Flowchart)
 
 ```mermaid
 graph TD
@@ -48,7 +48,7 @@ graph TD
 
 ---
 
-## [REQUIRED] Organizer 2: Comparative Analysis (Venn Diagram / Matrix)
+## Organizer 2: Comparative Analysis (Venn Diagram / Matrix)
 
 ```mermaid
 graph LR
@@ -72,7 +72,7 @@ graph LR
 
 ---
 
-## [REQUIRED] Organizer 3: State Machine & Lifecycle (State Diagram)
+## Organizer 3: State Machine & Lifecycle (State Diagram)
 
 ```mermaid
 stateDiagram-v2
@@ -85,7 +85,7 @@ stateDiagram-v2
 
 ---
 
-## [REQUIRED] Student Fill-in Worksheet Format (Offline Handout)
+## Student Fill-in Worksheet Format (Offline Handout)
 ```text
 ┌──────────────────────────────────────────────────────────────────────────┐
 │                   STUDENT DATA FLOW FILL-IN EXERCISE                     │

package/docs/refs/templates/GUIDE_template.md

@@ -15,23 +15,22 @@ template_required_sections:
   - "Common Misconceptions & Diagnostic Remediation Matrix"
   - "Differentiated Support Strategies"
 ---
-
 # TEACHER GUIDE: [LESSON TITLE]
 _For Teacher Use Only | Unit [UXX] Module [MXX]_
 
-## [REQUIRED] Objectives & Preparation
+## 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
+## Preparation Checklist & Workstation Setup
 | Item | Qty / Setup | Verified? |
 |---|---|---|
 | [Hardware/software/resource] | [Per group or per class] | [ ] |
 
-## [REQUIRED] Facilitation Script & Timeline
+## Facilitation Script & Timeline
 > Mirror the LESSON B-flow phase-by-phase — same phases, same minutes. Do not
 > invent a different time allocation.
 
@@ -42,7 +41,7 @@ _For Teacher Use Only | Unit [UXX] Module [MXX]_
 
 <!-- Repeat per B-flow phase. -->
 
-## [REQUIRED] Common Misconceptions & Diagnostic Remediation Matrix
+## 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.
 
@@ -50,7 +49,7 @@ _For Teacher Use Only | Unit [UXX] Module [MXX]_
 |---|---|---|---|
 | [From KX Common Mistakes] | [Underlying reasoning error] | [Quick question that exposes it] | [Concrete reteach action] |
 
-## [REQUIRED] Differentiated Support Strategies
+## 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

@@ -15,11 +15,10 @@ template_required_sections:
   - "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
+## Core Concepts
 > Key terms and student-friendly definitions. Source term definitions from the
 > canonical knowledge context (KX Key Terms) — align, don't re-invent.
 
@@ -27,14 +26,14 @@ _Student Reference Notes — keep beside you during the lesson._
 |---|---|---|
 | [Term 1] | [Plain-language explanation] | [Micro example] |
 
-## [REQUIRED] Core Syntax & Mechanism Cheat Sheet
+## 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
+## Visual Mental Model / Architecture Diagram
 > One Mermaid or ASCII diagram of the core mechanism, annotated.
 
 ```mermaid
@@ -45,7 +44,7 @@ graph LR
 
 - **How to read it:** [One-paragraph walkthrough of the diagram]
 
-## [REQUIRED] Step-by-Step Practical Quick-Start Guide
+## Step-by-Step Practical Quick-Start Guide
 > Minimum path to a first working result, numbered, with checkpoints.
 
 1. [Step 1 — concrete action]
@@ -53,7 +52,7 @@ graph LR
 2. [Step 2]
    - ✅ Checkpoint: [What you should see]
 
-## [REQUIRED] Self-Check Diagnostic Checklist
+## Self-Check Diagnostic Checklist
 > Can-do statements for self-assessment, mirroring LESSON LO evidence.
 
 - [ ] I can [can-do statement tied to LO1]