@thanh01.pmt/curriculum-kit 1.4.43 → 1.4.45

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/SECTION_LANGUAGE_CONTRACT_template.md

@@ -0,0 +1,44 @@
+---
+id: "{{ID}}"
+type: "SECTION_LANGUAGE_CONTRACT"
+created_by: "Curriculum OS Builder"
+phase: "P2"
+deliverable: "P2-T4"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+target_language: "{{TARGET_LANGUAGE}}"
+template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Metadata & Scope"
+  - "Section Translation Matrix"
+  - "Validation Rules"
+---
+# SECTION LANGUAGE CONTRACT
+
+## Metadata & Scope
+- **Project:** {{PROJECT_NAME}}
+- **Target output language:** {{TARGET_LANGUAGE_DISPLAY}}
+- **Scope:** heading/label localization for every generated artifact of this project only.
+
+## Section Translation Matrix
+> One row per canonical section key (from each template's
+> `template_required_sections`). The Localized Heading is what the LLM must
+> render verbatim in artifacts; P53 bake applies these rows onto the project's
+> `_templates/` copies. Do not translate technical identifiers.
+
+| Artifact | Canonical Section Key | Localized Heading ({{TARGET_LANGUAGE}}) |
+|---|---|---|
+| LESSON | A. Lesson Design Plan | [localized] |
+| LESSON | B. Lesson Flow | [localized] |
+| ACT | Computational Thinking Focus | [localized] |
+| QUIZ | Assessment Objectives | [localized] |
+<!-- Repeat per artifact type and section key. -->
+
+## Validation Rules
+- Every canonical key in a template's `template_required_sections` MUST have
+  exactly one row here before bake (missing row → that section keeps its
+  canonical English heading).
+- Keys MUST match the template contract after ordinal/marker stripping
+  (`1. ` and `[REQUIRED]` ignored).
+- Localized headings MUST NOT contain contract markers or CJK glyphs outside
+  the target language script rules.

package/dist/templates/SELF_LAB_template.md

@@ -0,0 +1,174 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "SELF_LAB"
+language: "{{LANGUAGE}}"
+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}}
+
+> ⏱️ **Estimated Duration:** ~{{ESTIMATED_MINUTES}} mins  
+> 🎯 **Difficulty Level:** {{DIFFICULTY_UPPER}}  
+> 🧰 **Tech Stack:** {{TECH_STACK_STR}}  
+> 💡 **Self-Learner Notice:** You are in full control of this lab. Follow the progressive challenges below. If you get stuck at any point, use the **Progressive Hints System** to get unstuck without ruining the learning experience!
+
+---
+
+## 📋 Mission Briefing & Environment Setup
+{{MISSION_BRIEFING}}
+
+### 🛫 Preflight Checklist
+{{PREFLIGHT_CHECKLIST}}
+
+---
+
+## 🎯 Progressive Challenges (3-Tier Differentiation)
+
+### 🥉 Challenge 1: Foundational Core (Bronze) — ~{{BRONZE_MINS}} mins
+**Objective:** {{BRONZE_OBJECTIVE}}
+
+#### Tasks & Implementation Details:
+{{BRONZE_TASKS}}
+
+#### 🧪 Self-Verification Command:
+```bash
+{{BRONZE_VERIFY_COMMAND}}
+```
+*Expected Terminal Output:*
+```text
+{{BRONZE_EXPECTED_OUTPUT}}
+```
+
+#### 💡 Progressive Hints (Expand only if stuck):
+<details>
+<summary><b>💡 Hint Level 1: Conceptual Clue</b></summary>
+
+{{BRONZE_HINT_1}}
+</details>
+
+<details>
+<summary><b>🔍 Hint Level 2: Structural Skeleton</b></summary>
+
+```{{CODE_LANGUAGE}}
+{{BRONZE_HINT_2}}
+```
+</details>
+
+<details>
+<summary><b>🚨 Hint Level 3: Full Solution & Explanation</b></summary>
+
+```{{CODE_LANGUAGE}}
+{{BRONZE_HINT_3_CODE}}
+```
+
+**Why this solution works:**
+{{BRONZE_HINT_3_EXPLANATION}}
+</details>
+
+---
+
+### 🥈 Challenge 2: Logic & Error Handling (Silver) — ~{{SILVER_MINS}} mins
+**Objective:** {{SILVER_OBJECTIVE}}
+
+#### Tasks & Implementation Details:
+{{SILVER_TASKS}}
+
+#### 🧪 Self-Verification Command:
+```bash
+{{SILVER_VERIFY_COMMAND}}
+```
+*Expected Terminal Output:*
+```text
+{{SILVER_EXPECTED_OUTPUT}}
+```
+
+#### 💡 Progressive Hints (Expand only if stuck):
+<details>
+<summary><b>💡 Hint Level 1: Conceptual Clue</b></summary>
+
+{{SILVER_HINT_1}}
+</details>
+
+<details>
+<summary><b>🔍 Hint Level 2: Structural Skeleton</b></summary>
+
+```{{CODE_LANGUAGE}}
+{{SILVER_HINT_2}}
+```
+</details>
+
+<details>
+<summary><b>🚨 Hint Level 3: Full Solution & Explanation</b></summary>
+
+```{{CODE_LANGUAGE}}
+{{SILVER_HINT_3_CODE}}
+```
+
+**Why this solution works:**
+{{SILVER_HINT_3_EXPLANATION}}
+</details>
+
+---
+
+### 🥇 Challenge 3: Edge Cases & Optimization (Gold) — ~{{GOLD_MINS}} mins
+**Objective:** {{GOLD_OBJECTIVE}}
+
+#### Tasks & Implementation Details:
+{{GOLD_TASKS}}
+
+#### 🧪 Self-Verification Command:
+```bash
+{{GOLD_VERIFY_COMMAND}}
+```
+*Expected Terminal Output:*
+```text
+{{GOLD_EXPECTED_OUTPUT}}
+```
+
+#### 💡 Progressive Hints (Expand only if stuck):
+<details>
+<summary><b>💡 Hint Level 1: Conceptual Clue</b></summary>
+
+{{GOLD_HINT_1}}
+</details>
+
+<details>
+<summary><b>🔍 Hint Level 2: Structural Skeleton</b></summary>
+
+```{{CODE_LANGUAGE}}
+{{GOLD_HINT_2}}
+```
+</details>
+
+<details>
+<summary><b>🚨 Hint Level 3: Full Solution & Explanation</b></summary>
+
+```{{CODE_LANGUAGE}}
+{{GOLD_HINT_3_CODE}}
+```
+
+**Why this solution works:**
+{{GOLD_HINT_3_EXPLANATION}}
+</details>
+
+---
+
+## 🔍 Self-Learner Troubleshooting Matrix
+| Symptom / Error Message | Root Cause | Exact Fix |
+| :--- | :--- | :--- |
+{{TROUBLESHOOTING_ROWS}}
+
+---
+
+## 🏁 Final Lab Submission & Mastery Checklist
+{{FINAL_CHECKLIST}}

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 |