@thanh01.pmt/curriculum-kit 1.4.44 → 1.4.46

package/dist/templates/LESSON_GENERAL_template.md

@@ -17,13 +17,17 @@ template_required_sections:
   - "Assessment Map"
   - "Artifact Contract"
   - "B. Lesson Flow"
-  - "Artifact Linkage"
+  - "Warm-up / Hook"
+  - "Core Concepts"
+  - "Guided Practice"
+  - "Independent Practice"
+  - "Wrap-up & Checkpoint"
 ---
 <!-- INJECT_BODY -->
 
 # LESSON [XX]: [LESSON TITLE]
 
-## [REQUIRED] A. Lesson Design Plan
+## A. Lesson Design Plan
 
 > OWNERSHIP: Each fact lives in exactly ONE section. The Artifact Contract
 > column of the Activity Sequence is the single owner of which satellite
@@ -73,14 +77,18 @@ template_required_sections:
 
 ---
 
-## [REQUIRED] B. Lesson Flow
+## B. Lesson Flow
 
-### 1. Warm-up / Hook — [X mins]
+### 1. Warm-up / Hook
+
+> **Duration:** {{ XX }} mins
 [Inquiry-based question, short game, or story to grab attention, connecting to prior knowledge or real-world applications.]
 
 ---
 
-### 2. Core Concepts — [X mins]
+### 2. Core Concepts
+
+> **Duration:** {{ XX }} mins
 
 ### Concept 1: [Concept Name]
 [Explain theory in age-appropriate language. Use real-world analogies. Max 3 paragraphs.]
@@ -92,19 +100,25 @@ template_required_sections:
 
 ---
 
-### 3. Guided Practice — [X mins]
+### 3. Guided Practice
+
+> **Duration:** {{ XX }} mins
 [Teacher demos or guides students step-by-step according to the Activity Sequence. Include code snippets, Mermaid diagrams, or basic wiring schematics.]
 
 ---
 
-### 4. Independent Practice — [X mins]
+### 4. Independent Practice
+
+> **Duration:** {{ XX }} mins
 [Students solve a problem or challenge based on the planned evidence target.]
 
 > **ACT Contract**: Detailed operational instructions must expand the Activity Sequence above and must not change the planned evidence target.
 
 ---
 
-### 5. Wrap-up & Checkpoint — [X mins]
+### 5. Wrap-up & Checkpoint
+
+> **Duration:** {{ XX }} mins
 [Summarize the 2-3 most important points. Provide 2-3 quick check questions to ensure understanding before class ends.]
 
 > **QUIZ Contract**: Detailed assessment criteria and rubrics must assess the evidence and success criteria defined in the Lesson Design Plan.

package/dist/templates/OUTPUT_CONSTRAINTS_template.md

@@ -8,6 +8,13 @@ deliverable: "{{DELIVERABLE_CODE}}"
 version: "{{VERSION}}"
 date: "{{DATE}}"
 ---
+template_required_sections:
+  - "Structural Constraints"
+  - "Quantitative Constraints"
+  - "Pedagogical Constraints"
+  - "Code & Technical Constraints"
+  - "Language Constraints"
+---
 
 # CONTENT GENERATION CONSTRAINTS
 

package/dist/templates/PACKAGING_SPEC_template.md

@@ -8,6 +8,14 @@ deliverable: "P3-SPEC"
 version: "v2.0"
 date: "YYYY-MM-DD"
 ---
+template_required_sections:
+  - "Package Structure & Rules"
+  - "Transformation Rules (⚡)"
+  - "A. For Students (Student Version)"
+  - "B. For Parents (Parent Version)"
+  - "C. For Managers / Clients (Client Version)"
+  - "Data Sanitization Protocol"
+---
 
 # PACKAGING & TRANSFORMATION SPECIFICATION
 

package/dist/templates/PILOT_FEEDBACK_template.md

@@ -8,6 +8,12 @@ deliverable: "{{DELIVERABLE_CODE}}"
 version: "{{VERSION}}"
 date: "{{DATE}}"
 ---
+template_required_sections:
+  - "Session Information"
+  - "Structured Feedback by Lesson Phase"
+  - "General Observations"
+  - "Overall Classification & Action (For System / Human PM)"
+---
 
 # PILOT TEACHING FEEDBACK
 _Date Recorded: [YYYY-MM-DD]_

package/dist/templates/PROJECT_BRIEF_template.md

@@ -8,6 +8,14 @@ deliverable: "P1-T9"
 version: "{{VERSION}}"
 date: "{{DATE}}"
 ---
+template_required_sections:
+  - "Project Overview"
+  - "Audience & Duration"
+  - "Learning Roadmap"
+  - "Learning Outcomes & Deliverables"
+  - "Technical Constraints"
+  - "Artifact Scope"
+---
 
 # PROJECT BRIEF: [PROJECT NAME]
 

package/dist/templates/PROJECT_STATUS_template.md

@@ -8,6 +8,15 @@ deliverable: "P1-GATE"
 version: "v4.6"
 date: "YYYY-MM-DD"
 ---
+template_required_sections:
+  - "Project Summary"
+  - "Macro Pipeline (Course Lifecycle)"
+  - "High-Level Roadmap"
+  - "Detailed Progress Tracking"
+  - "Critical Links"
+  - "Changelog (Latest Only)"
+  - "🎯 Current Milestone: Phase 1 - R&D"
+---
 
 # PROJECT STATUS: [PROJECT_NAME]
 

package/dist/templates/QUIZ_template.md

@@ -8,6 +8,13 @@ deliverable: "P2-T08"
 version: "{{VERSION}}"
 date: "{{DATE}}"
 ---
+template_required_sections:
+  - "Metadata Specs"
+  - "Schema Structure"
+  - "Pedagogical Rules"
+  - "Visual Layout (Marp/Interactive)"
+---
+
 <!-- 
   Created by: Curriculum OS Builder
   Phase: P2 | Deliverable: P2-T08 (Assessment Infrastructure)

package/dist/templates/QUIZ_v4.6_template.md

@@ -14,10 +14,9 @@ template_required_sections:
   - "Code Analysis / Debugging Question"
   - "Competency Rubric"
 ---
-
 # QUIZ: [LESSON TITLE]
 
-## [REQUIRED] Assessment Objectives
+## Assessment Objectives
 > One row per Learning Objective from the LESSON A1 table. Bloom level of each
 > objective MUST match the LESSON A1 Bloom verb — do not re-target.
 
@@ -25,7 +24,7 @@ template_required_sections:
 |---|---|---|---|
 | LO1 | [What this quiz verifies for LO1] | [Same Bloom verb as LESSON A1] | [Observable student output] |
 
-## [REQUIRED] Multiple-Choice Question Bank
+## Multiple-Choice Question Bank
 > ≥5 scenario-based questions, 4 options each. Every distractor must be a real,
 > common misconception from this lesson's domain (see Common Mistakes source in
 > the canonical knowledge context) — never random filler.
@@ -42,7 +41,7 @@ template_required_sections:
 
 <!-- Repeat per question. -->
 
-## [REQUIRED] Code Analysis / Debugging Question
+## Code Analysis / Debugging Question
 > One deep code-tracing task: students predict output or identify the bug.
 > Provide a complete, runnable snippet with line numbers.
 
@@ -54,7 +53,7 @@ template_required_sections:
 - **Expected answer:** [Output or bug + fix]
 - **Bloom:** [Level] — **LO:** [LO code]
 
-## [REQUIRED] Competency Rubric
+## Competency Rubric
 > 4-tier matrix tied to the Evidence column above.
 
 | Tier | Descriptor | Evidence Threshold |

package/dist/templates/REFERENCE_PACK_template.md

@@ -8,6 +8,10 @@ deliverable: "{{DELIVERABLE_CODE}}"
 version: "{{VERSION}}"
 date: "{{DATE}}"
 ---
+template_required_sections:
+  - "📊 Coverage Summary"
+  - "📚 Detailed Technical References"
+---
 
 # REFERENCE PACK: Pedagogical Source Grounds
 

package/dist/templates/REVIEW_GAME_template.md

@@ -10,9 +10,12 @@ date: "{{DATE}}"
 template_contract: "artifact-template-v1"
 template_required_sections:
   - "Game Rules & Setup Guide"
-  - "Round 1: Speed Round (100-200 Pts)"
-  - "Round 2: Code Duel & Debugging (300-400 Pts)"
-  - "Round 3: Final Boss Architecture Challenge (500 Pts)"
+  - "Round 1: Rapid-Fire Speed Round (100–200 Points)"
+  - "Question 1 (100 Pts):"
+  - "Question 2 (200 Pts):"
+  - "Round 2: Code Duel & Debugging (300–400 Points)"
+  - "Challenge 1 (300 Pts):"
+  - "Round 3: Final Boss Architecture Challenge (500 Points)"
   - "Kahoot / Quizizz CSV Export Format"
 ---
 <!-- INJECT_BODY -->
@@ -20,14 +23,14 @@ template_required_sections:
 # INTERACTIVE REVIEW GAME (QUIZ SHOW PACK): [UNIT / LESSON TITLE]
 _Unit: U[X] | Module: M[X.X] | Format: Live Classroom Quiz Show / Kahoot / Jeopardy Format_
 
-## [REQUIRED] Game Rules & Setup Guide
+## Game Rules & Setup Guide
 - **Format:** 3 Rounds of progressive difficulty with team buzzers or interactive clickers.
 - **Team Size:** 3-5 students per squad.
 - **Bonus Mechanic:** Teams can wager points on Round 3 (Final Boss Challenge).
 
 ---
 
-## [REQUIRED] Round 1: Rapid-Fire Speed Round (100–200 Points)
+## Round 1: Rapid-Fire Speed Round (100–200 Points)
 
 ### Question 1 (100 Pts):
 - **Category:** Vocabulary & Syntax
@@ -45,7 +48,7 @@ _Unit: U[X] | Module: M[X.X] | Format: Live Classroom Quiz Show / Kahoot / Jeopa
 
 ---
 
-## [REQUIRED] Round 2: Code Duel & Debugging (300–400 Points)
+## Round 2: Code Duel & Debugging (300–400 Points)
 
 ### Challenge 1 (300 Pts):
 - **Prompt:** First team to buzz in and explain why this code fails compilation wins 300 pts!
@@ -61,7 +64,7 @@ func updateStore(store: DataStore) async {
 
 ---
 
-## [REQUIRED] Round 3: Final Boss Architecture Challenge (500 Points)
+## Round 3: Final Boss Architecture Challenge (500 Points)
 - **Scenario:** "Design a real-time multiplayer scorekeeper using Swift 6 Actors. You have 3 minutes to draft the Actor interface on your team whiteboard."
 - **Rubric:**
   - `+200 pts:` Declared `actor ScoreKeeper`.
@@ -70,7 +73,7 @@ func updateStore(store: DataStore) async {
 
 ---
 
-## [REQUIRED] Kahoot / Quizizz CSV Export Format
+## Kahoot / Quizizz CSV Export Format
 ```csv
 Question,Option 1,Option 2,Option 3,Option 4,Correct Answer,Time Limit (sec)
 "What keyword creates an asynchronous suspension point?","defer","await","return","yield",2,20

package/dist/templates/RUBRIC_template.md

@@ -12,12 +12,11 @@ template_required_sections:
   - "Assessment Overview"
   - "Assessment Rubric"
 ---
-
 # ASSESSMENT: [LESSON/PROJECT TITLE]
 
 _Unit: U[X] | Module: M[X.X] | Lesson: Lesson [XX]_
 
-## [REQUIRED] Assessment Overview
+## Assessment Overview
 - **Type:** [Select: Formative / Summative / Self-assessment / Peer-review]
 - **Format:** [Select: Short Exercise / Exit Ticket / Practical Product / Project Presentation]
 - **Learning Objectives Measured:** [Copy 1-2 LOs from the corresponding Lesson Plan]
@@ -25,7 +24,7 @@ _Unit: U[X] | Module: M[X.X] | Lesson: Lesson [XX]_
 
 ---
 
-## [REQUIRED] Assessment Rubric
+## Assessment Rubric
 _Note for @assessor: Describe SPECIFIC behaviors. Avoid vague words like "good" or "understand."_
 
 | Criteria | Weight | Excellent (4) | Proficient (3) | Developing (2) | Beginning (1) |

package/dist/templates/SCIENCE_LAB_template.md

@@ -11,8 +11,14 @@ template_contract: "artifact-template-v1"
 template_required_sections:
   - "Guiding Inquiry & Driving Question"
   - "Hypothesis & Experimental Design"
+  - "Controlled Variables:"
   - "Data Collection & Code Lab Protocol"
+  - "Lab Setup & Instrumentation Code:"
+  - "Data Collection Table:"
   - "CER Scientific Conclusion (Claim, Evidence, Reasoning)"
+  - "📌 Claim (Khẳng định):"
+  - "📊 Evidence (Bằng chứng số liệu):"
+  - "🧠 Reasoning (Lập luận khoa học):"
   - "Peer Review & Verification Protocol"
 ---
 <!-- INJECT_BODY -->
@@ -20,13 +26,13 @@ template_required_sections:
 # STEM / CODE INVESTIGATION LAB (CER): [LAB TITLE]
 _Unit: U[X] | Module: M[X.X] | Domain: [Scientific / Engineering Domain]_
 
-## [REQUIRED] Guiding Inquiry & Driving Question
+## Guiding Inquiry & Driving Question
 - **Real-World Driving Question:** [E.g., "How does thread contention affect application frame rate (FPS) and memory throughput under heavy load?"]
 - **Engineering Phenomenon:** [E.g., "When two tasks write to the same mutable array simultaneously, why does the program crash intermittently rather than every single run?"]
 
 ---
 
-## [REQUIRED] Hypothesis & Experimental Design
+## Hypothesis & Experimental Design
 - **Student Hypothesis Template:**  
   > *"If we [Action / Variable Manipulation, e.g., 'isolate the shared mutable resource inside an Actor instead of using a global lock'], then [Predicted Outcome, e.g., 'data races will drop to zero and UI thread latency will remain under 16ms'] because [Scientific / Engineering Rationale]."*
 
@@ -37,7 +43,7 @@ _Unit: U[X] | Module: M[X.X] | Domain: [Scientific / Engineering Domain]_
 
 ---
 
-## [REQUIRED] Data Collection & Code Lab Protocol
+## Data Collection & Code Lab Protocol
 
 ### Lab Setup & Instrumentation Code:
 ```swift
@@ -61,7 +67,7 @@ struct BenchmarkProbe {
 
 ---
 
-## [REQUIRED] CER Scientific Conclusion (Claim, Evidence, Reasoning)
+## CER Scientific Conclusion (Claim, Evidence, Reasoning)
 > *Students must write their conclusion strictly following the 3-part CER framework:*
 
 ### 1. 📌 Claim (Khẳng định):
@@ -84,5 +90,5 @@ struct BenchmarkProbe {
 
 ---
 
-## [REQUIRED] Peer Review & Verification Protocol
+## Peer Review & Verification Protocol
 - **Reproducibility Test:** Exchange code probes with another student group to verify if their experimental results match within a $\pm 10\%$ tolerance band.

package/dist/templates/SELF_LAB_template.md

@@ -7,6 +7,13 @@ difficulty: "{{DIFFICULTY}}"
 estimated_minutes: {{ESTIMATED_MINUTES}}
 tech_stack: {{TECH_STACK}}
 ---
+template_required_sections:
+  - "📋 Mission Briefing & Environment Setup"
+  - "🛫 Preflight Checklist"
+  - "🎯 Progressive Challenges (3-Tier Differentiation)"
+  - "🔍 Self-Learner Troubleshooting Matrix"
+  - "🏁 Final Lab Submission & Mastery Checklist"
+---
 
 # 🚀 Self-Paced Hands-On Lab: {{TITLE}}
 

package/dist/templates/SLIDE_template.md

@@ -5,6 +5,29 @@ paginate: true
 header: "{{HEADER_TITLE}}"
 footer: "LearnWell Platform | {{LESSON_ID}}"
 ---
+template_required_sections:
+  - "🗺️ Agenda & Milestone Journey Map"
+  - "⚡ Warm-Up: Diagnostic Quick-Fire"
+  - "🧠 Prior Knowledge Recall"
+  - "🎯 Hook Scenario: The Engineering Dilemma"
+  - "⚠️ System Failure in Production:"
+  - "💡 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"
+  - "🟢 Green Light (Ready to Accelerate)"
+  - "🟡 Yellow Light (Need Quick Assist)"
+  - "🔴 Red Light (Blocked)"
+  - "🎟️ Exit Ticket & Metacognition (5 Mins)"
+  - "🏁 Summary & Key Takeaways"
+  - "🏆 Core Rules to Remember:"
+  - "🔮 Next Milestone Preview:"
+---
 
 <!-- Slide 1: Title & Inquiry Mission Hook -->
 # 🚀 {{TITLE}}

package/dist/templates/STATION_ROTATION_template.md

@@ -10,18 +10,18 @@ date: "{{DATE}}"
 template_contract: "artifact-template-v1"
 template_required_sections:
   - "Station Architecture & Timer Overview"
-  - "Station 1: Teacher-Led Small Group (Deep Dive)"
-  - "Station 2: Collaborative Hands-On Lab (Peer Pair)"
-  - "Station 3: Independent Digital Practice (Async Code)"
-  - "Station 4: Offline Modeling & Architecture (Whiteboard)"
-  - "Station Recording Sheet & Rotation Bell Protocol"
+  - "Station 1: Teacher-Led Small Group (Guided Inquiry)"
+  - "Station 2: Collaborative Hands-On Lab (Pair Programming)"
+  - "Station 3: Independent Digital Practice (Self-Paced Code Lab)"
+  - "Station 4: Offline Modeling & Architecture (No Screens)"
+  - "Station Recording Sheet (Student Passport)"
 ---
 <!-- INJECT_BODY -->
 
 # STATION ROTATION LESSON PACK: [LESSON TITLE]
 _Unit: U[X] | Module: M[X.X] | Format: 4 Stations x 15 Mins (Total 60-75 Mins)_
 
-## [REQUIRED] Station Architecture & Timer Overview
+## Station Architecture & Timer Overview
 - **Classroom Layout:** 4 designated physical zones with clear signage and materials.
 - **Rotation Time:** 15 minutes per station + 2 minutes clean transition buffer.
 - **Audience Grouping:** Heterogeneous groups of 4-6 students rotating simultaneously.
@@ -38,7 +38,7 @@ _Unit: U[X] | Module: M[X.X] | Format: 4 Stations x 15 Mins (Total 60-75 Mins)_
 
 ---
 
-## [REQUIRED] Station 1: Teacher-Led Small Group (Guided Inquiry)
+## Station 1: Teacher-Led Small Group (Guided Inquiry)
 - **Goal:** Direct coaching, conceptual check, and resolving misconceptions in real-time.
 - **Teacher Script & Inquiry Questions:**
   - *"Look at this code on the monitor. If we call this function 100 times concurrently, what invariant breaks?"*
@@ -47,7 +47,7 @@ _Unit: U[X] | Module: M[X.X] | Format: 4 Stations x 15 Mins (Total 60-75 Mins)_
 
 ---
 
-## [REQUIRED] Station 2: Collaborative Hands-On Lab (Pair Programming)
+## Station 2: Collaborative Hands-On Lab (Pair Programming)
 - **Goal:** Students work in pairs (Driver / Navigator) to solve a 2-stage challenge.
 - **Task Materials:** Pre-loaded project on workstation `Station2_PairChallenge.xcodeproj`.
 - **Protocol:** Switch Driver/Navigator roles at the 7-minute audio chime.
@@ -55,7 +55,7 @@ _Unit: U[X] | Module: M[X.X] | Format: 4 Stations x 15 Mins (Total 60-75 Mins)_
 
 ---
 
-## [REQUIRED] Station 3: Independent Digital Practice (Self-Paced Code Lab)
+## Station 3: Independent Digital Practice (Self-Paced Code Lab)
 - **Goal:** Autonomy and individual mastery verification.
 - **Student Instructions:**
   1. Open Interactive Code Runner / LMS assignment module.
@@ -64,14 +64,14 @@ _Unit: U[X] | Module: M[X.X] | Format: 4 Stations x 15 Mins (Total 60-75 Mins)_
 
 ---
 
-## [REQUIRED] Station 4: Offline Modeling & Architecture (No Screens)
+## Station 4: Offline Modeling & Architecture (No Screens)
 - **Goal:** Cognitive unloading and physical spatial reasoning.
 - **Materials:** Whiteboard markers, physical Task Cards deck, and laminated architecture templates.
 - **Task:** Hand-draw the data-flow flowchart or match physical cards connecting UI Event $\rightarrow$ State Mutation $\rightarrow$ Screen Re-render.
 
 ---
 
-## [REQUIRED] Station Recording Sheet (Student Passport)
+## Station Recording Sheet (Student Passport)
 | Station | Task Completed | Signature / Verification Stamp | 1 Key Insight Learned |
 | :---: | :--- | :--- | :--- |
 | **1 (Teacher)** | Debugging Probe Discussion | [Teacher Stamp] | |

package/dist/templates/TASK_CARDS_template.md

@@ -10,9 +10,9 @@ date: "{{DATE}}"
 template_contract: "artifact-template-v1"
 template_required_sections:
   - "Deck Overview & Print Instructions"
-  - "Task Cards 1 to 4 (Foundational Concepts)"
-  - "Task Cards 5 to 8 (Code Diagnosis & Debugging)"
-  - "Task Cards 9 to 12 (Application & Synthesis)"
+  - "Set A: Foundational Concepts (Cards 1–4)"
+  - "Set B: Code Diagnosis & Debugging (Cards 5–8)"
+  - "Set C: Application & Synthesis (Cards 9–12)"
   - "Teacher Answer Key & Scoring Matrix"
 ---
 <!-- INJECT_BODY -->
@@ -20,14 +20,14 @@ template_required_sections:
 # PRINTABLE TASK CARDS PACK: [LESSON TITLE]
 _Unit: U[X] | Module: M[X.X] | Total Cards: 12-16 Cards | Usage: Centers, Fast Finishers, Small Group Review_
 
-## [REQUIRED] Deck Overview & Print Instructions
+## Deck Overview & Print Instructions
 - **Card Format:** 4 cards per page (A4 layout with cutting guidelines and QR code link).
 - **Target Skills:** Conceptual Understanding, Code Tracing, Bug Hunting, Architectural Reasoning.
 - **Scoring System:** Bronze Cards (1 pt), Silver Cards (2 pts), Gold Cards (3 pts).
 
 ---
 
-## [REQUIRED] Set A: Foundational Concepts (Cards 1–4)
+## Set A: Foundational Concepts (Cards 1–4)
 
 ```
 ┌──────────────────────────────────────────────┬──────────────────────────────────────────────┐
@@ -50,7 +50,7 @@ _Unit: U[X] | Module: M[X.X] | Total Cards: 12-16 Cards | Usage: Centers, Fast F
 
 ---
 
-## [REQUIRED] Set B: Code Diagnosis & Debugging (Cards 5–8)
+## Set B: Code Diagnosis & Debugging (Cards 5–8)
 
 ```
 ┌──────────────────────────────────────────────┬──────────────────────────────────────────────┐
@@ -74,7 +74,7 @@ _Unit: U[X] | Module: M[X.X] | Total Cards: 12-16 Cards | Usage: Centers, Fast F
 
 ---
 
-## [REQUIRED] Set C: Application & Synthesis (Cards 9–12)
+## Set C: Application & Synthesis (Cards 9–12)
 
 ```
 ┌──────────────────────────────────────────────┬──────────────────────────────────────────────┐
@@ -94,7 +94,7 @@ _Unit: U[X] | Module: M[X.X] | Total Cards: 12-16 Cards | Usage: Centers, Fast F
 
 ---
 
-## [REQUIRED] Teacher Answer Key & Scoring Matrix
+## Teacher Answer Key & Scoring Matrix
 | Card ID | Correct Answer / Solution Blueprint | Max Points |
 | :---: | :--- | :---: |
 | **01** | `@State` owns private source of truth; `@Binding` creates a 2-way reference without owning storage. | 1 pt |

package/dist/templates/TIERED_PRACTICE_template.md

@@ -10,18 +10,22 @@ date: "{{DATE}}"
 template_contract: "artifact-template-v1"
 template_required_sections:
   - "Computational Objective & Tier Matrix"
-  - "Bronze Tier (Foundational Scaffolding)"
-  - "Silver Tier (Independent Application)"
-  - "Gold Tier (Enrichment & Optimization)"
-  - "Automated Test Verification Matrix"
-  - "Answer Key & Mentor Hints"
+  - "🥉 Bronze Tier: Foundational Scaffolding (Baseline for All)"
+  - "Starter Code & Fill-in Slots:"
+  - "🥈 Silver Tier: Independent Application (Target Mastery)"
+  - "Specification & Requirements:"
+  - "Implementation Target:"
+  - "🥇 Gold Tier: Enrichment & Optimization (Open Extension)"
+  - "Constraints & Invariants:"
+  - "Automated Test Verification Matrix & Mentor Hints"
+  - "Mentor Debugging Cheatsheet:"
 ---
 <!-- INJECT_BODY -->
 
 # 3-TIER DIFFERENTIATED PRACTICE LAB: [LESSON TITLE]
 _Unit: U[X] | Module: M[X.X] | Lesson: Lesson [XX] | Mode: Adaptive Lab_
 
-## [REQUIRED] Computational Objective & Tier Matrix
+## Computational Objective & Tier Matrix
 > *Principle: All students MUST achieve Bronze; Silver is target mastery; Gold is for gifted/accelerated learners.*
 
 | Tier Level | Cognitive Target (Bloom) | Scaffolding Ratio | Success Criteria |
@@ -32,7 +36,7 @@ _Unit: U[X] | Module: M[X.X] | Lesson: Lesson [XX] | Mode: Adaptive Lab_
 
 ---
 
-## [REQUIRED] 🥉 Bronze Tier: Foundational Scaffolding (Baseline for All)
+## 🥉 Bronze Tier: Foundational Scaffolding (Baseline for All)
 - **Target Audience:** All learners (mandatory milestone).
 - **Guiding Prompt:** [Clear, unambiguous instruction with concrete references to Handout].
 
@@ -62,7 +66,7 @@ struct [BronzeComponentView]: View {
 
 ---
 
-## [REQUIRED] 🥈 Silver Tier: Independent Application (Target Mastery)
+## 🥈 Silver Tier: Independent Application (Target Mastery)
 - **Target Audience:** Learners who completed Bronze without mentor intervention.
 - **Guiding Prompt:** [Add dynamic logic, validation, state mutations, or multiple interactive elements].
 
@@ -82,7 +86,7 @@ struct [SilverComponentView]: View {
 
 ---
 
-## [REQUIRED] 🥇 Gold Tier: Enrichment & Optimization (Open Extension)
+## 🥇 Gold Tier: Enrichment & Optimization (Open Extension)
 - **Target Audience:** Advanced learners finished ahead of schedule.
 - **Architectural Challenge:** [E.g., "Decouple state into an isolated Actor / ViewModel with async/await Debounce or Cache invalidation"].
 
@@ -92,7 +96,7 @@ struct [SilverComponentView]: View {
 
 ---
 
-## [REQUIRED] Automated Test Verification Matrix & Mentor Hints
+## Automated Test Verification Matrix & Mentor Hints
 ```swift
 // XCTest / Unit Test Suite for Instant Auto-Grading
 final class [ArtifactTestSuite]: XCTestCase {

package/dist/templates/UPDATE_ROADMAP_template.md

@@ -8,6 +8,13 @@ deliverable: "{{DELIVERABLE_CODE}}"
 version: "{{VERSION}}"
 date: "{{DATE}}"
 ---
+template_required_sections:
+  - "Update Triggers"
+  - "Planned Releases"
+  - "📌 Short-term: Update v1.1 (Post-Pilot)"
+  - "📌 Long-term: Version v2.0 (Next Academic Year)"
+  - "Resources & Archiving"
+---
 
 # CURRICULUM UPDATE ROADMAP
 

package/dist/templates/WKS_template.md

@@ -15,14 +15,13 @@ template_required_sections:
   - "Part 4: Synthesis & Problem-Solving Application"
   - "Part 5: Self-Reflection & Learning Log"
 ---
-
 # WORKSHEET: [LESSON TITLE]
 
 **Student Name:** _______________________  **Class:** _______________  **Date:** _______________
 
 > **For Students:** This document guides you step-by-step through the practical tasks. Read carefully, fill in the blanks, and mark the checkbox [x] once completed. If you encounter errors, refer back to your **HANDOUT**.
 
-## [REQUIRED] Part 1: Knowledge Check
+## Part 1: Knowledge Check
 > Warm-up — prior-knowledge retrieval. Link back to the previous lesson.
 
 1. **Fill in the blanks:**
@@ -34,7 +33,7 @@ template_required_sections:
    | 1. [Concept A] | 1 - __ | a. [Meaning A] |
    | 2. [Concept B] | 2 - __ | b. [Meaning B] |
 
-## [REQUIRED] Part 2: Concept Tracing & Diagram Fill-in
+## Part 2: Concept Tracing & Diagram Fill-in
 > Trace data/control flow through this lesson's core mechanism. Fill the
 > Mermaid/ASCII diagram blanks.
 
@@ -46,7 +45,7 @@ graph LR
 
 - **Trace question:** [What flows from stage to stage? What transforms?]
 
-## [REQUIRED] Part 3: Code Analysis & Bug Hunting Challenge
+## Part 3: Code Analysis & Bug Hunting Challenge
 > One complete, runnable snippet containing a real bug from this lesson's
 > Common Mistakes. Students locate, explain, and fix it.
 
@@ -58,13 +57,13 @@ graph LR
 - **Why it fails:** [Student explanation]
 - **Fix:** [Student correction]
 
-## [REQUIRED] Part 4: Synthesis & Problem-Solving Application
+## Part 4: Synthesis & Problem-Solving Application
 > Apply the lesson's skill to a fresh scenario — not a copy of the lab task.
 
 - **Scenario:** [New situation requiring the same skill]
 - **Your solution:** [Workspace / code area]
 
-## [REQUIRED] Part 5: Self-Reflection & Learning Log
+## Part 5: Self-Reflection & Learning Log
 - **I can now…** [Can-do statements mirroring the LESSON LO evidence — checkbox each]
   - [ ] [Can-do statement 1]
   - [ ] [Can-do statement 2]