@thanh01.pmt/curriculum-kit 1.4.44 → 1.4.46

package/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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]

package/dist/templates/HANDOVER_DOCUMENT_template.md

@@ -8,6 +8,14 @@ deliverable: "{{DELIVERABLE_CODE}}"
 version: "{{VERSION}}"
 date: "{{DATE}}"
 ---
+template_required_sections:
+  - "Handover Information"
+  - "Deliverables Inventory"
+  - "Commitment vs. Reality Check"
+  - "Scope Exclusions"
+  - "Getting Started Guide"
+  - "Post-Handover Support Policy"
+---
 
 # CURRICULUM HANDOVER DOCUMENT
 _Handover Date: [YYYY-MM-DD] | Version: v[X.X]_

package/dist/templates/KNOWLEDGE_EXPOSITION_template.md

@@ -1,3 +1,13 @@
+---
+template_required_sections:
+  - "Session Scope"
+  - "Key Terms"
+  - "Concept Narratives"
+  - "Worked Micro-Examples"
+  - "Common Mistakes"
+  - "Self-Check Questions"
+---
+
 # KNOWLEDGE_EXPOSITION: {{lesson_code}} — {{session_title}}
 
 ---
@@ -11,7 +21,7 @@ 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
+## Session Scope
 
 - **Objective:** {{prose_objective}}
 - **New keywords:** {{new_keywords}}
@@ -19,13 +29,13 @@ Scope: exactly the knowledge planned for this session — no more, no less._
 - **Depth targets:** {{depth_targets}}
 - **You can demonstrate, after this session:** {{exit_evidence}}
 
-## [REQUIRED] Key Terms
+## Key Terms
 
 <!-- One block per term in glossary scope. Definitions MUST match GLOSSARY.json. -->
 
 {{key_terms}}
 
-## [REQUIRED] Concept Narratives
+## 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)
@@ -35,17 +45,17 @@ Scope: exactly the knowledge planned for this session — no more, no less._
 
 {{concept_narratives}}
 
-## [REQUIRED] Worked Micro-Examples
+## Worked Micro-Examples
 
 <!-- Minimal examples traceable to references from the domain graph. -->
 
 {{worked_examples}}
 
-## [REQUIRED] Common Mistakes
+## Common Mistakes
 
 {{common_mistakes}}
 
-## [REQUIRED] Self-Check Questions
+## Self-Check Questions
 
 <!-- 3-5 questions mapped to exit evidence. Answers at the very end. -->
 

package/dist/templates/LAB_TEMPLATE.md

@@ -8,6 +8,17 @@ deliverable: "P3-T2"
 version: "{{VERSION}}"
 date: "{{DATE}}"
 ---
+template_required_sections:
+  - "🎯 Overview"
+  - "🛠️ Environment & Setup"
+  - "📝 Lab Tasks (3-Tier Differentiation)"
+  - "🥉 Bronze (Foundational)"
+  - "🥈 Silver (Application)"
+  - "🥇 Gold (Enrichment/Creative)"
+  - "🔍 Troubleshooting & Debugging"
+  - "🏁 Submission & Check-off"
+---
+
 <!-- INJECT_BODY -->
 
 # 👨‍💻 CODE LAB: [LAB TITLE]
@@ -24,17 +35,23 @@ This lab focuses on the practical implementation of the technical concepts cover
 
 ## 📝 Lab Tasks (3-Tier Differentiation)
 
-### 🥉 Bronze (Foundational) - [X mins]
+### 🥉 Bronze (Foundational)
+
+> **Duration:** {{ XX }} mins
 **Objective:** Establish basic functionality.
 - **Task:** [e.g., Create a basic script to read data from the DHT11 sensor.]
 - **Requirement:** Code MUST be syntactically correct and run without errors.
 
-### 🥈 Silver (Application) - [Y mins]
+### 🥈 Silver (Application)
+
+> **Duration:** {{ XX }} mins
 **Objective:** Add logic and data processing.
 - **Task:** [e.g., Add a conditional statement to turn on an LED if the temperature exceeds 30°C.]
 - **Requirement:** Demonstrate understanding of control flow and data comparison.
 
-### 🥇 Gold (Enrichment/Creative) - [Z mins]
+### 🥇 Gold (Enrichment/Creative)
+
+> **Duration:** {{ XX }} mins
 **Objective:** Optimize, extend, or integrate.
 - **Task:** [e.g., Log the temperature data to a local CSV file with timestamps.]
 - **Requirement:** Show advanced resource management (file I/O, timing, or external API integration).

package/dist/templates/LEARNER_PROFILE_template.md

@@ -14,29 +14,28 @@ template_required_sections:
   - "Learning Context"
   - "Client Objectives"
 ---
-
 # LEARNER PROFILE
 
 
-## [REQUIRED] Foundational Info
+## 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
+## 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
+## 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
+## Client Objectives
 - **Core Goal:** [What the client wants students to achieve - max 3 points]
 - **Standard Alignment:** [E.g., CSTA / K12 CS Framework / Local Standards]
 

package/dist/templates/LESSONS_LEARNED_template.md

@@ -8,6 +8,14 @@ deliverable: "{{DELIVERABLE_CODE}}"
 version: "{{VERSION}}"
 date: "{{DATE}}"
 ---
+template_required_sections:
+  - "Project Metadata"
+  - "What Worked Well (Successes)"
+  - "What Didn't Work (Failures/Bottlenecks)"
+  - "Key Design Decisions (Architecture Log)"
+  - "Actionable Improvements for Future Projects"
+  - "Open Questions / Post-Deployment Monitoring"
+---
 
 # PROJECT LESSONS LEARNED
 

package/dist/templates/LESSON_5E_template.md

@@ -17,13 +17,18 @@ template_required_sections:
   - "Assessment Map"
   - "Artifact Contract"
   - "B. Lesson Flow"
-  - "Artifact Linkage"
+  - "ENGAGE"
+  - "EXPLORE"
+  - "EXPLAIN"
+  - "ELABORATE"
+  - "EVALUATE"
+  - "Artifact Linkage (Master Index)"
 ---
 <!-- INJECT_BODY -->
 
 # LESSON [XX]: [LESSON TITLE] (5E Model)
 
-## [REQUIRED] A. Lesson Design Plan
+## A. Lesson Design Plan
 
 > OWNERSHIP: Each fact lives in exactly ONE section. The Artifact Contract
 > column (row 11) of the Activity Sequence is the single owner of which
@@ -76,22 +81,30 @@ template_required_sections:
 
 ---
 
-## [REQUIRED] B. Lesson Flow
+## B. Lesson Flow
 
-### 1. ENGAGE — [X mins]
+### 1. ENGAGE
+
+> **Duration:** {{ XX }} mins
 - **Hook Scenario:** [Provide a detailed real-world situation or story to grab attention. E.g., "Roleplay as a server room engineer at 3 AM."]
 - **Open Question:** [Explicitly state the question the teacher will ask the class.]
 - **Transition:** [How the teacher summarizes to move to the Explore phase.]
 
-### 2. EXPLORE — [X mins]
+### 2. EXPLORE
+
+> **Duration:** {{ XX }} mins
 - **Activity Reference:** [Summarize the planned activity from the Activity Sequence. Detailed operation belongs in ACT, but the design decision lives here.]
 - **Student Discovery:** [What students should notice before formal explanation.]
 
-### 3. EXPLAIN — [X mins]
+### 3. EXPLAIN
+
+> **Duration:** {{ XX }} mins
 - **Definitions:** [Explain the core concepts.]
 - **Visual Illustration (REQUIRED):** [MUST include a specific example of data, code, JSON payload, or a Mermaid diagram to visualize the concept. No abstract-only explanations.]
 
-### 4. ELABORATE — [X mins]
+### 4. ELABORATE
+
+> **Duration:** {{ XX }} mins
 - **Tiered Scaffolding:**
   - 🥉 **Bronze:** [Overview of the foundational task]
   - 🥈 **Silver:** [Overview of the application task]
@@ -99,7 +112,9 @@ template_required_sections:
 
 > **ACT Contract**: Detailed operational instructions must expand the Activity Sequence above and must not change the planned evidence target.
 
-### 5. EVALUATE — [X mins]
+### 5. EVALUATE
+
+> **Duration:** {{ XX }} mins
 - **Exit Ticket:** [Provide 1-2 specific questions to quickly check mastery of the success criteria.]
 - **Closing:** [Final remarks and wrap-up notes.]
 
@@ -113,7 +128,7 @@ template_required_sections:
 
 ---
 
-## [REQUIRED] Artifact Linkage (Master Index)
+## Artifact Linkage (Master Index)
 > List all satellite files used in this lesson.
 
 | Artifact File | Role in the Classroom | When to Use |

package/dist/templates/LESSON_EDP_template.md

@@ -17,12 +17,16 @@ template_required_sections:
   - "Assessment Map"
   - "Artifact Contract"
   - "B. Lesson Flow"
-  - "Artifact Linkage"
+  - "ASK (Define the Problem)"
+  - "IMAGINE (Ideate)"
+  - "PLAN (Design)"
+  - "CREATE (Build & Code)"
+  - "TEST & IMPROVE (Iterate)"
+  - "SHARE & EVALUATE (Present)"
 ---
-
 # LESSON [XX]: [PROJECT TITLE] (EDP Model - Engineering Design Process)
 
-## [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,26 +77,38 @@ template_required_sections:
 
 ---
 
-## [REQUIRED] B. Lesson Flow
+## B. Lesson Flow
+
+### 1. ASK (Define the Problem)
 
-### 1. ASK (Define the Problem) — [X mins]
+> **Duration:** {{ XX }} mins
 [Set the context/story. What are the project requirements and constraints? (E.g., Build an obstacle-avoiding robot, budget under $10, use max 2 sensors).]
 
-### 2. IMAGINE (Ideate) — [X mins]
+### 2. IMAGINE (Ideate)
+
+> **Duration:** {{ XX }} mins
 [Students brainstorm possible solutions. Teacher suggests different approaches.]
 
-### 3. PLAN (Design) — [X mins]
+### 3. PLAN (Design)
+
+> **Duration:** {{ XX }} mins
 [Students draw circuit diagrams, create flowcharts, or write pseudocode before physical assembly.]
 
-### 4. CREATE (Build & Code) — [X mins]
+### 4. CREATE (Build & Code)
+
+> **Duration:** {{ XX }} mins
 [Students start hardware assembly and typing code based on their design.]
 
 > **ACT Contract**: Detailed operational instructions must expand the Activity Sequence above and must not change the planned evidence target.
 
-### 5. TEST & IMPROVE (Iterate) — [X mins]
+### 5. TEST & IMPROVE (Iterate)
+
+> **Duration:** {{ XX }} mins
 [Students test their product, record bugs, and proceed with debugging/iteration.]
 
-### 6. SHARE & EVALUATE (Present) — [X mins]
+### 6. SHARE & EVALUATE (Present)
+
+> **Duration:** {{ XX }} mins
 [Students demo their product, explain how it works, and highlight improvements made.]
 
 > **QUIZ Contract**: Detailed project rubrics must assess the evidence and success criteria defined in the Lesson Design Plan.