@thanh01.pmt/curriculum-kit 1.4.43 → 1.4.45

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (121) hide show
  1. package/dist/ai/index.cjs +66 -470
  2. package/dist/ai/index.cjs.map +1 -1
  3. package/dist/ai/index.d.cts +77 -77
  4. package/dist/ai/index.d.ts +77 -77
  5. package/dist/ai/index.mjs +64 -469
  6. package/dist/ai/index.mjs.map +1 -1
  7. package/dist/index.cjs +478 -837
  8. package/dist/index.cjs.map +1 -1
  9. package/dist/index.d.cts +124 -58
  10. package/dist/index.d.ts +124 -58
  11. package/dist/index.mjs +470 -829
  12. package/dist/index.mjs.map +1 -1
  13. package/dist/pipeline/index.cjs +99 -484
  14. package/dist/pipeline/index.cjs.map +1 -1
  15. package/dist/pipeline/index.mjs +97 -483
  16. package/dist/pipeline/index.mjs.map +1 -1
  17. package/dist/schemas/index.d.cts +1064 -1064
  18. package/dist/schemas/index.d.ts +1064 -1064
  19. package/dist/standards/index.d.cts +2 -2
  20. package/dist/standards/index.d.ts +2 -2
  21. package/dist/{standardsCoverageGate-49pJq5t8.d.cts → standardsCoverageGate-CLnq0d0s.d.cts} +12 -12
  22. package/dist/{standardsCoverageGate-49pJq5t8.d.ts → standardsCoverageGate-CLnq0d0s.d.ts} +12 -12
  23. package/dist/templates/ACT_template.md +18 -9
  24. package/dist/templates/ALIGNMENT_MATRIX_template.md +5 -0
  25. package/dist/templates/ART_DIRECTION_template.md +7 -0
  26. package/dist/templates/ASSET_MANIFEST_template.md +5 -0
  27. package/dist/templates/BASELINE_STANDARD.md +5 -0
  28. package/dist/templates/BELL_RINGER_template.md +13 -13
  29. package/dist/templates/CHANGELOG_template.md +3 -0
  30. package/dist/templates/CHOICE_BOARD_template.md +8 -5
  31. package/dist/templates/CODE_template.md +5 -6
  32. package/dist/templates/CONTENT_CONTINUITY_template.md +6 -0
  33. package/dist/templates/CONTENT_STYLE_GUIDE_template.md +4 -5
  34. package/dist/templates/CURRICULUM_FRAMEWORK_template.md +5 -6
  35. package/dist/templates/DEPENDENCY_MAP_template.md +3 -4
  36. package/dist/templates/EXIT_TICKET_template.md +8 -8
  37. package/dist/templates/EXT_template.md +3 -0
  38. package/dist/templates/GLOSSARY_template.md +1 -2
  39. package/dist/templates/GRAPHIC_ORGANIZER_template.md +8 -8
  40. package/dist/templates/GUIDE_template.md +5 -6
  41. package/dist/templates/HANDOUT_template.md +5 -6
  42. package/dist/templates/HANDOVER_DOCUMENT_template.md +8 -0
  43. package/dist/templates/KNOWLEDGE_EXPOSITION_template.md +16 -6
  44. package/dist/templates/LAB_TEMPLATE.md +78 -0
  45. package/dist/templates/LEARNER_PROFILE_template.md +4 -5
  46. package/dist/templates/LESSONS_LEARNED_template.md +8 -0
  47. package/dist/templates/LESSON_5E_template.md +24 -9
  48. package/dist/templates/LESSON_EDP_template.md +26 -10
  49. package/dist/templates/LESSON_GENERAL_template.md +22 -8
  50. package/dist/templates/OUTPUT_CONSTRAINTS_template.md +7 -0
  51. package/dist/templates/PACKAGING_SPEC_template.md +8 -0
  52. package/dist/templates/PILOT_FEEDBACK_template.md +6 -0
  53. package/dist/templates/PROJECT_BRIEF_template.md +8 -0
  54. package/dist/templates/PROJECT_STATUS_template.md +9 -0
  55. package/dist/templates/QUIZ_template.md +7 -0
  56. package/dist/templates/QUIZ_v4.6_template.md +4 -5
  57. package/dist/templates/REFERENCE_PACK_template.md +4 -0
  58. package/dist/templates/REVIEW_GAME_template.md +11 -8
  59. package/dist/templates/RUBRIC_template.md +2 -3
  60. package/dist/templates/SCIENCE_LAB_template.md +11 -5
  61. package/dist/templates/SECTION_LANGUAGE_CONTRACT_template.md +44 -0
  62. package/dist/templates/SELF_LAB_template.md +174 -0
  63. package/dist/templates/SLIDE_template.md +23 -0
  64. package/dist/templates/STATION_ROTATION_template.md +11 -11
  65. package/dist/templates/TASK_CARDS_template.md +8 -8
  66. package/dist/templates/TIERED_PRACTICE_template.md +14 -10
  67. package/dist/templates/UPDATE_ROADMAP_template.md +7 -0
  68. package/dist/templates/WKS_template.md +5 -6
  69. package/dist/workflow/index.cjs +250 -672
  70. package/dist/workflow/index.cjs.map +1 -1
  71. package/dist/workflow/index.d.cts +1 -1
  72. package/dist/workflow/index.d.ts +1 -1
  73. package/dist/workflow/index.mjs +248 -670
  74. package/dist/workflow/index.mjs.map +1 -1
  75. package/docs/refs/templates/ACT_template.md +18 -9
  76. package/docs/refs/templates/ALIGNMENT_MATRIX_template.md +5 -0
  77. package/docs/refs/templates/ART_DIRECTION_template.md +7 -0
  78. package/docs/refs/templates/ASSET_MANIFEST_template.md +5 -0
  79. package/docs/refs/templates/BASELINE_STANDARD.md +5 -0
  80. package/docs/refs/templates/BELL_RINGER_template.md +13 -13
  81. package/docs/refs/templates/CHANGELOG_template.md +3 -0
  82. package/docs/refs/templates/CHOICE_BOARD_template.md +8 -5
  83. package/docs/refs/templates/CODE_template.md +5 -6
  84. package/docs/refs/templates/CONTENT_CONTINUITY_template.md +6 -0
  85. package/docs/refs/templates/CONTENT_STYLE_GUIDE_template.md +4 -5
  86. package/docs/refs/templates/CURRICULUM_FRAMEWORK_template.md +5 -6
  87. package/docs/refs/templates/DEPENDENCY_MAP_template.md +3 -4
  88. package/docs/refs/templates/EXIT_TICKET_template.md +8 -8
  89. package/docs/refs/templates/EXT_template.md +3 -0
  90. package/docs/refs/templates/GLOSSARY_template.md +1 -2
  91. package/docs/refs/templates/GRAPHIC_ORGANIZER_template.md +8 -8
  92. package/docs/refs/templates/GUIDE_template.md +5 -6
  93. package/docs/refs/templates/HANDOUT_template.md +5 -6
  94. package/docs/refs/templates/HANDOVER_DOCUMENT_template.md +8 -0
  95. package/docs/refs/templates/KNOWLEDGE_EXPOSITION_template.md +16 -6
  96. package/docs/refs/templates/LAB_TEMPLATE.md +78 -0
  97. package/docs/refs/templates/LEARNER_PROFILE_template.md +4 -5
  98. package/docs/refs/templates/LESSONS_LEARNED_template.md +8 -0
  99. package/docs/refs/templates/LESSON_5E_template.md +24 -9
  100. package/docs/refs/templates/LESSON_EDP_template.md +26 -10
  101. package/docs/refs/templates/LESSON_GENERAL_template.md +22 -8
  102. package/docs/refs/templates/OUTPUT_CONSTRAINTS_template.md +7 -0
  103. package/docs/refs/templates/PACKAGING_SPEC_template.md +8 -0
  104. package/docs/refs/templates/PILOT_FEEDBACK_template.md +6 -0
  105. package/docs/refs/templates/PROJECT_BRIEF_template.md +8 -0
  106. package/docs/refs/templates/PROJECT_STATUS_template.md +9 -0
  107. package/docs/refs/templates/QUIZ_template.md +7 -0
  108. package/docs/refs/templates/QUIZ_v4.6_template.md +4 -5
  109. package/docs/refs/templates/REFERENCE_PACK_template.md +4 -0
  110. package/docs/refs/templates/REVIEW_GAME_template.md +11 -8
  111. package/docs/refs/templates/RUBRIC_template.md +2 -3
  112. package/docs/refs/templates/SCIENCE_LAB_template.md +11 -5
  113. package/docs/refs/templates/SECTION_LANGUAGE_CONTRACT_template.md +44 -0
  114. package/docs/refs/templates/SELF_LAB_template.md +174 -0
  115. package/docs/refs/templates/SLIDE_template.md +23 -0
  116. package/docs/refs/templates/STATION_ROTATION_template.md +11 -11
  117. package/docs/refs/templates/TASK_CARDS_template.md +8 -8
  118. package/docs/refs/templates/TIERED_PRACTICE_template.md +14 -10
  119. package/docs/refs/templates/UPDATE_ROADMAP_template.md +7 -0
  120. package/docs/refs/templates/WKS_template.md +5 -6
  121. package/package.json +1 -1
@@ -10,9 +10,9 @@ date: "{{DATE}}"
10
10
  template_contract: "artifact-template-v1"
11
11
  template_required_sections:
12
12
  - "Target Learning Objectives"
13
- - "Recall & Conceptual Anchor"
14
- - "Application & Bug Hunt"
15
- - "Metacognitive Reflection & Confidence Check"
13
+ - "Part 1: Recall & Conceptual Anchor (Prompt 1)"
14
+ - "Part 2: Application & Bug Hunt (Prompt 2)"
15
+ - "Part 3: Metacognitive Reflection & Confidence Check (Prompt 3)"
16
16
  - "Scoring & Teacher Intervention Trigger"
17
17
  ---
18
18
  <!-- INJECT_BODY -->
@@ -20,13 +20,13 @@ template_required_sections:
20
20
  # FORMATIVE EXIT TICKET: [LESSON TITLE]
21
21
  _Unit: U[X] | Module: M[X.X] | Lesson: Lesson [XX] | Estimated Time: 5-7 mins_
22
22
 
23
- ## [REQUIRED] Target Learning Objectives
23
+ ## Target Learning Objectives
24
24
  - **Target LO 1 (ULO):** [The universal conceptual objective being assessed, e.g., "The learner will be able to understand the immutability of declarative views."]
25
25
  - **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."]
26
26
 
27
27
  ---
28
28
 
29
- ## [REQUIRED] Part 1: Recall & Conceptual Anchor (Prompt 1)
29
+ ## Part 1: Recall & Conceptual Anchor (Prompt 1)
30
30
  > *Objective: Test core mental model without allowing rote syntax memorization.*
31
31
 
32
32
  **Question 1:**
@@ -39,7 +39,7 @@ _Unit: U[X] | Module: M[X.X] | Lesson: Lesson [XX] | Estimated Time: 5-7 mins_
39
39
 
40
40
  ---
41
41
 
42
- ## [REQUIRED] Part 2: Application & Bug Hunt (Prompt 2)
42
+ ## Part 2: Application & Bug Hunt (Prompt 2)
43
43
  > *Objective: Test code diagnosis and precise correction in ≤ 3 lines of modification.*
44
44
 
45
45
  **Code Snippet:**
@@ -65,7 +65,7 @@ struct CounterDisplay: View {
65
65
 
66
66
  ---
67
67
 
68
- ## [REQUIRED] Part 3: Metacognitive Reflection & Confidence Check (Prompt 3)
68
+ ## Part 3: Metacognitive Reflection & Confidence Check (Prompt 3)
69
69
  > *Objective: Empower student self-regulation and provide immediate diagnostic signals.*
70
70
 
71
71
  **Traffic Light Self-Assessment:**
@@ -80,6 +80,6 @@ struct CounterDisplay: View {
80
80
 
81
81
  ---
82
82
 
83
- ## [REQUIRED] Scoring & Teacher Intervention Trigger
83
+ ## Scoring & Teacher Intervention Trigger
84
84
  - **Proficiency Threshold:** Green/Yellow check + Correct Answer to Part 2 Bug Hunt.
85
85
  - **Intervention Protocol:** If $\ge 25\%$ of students mark 🔴 Red or miss Part 2, start next session with a 5-minute Live Debugging Warm-up.
@@ -8,6 +8,9 @@ deliverable: "P3-T8"
8
8
  version: "{{VERSION}}"
9
9
  date: "{{DATE}}"
10
10
  ---
11
+ template_required_sections:
12
+ - "For: Advanced Students / Extra Time"
13
+ ---
11
14
 
12
15
  # EXTENSION TASKS: [LESSON TITLE]
13
16
 
@@ -6,7 +6,6 @@ template_contract: "artifact-template-v1"
6
6
  template_required_sections:
7
7
  - "Term Glossary"
8
8
  ---
9
-
10
9
  <!--
11
10
  Created by: Curriculum OS Builder
12
11
  Phase: P3 | Deliverable: Glossary Artifact
@@ -25,7 +24,7 @@ _Unit: U[X] | Module: M[X.X] | Audience: Grade [XX] ([AGE] years old)_
25
24
 
26
25
  ---
27
26
 
28
- ## [REQUIRED] Term Glossary
27
+ ## Term Glossary
29
28
 
30
29
  <!--
31
30
  INSTRUCTIONS FOR @content:
@@ -11,22 +11,22 @@ template_contract: "artifact-template-v1"
11
11
  template_required_sections:
12
12
  - "Visual Paradigm Overview"
13
13
  - "Organizer 1: Architectural Data Flow (Mermaid Flowchart)"
14
- - "Organizer 2: Comparative Analysis (Mermaid / Markdown Venn)"
15
- - "Organizer 3: State Machine & Lifecycle (Mermaid StateDiagram)"
16
- - "Student Fill-in Worksheet Format"
14
+ - "Organizer 2: Comparative Analysis (Venn Diagram / Matrix)"
15
+ - "Organizer 3: State Machine & Lifecycle (State Diagram)"
16
+ - "Student Fill-in Worksheet Format (Offline Handout)"
17
17
  ---
18
18
  <!-- INJECT_BODY -->
19
19
 
20
20
  # VISUAL GRAPHIC ORGANIZERS: [LESSON / UNIT TITLE]
21
21
  _Unit: U[X] | Module: M[X.X] | Format: Mermaid Markdown Diagrams + Fill-in Printable Worksheets_
22
22
 
23
- ## [REQUIRED] Visual Paradigm Overview
23
+ ## Visual Paradigm Overview
24
24
  - **Cognitive Purpose:** Unload mental processing burden through spatial diagramming and dual-coding theory (Paivio).
25
25
  - **Output Formats:** Interactive Mermaid.js rendered diagrams + Printable student fill-in worksheets.
26
26
 
27
27
  ---
28
28
 
29
- ## [REQUIRED] Organizer 1: Architectural Data Flow (Mermaid Flowchart)
29
+ ## Organizer 1: Architectural Data Flow (Mermaid Flowchart)
30
30
 
31
31
  ```mermaid
32
32
  graph TD
@@ -48,7 +48,7 @@ graph TD
48
48
 
49
49
  ---
50
50
 
51
- ## [REQUIRED] Organizer 2: Comparative Analysis (Venn Diagram / Matrix)
51
+ ## Organizer 2: Comparative Analysis (Venn Diagram / Matrix)
52
52
 
53
53
  ```mermaid
54
54
  graph LR
@@ -72,7 +72,7 @@ graph LR
72
72
 
73
73
  ---
74
74
 
75
- ## [REQUIRED] Organizer 3: State Machine & Lifecycle (State Diagram)
75
+ ## Organizer 3: State Machine & Lifecycle (State Diagram)
76
76
 
77
77
  ```mermaid
78
78
  stateDiagram-v2
@@ -85,7 +85,7 @@ stateDiagram-v2
85
85
 
86
86
  ---
87
87
 
88
- ## [REQUIRED] Student Fill-in Worksheet Format (Offline Handout)
88
+ ## Student Fill-in Worksheet Format (Offline Handout)
89
89
  ```text
90
90
  ┌──────────────────────────────────────────────────────────────────────────┐
91
91
  │ STUDENT DATA FLOW FILL-IN EXERCISE │
@@ -15,23 +15,22 @@ template_required_sections:
15
15
  - "Common Misconceptions & Diagnostic Remediation Matrix"
16
16
  - "Differentiated Support Strategies"
17
17
  ---
18
-
19
18
  # TEACHER GUIDE: [LESSON TITLE]
20
19
  _For Teacher Use Only | Unit [UXX] Module [MXX]_
21
20
 
22
- ## [REQUIRED] Objectives & Preparation
21
+ ## Objectives & Preparation
23
22
  - **Pedagogical Goal:** [The main goal for the teacher to achieve during the session. Emphasize mindset shift, not just knowledge.]
24
23
  - **Technical Checklist:** [Software/hardware to install or check before class]
25
24
 
26
25
  > Misconceptions have ONE home in this document: the Remediation Matrix below.
27
26
  > Do not restate them here.
28
27
 
29
- ## [REQUIRED] Preparation Checklist & Workstation Setup
28
+ ## Preparation Checklist & Workstation Setup
30
29
  | Item | Qty / Setup | Verified? |
31
30
  |---|---|---|
32
31
  | [Hardware/software/resource] | [Per group or per class] | [ ] |
33
32
 
34
- ## [REQUIRED] Facilitation Script & Timeline
33
+ ## Facilitation Script & Timeline
35
34
  > Mirror the LESSON B-flow phase-by-phase — same phases, same minutes. Do not
36
35
  > invent a different time allocation.
37
36
 
@@ -42,7 +41,7 @@ _For Teacher Use Only | Unit [UXX] Module [MXX]_
42
41
 
43
42
  <!-- Repeat per B-flow phase. -->
44
43
 
45
- ## [REQUIRED] Common Misconceptions & Diagnostic Remediation Matrix
44
+ ## Common Misconceptions & Diagnostic Remediation Matrix
46
45
  > Extract the Common Mistakes table VERBATIM from the canonical knowledge
47
46
  > context (KX). Do not re-invent or paraphrase — one canonical list per lesson.
48
47
 
@@ -50,7 +49,7 @@ _For Teacher Use Only | Unit [UXX] Module [MXX]_
50
49
  |---|---|---|---|
51
50
  | [From KX Common Mistakes] | [Underlying reasoning error] | [Quick question that exposes it] | [Concrete reteach action] |
52
51
 
53
- ## [REQUIRED] Differentiated Support Strategies
52
+ ## Differentiated Support Strategies
54
53
  - **Support (struggling students):** [Concrete scaffolds during activities]
55
54
  - **Extension (advanced students):** [What to hand them — reference EXT artifact]
56
55
  - **Enrichment Question:** [1-2 deep-thinking questions]
@@ -15,11 +15,10 @@ template_required_sections:
15
15
  - "Step-by-Step Practical Quick-Start Guide"
16
16
  - "Self-Check Diagnostic Checklist"
17
17
  ---
18
-
19
18
  # HANDOUT: [LESSON TITLE]
20
19
  _Student Reference Notes — keep beside you during the lesson._
21
20
 
22
- ## [REQUIRED] 📖 Core Concepts
21
+ ## Core Concepts
23
22
  > Key terms and student-friendly definitions. Source term definitions from the
24
23
  > canonical knowledge context (KX Key Terms) — align, don't re-invent.
25
24
 
@@ -27,14 +26,14 @@ _Student Reference Notes — keep beside you during the lesson._
27
26
  |---|---|---|
28
27
  | [Term 1] | [Plain-language explanation] | [Micro example] |
29
28
 
30
- ## [REQUIRED] Core Syntax & Mechanism Cheat Sheet
29
+ ## Core Syntax & Mechanism Cheat Sheet
31
30
  > Quick-scan reference table for the exact syntax/mechanics this lesson uses.
32
31
 
33
32
  | Pattern | Syntax | When to Use | Common Trap |
34
33
  |---|---|---|---|
35
34
  | [Pattern] | `[exact syntax]` | [Situation] | [Pitfall from KX] |
36
35
 
37
- ## [REQUIRED] Visual Mental Model / Architecture Diagram
36
+ ## Visual Mental Model / Architecture Diagram
38
37
  > One Mermaid or ASCII diagram of the core mechanism, annotated.
39
38
 
40
39
  ```mermaid
@@ -45,7 +44,7 @@ graph LR
45
44
 
46
45
  - **How to read it:** [One-paragraph walkthrough of the diagram]
47
46
 
48
- ## [REQUIRED] Step-by-Step Practical Quick-Start Guide
47
+ ## Step-by-Step Practical Quick-Start Guide
49
48
  > Minimum path to a first working result, numbered, with checkpoints.
50
49
 
51
50
  1. [Step 1 — concrete action]
@@ -53,7 +52,7 @@ graph LR
53
52
  2. [Step 2]
54
53
  - ✅ Checkpoint: [What you should see]
55
54
 
56
- ## [REQUIRED] Self-Check Diagnostic Checklist
55
+ ## Self-Check Diagnostic Checklist
57
56
  > Can-do statements for self-assessment, mirroring LESSON LO evidence.
58
57
 
59
58
  - [ ] I can [can-do statement tied to LO1]
@@ -8,6 +8,14 @@ deliverable: "{{DELIVERABLE_CODE}}"
8
8
  version: "{{VERSION}}"
9
9
  date: "{{DATE}}"
10
10
  ---
11
+ template_required_sections:
12
+ - "Handover Information"
13
+ - "Deliverables Inventory"
14
+ - "Commitment vs. Reality Check"
15
+ - "Scope Exclusions"
16
+ - "Getting Started Guide"
17
+ - "Post-Handover Support Policy"
18
+ ---
11
19
 
12
20
  # CURRICULUM HANDOVER DOCUMENT
13
21
  _Handover Date: [YYYY-MM-DD] | Version: v[X.X]_
@@ -1,3 +1,13 @@
1
+ ---
2
+ template_required_sections:
3
+ - "Session Scope"
4
+ - "Key Terms"
5
+ - "Concept Narratives"
6
+ - "Worked Micro-Examples"
7
+ - "Common Mistakes"
8
+ - "Self-Check Questions"
9
+ ---
10
+
1
11
  # KNOWLEDGE_EXPOSITION: {{lesson_code}} — {{session_title}}
2
12
 
3
13
  ---
@@ -11,7 +21,7 @@ template_contract: "knowledge-exposition-v1"
11
21
  _Self-study reference for session {{lesson_code}}. Read this before the activities.
12
22
  Scope: exactly the knowledge planned for this session — no more, no less._
13
23
 
14
- ## [REQUIRED] Session Scope
24
+ ## Session Scope
15
25
 
16
26
  - **Objective:** {{prose_objective}}
17
27
  - **New keywords:** {{new_keywords}}
@@ -19,13 +29,13 @@ Scope: exactly the knowledge planned for this session — no more, no less._
19
29
  - **Depth targets:** {{depth_targets}}
20
30
  - **You can demonstrate, after this session:** {{exit_evidence}}
21
31
 
22
- ## [REQUIRED] Key Terms
32
+ ## Key Terms
23
33
 
24
34
  <!-- One block per term in glossary scope. Definitions MUST match GLOSSARY.json. -->
25
35
 
26
36
  {{key_terms}}
27
37
 
28
- ## [REQUIRED] Concept Narratives
38
+ ## Concept Narratives
29
39
 
30
40
  <!-- One subsection per concept node in session scope, sized to its depth assignment:
31
41
  - 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._
35
45
 
36
46
  {{concept_narratives}}
37
47
 
38
- ## [REQUIRED] Worked Micro-Examples
48
+ ## Worked Micro-Examples
39
49
 
40
50
  <!-- Minimal examples traceable to references from the domain graph. -->
41
51
 
42
52
  {{worked_examples}}
43
53
 
44
- ## [REQUIRED] Common Mistakes
54
+ ## Common Mistakes
45
55
 
46
56
  {{common_mistakes}}
47
57
 
48
- ## [REQUIRED] Self-Check Questions
58
+ ## Self-Check Questions
49
59
 
50
60
  <!-- 3-5 questions mapped to exit evidence. Answers at the very end. -->
51
61
 
@@ -0,0 +1,78 @@
1
+ ---
2
+ id: "{{ID}}"
3
+ title: "{{TITLE}}"
4
+ type: "LAB"
5
+ created_by: "Curriculum OS Builder"
6
+ phase: "{{PHASE}}"
7
+ deliverable: "P3-T2"
8
+ version: "{{VERSION}}"
9
+ date: "{{DATE}}"
10
+ ---
11
+ template_required_sections:
12
+ - "🎯 Overview"
13
+ - "🛠️ Environment & Setup"
14
+ - "📝 Lab Tasks (3-Tier Differentiation)"
15
+ - "🥉 Bronze (Foundational)"
16
+ - "🥈 Silver (Application)"
17
+ - "🥇 Gold (Enrichment/Creative)"
18
+ - "🔍 Troubleshooting & Debugging"
19
+ - "🏁 Submission & Check-off"
20
+ ---
21
+
22
+ <!-- INJECT_BODY -->
23
+
24
+ # 👨‍💻 CODE LAB: [LAB TITLE]
25
+ _Unit: U[X] | Module: M[X.X] | Lesson: Lesson [XX]_
26
+
27
+ ## 🎯 Overview
28
+ This lab focuses on the practical implementation of the technical concepts covered in the lesson. Students will transition from theory to code, focusing on building, debugging, and optimizing their logic.
29
+
30
+ ## 🛠️ Environment & Setup
31
+ - **Language/Framework:** [e.g., Python 3.12, Arduino C++, Node-RED]
32
+ - **IDE/Editor:** [e.g., Thonny, Arduino IDE, VS Code]
33
+ - **Required Libraries:** [List libraries and version if applicable]
34
+ - **Hardware Connection:** [Optional - Brief description of circuit setup if hardware-dependent]
35
+
36
+ ## 📝 Lab Tasks (3-Tier Differentiation)
37
+
38
+ ### 🥉 Bronze (Foundational)
39
+
40
+ > **Duration:** {{ XX }} mins
41
+ **Objective:** Establish basic functionality.
42
+ - **Task:** [e.g., Create a basic script to read data from the DHT11 sensor.]
43
+ - **Requirement:** Code MUST be syntactically correct and run without errors.
44
+
45
+ ### 🥈 Silver (Application)
46
+
47
+ > **Duration:** {{ XX }} mins
48
+ **Objective:** Add logic and data processing.
49
+ - **Task:** [e.g., Add a conditional statement to turn on an LED if the temperature exceeds 30°C.]
50
+ - **Requirement:** Demonstrate understanding of control flow and data comparison.
51
+
52
+ ### 🥇 Gold (Enrichment/Creative)
53
+
54
+ > **Duration:** {{ XX }} mins
55
+ **Objective:** Optimize, extend, or integrate.
56
+ - **Task:** [e.g., Log the temperature data to a local CSV file with timestamps.]
57
+ - **Requirement:** Show advanced resource management (file I/O, timing, or external API integration).
58
+
59
+ ## 💻 Technical Reference ([SME_MANDATE])
60
+ <!-- [SME_MANDATE] -->
61
+ > Any code provided in this section must be verified for syntax accuracy.
62
+
63
+ ```python
64
+ # [SAMPLE CODE WRAPPER]
65
+ # Paste the core logic here for student reference.
66
+ ```
67
+ <!-- [/SME_MANDATE] -->
68
+
69
+ ## 🔍 Troubleshooting & Debugging
70
+ | Issue | Potential Cause | Solution |
71
+ | :--- | :--- | :--- |
72
+ | [e.g., "ImportError"] | Library not installed | Run `pip install [library]` |
73
+ | [e.g., "Serial Timeout"] | Wrong COM port | Check Device Manager and update port in script |
74
+
75
+ ## 🏁 Submission & Check-off
76
+ - [ ] Code runs successfully on the target hardware/environment.
77
+ - [ ] Docstrings and comments are added in Vietnamese for clarity.
78
+ - [ ] Variables follow the naming convention defined in the Content Style Guide.
@@ -14,29 +14,28 @@ template_required_sections:
14
14
  - "Learning Context"
15
15
  - "Client Objectives"
16
16
  ---
17
-
18
17
  # LEARNER PROFILE
19
18
 
20
19
 
21
- ## [REQUIRED] Foundational Info
20
+ ## Foundational Info
22
21
  - **Age Group:** [Specific age range, e.g., 11–13 years old]
23
22
  - **Grade Level:** [E.g., Middle School / High School]
24
23
  - **Typical Class Size:** [Number of students]
25
24
  - **Learning Context:** [E.g., Public School / Coding Center / Workshop]
26
25
 
27
- ## [REQUIRED] Entry Level
26
+ ## Entry Level
28
27
  - **Coding Experience:** [None / Basic / Intermediate / Advanced]
29
28
  - **Hardware Experience:** [None / Basic / Intermediate / Advanced]
30
29
  - **Related Prior Courses:** [List specific courses or "None"]
31
30
 
32
- ## [REQUIRED] Learning Context
31
+ ## Learning Context
33
32
  - **Session Duration:** [Minutes]
34
33
  - **Total Sessions:** [Number]
35
34
  - **Frequency:** [E.g., 2 sessions/week]
36
35
  - **Student Equipment:** [E.g., Personal Laptop / Lab PC / Tablet]
37
36
  - **Internet Connectivity:** [Stable / Unstable / None]
38
37
 
39
- ## [REQUIRED] Client Objectives
38
+ ## Client Objectives
40
39
  - **Core Goal:** [What the client wants students to achieve - max 3 points]
41
40
  - **Standard Alignment:** [E.g., CSTA / K12 CS Framework / Local Standards]
42
41
 
@@ -8,6 +8,14 @@ deliverable: "{{DELIVERABLE_CODE}}"
8
8
  version: "{{VERSION}}"
9
9
  date: "{{DATE}}"
10
10
  ---
11
+ template_required_sections:
12
+ - "Project Metadata"
13
+ - "What Worked Well (Successes)"
14
+ - "What Didn't Work (Failures/Bottlenecks)"
15
+ - "Key Design Decisions (Architecture Log)"
16
+ - "Actionable Improvements for Future Projects"
17
+ - "Open Questions / Post-Deployment Monitoring"
18
+ ---
11
19
 
12
20
  # PROJECT LESSONS LEARNED
13
21
 
@@ -17,13 +17,18 @@ template_required_sections:
17
17
  - "Assessment Map"
18
18
  - "Artifact Contract"
19
19
  - "B. Lesson Flow"
20
- - "Artifact Linkage"
20
+ - "ENGAGE"
21
+ - "EXPLORE"
22
+ - "EXPLAIN"
23
+ - "ELABORATE"
24
+ - "EVALUATE"
25
+ - "Artifact Linkage (Master Index)"
21
26
  ---
22
27
  <!-- INJECT_BODY -->
23
28
 
24
29
  # LESSON [XX]: [LESSON TITLE] (5E Model)
25
30
 
26
- ## [REQUIRED] A. Lesson Design Plan
31
+ ## A. Lesson Design Plan
27
32
 
28
33
  > OWNERSHIP: Each fact lives in exactly ONE section. The Artifact Contract
29
34
  > column (row 11) of the Activity Sequence is the single owner of which
@@ -76,22 +81,30 @@ template_required_sections:
76
81
 
77
82
  ---
78
83
 
79
- ## [REQUIRED] B. Lesson Flow
84
+ ## B. Lesson Flow
80
85
 
81
- ### 1. ENGAGE — [X mins]
86
+ ### 1. ENGAGE
87
+
88
+ > **Duration:** {{ XX }} mins
82
89
  - **Hook Scenario:** [Provide a detailed real-world situation or story to grab attention. E.g., "Roleplay as a server room engineer at 3 AM."]
83
90
  - **Open Question:** [Explicitly state the question the teacher will ask the class.]
84
91
  - **Transition:** [How the teacher summarizes to move to the Explore phase.]
85
92
 
86
- ### 2. EXPLORE — [X mins]
93
+ ### 2. EXPLORE
94
+
95
+ > **Duration:** {{ XX }} mins
87
96
  - **Activity Reference:** [Summarize the planned activity from the Activity Sequence. Detailed operation belongs in ACT, but the design decision lives here.]
88
97
  - **Student Discovery:** [What students should notice before formal explanation.]
89
98
 
90
- ### 3. EXPLAIN — [X mins]
99
+ ### 3. EXPLAIN
100
+
101
+ > **Duration:** {{ XX }} mins
91
102
  - **Definitions:** [Explain the core concepts.]
92
103
  - **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.]
93
104
 
94
- ### 4. ELABORATE — [X mins]
105
+ ### 4. ELABORATE
106
+
107
+ > **Duration:** {{ XX }} mins
95
108
  - **Tiered Scaffolding:**
96
109
  - 🥉 **Bronze:** [Overview of the foundational task]
97
110
  - 🥈 **Silver:** [Overview of the application task]
@@ -99,7 +112,9 @@ template_required_sections:
99
112
 
100
113
  > **ACT Contract**: Detailed operational instructions must expand the Activity Sequence above and must not change the planned evidence target.
101
114
 
102
- ### 5. EVALUATE — [X mins]
115
+ ### 5. EVALUATE
116
+
117
+ > **Duration:** {{ XX }} mins
103
118
  - **Exit Ticket:** [Provide 1-2 specific questions to quickly check mastery of the success criteria.]
104
119
  - **Closing:** [Final remarks and wrap-up notes.]
105
120
 
@@ -113,7 +128,7 @@ template_required_sections:
113
128
 
114
129
  ---
115
130
 
116
- ## [REQUIRED] Artifact Linkage (Master Index)
131
+ ## Artifact Linkage (Master Index)
117
132
  > List all satellite files used in this lesson.
118
133
 
119
134
  | Artifact File | Role in the Classroom | When to Use |
@@ -17,12 +17,16 @@ template_required_sections:
17
17
  - "Assessment Map"
18
18
  - "Artifact Contract"
19
19
  - "B. Lesson Flow"
20
- - "Artifact Linkage"
20
+ - "ASK (Define the Problem)"
21
+ - "IMAGINE (Ideate)"
22
+ - "PLAN (Design)"
23
+ - "CREATE (Build & Code)"
24
+ - "TEST & IMPROVE (Iterate)"
25
+ - "SHARE & EVALUATE (Present)"
21
26
  ---
22
-
23
27
  # LESSON [XX]: [PROJECT TITLE] (EDP Model - Engineering Design Process)
24
28
 
25
- ## [REQUIRED] A. Lesson Design Plan
29
+ ## A. Lesson Design Plan
26
30
 
27
31
  > OWNERSHIP: Each fact lives in exactly ONE section. The Artifact Contract
28
32
  > column of the Activity Sequence is the single owner of which satellite
@@ -73,26 +77,38 @@ template_required_sections:
73
77
 
74
78
  ---
75
79
 
76
- ## [REQUIRED] B. Lesson Flow
80
+ ## B. Lesson Flow
81
+
82
+ ### 1. ASK (Define the Problem)
77
83
 
78
- ### 1. ASK (Define the Problem) — [X mins]
84
+ > **Duration:** {{ XX }} mins
79
85
  [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).]
80
86
 
81
- ### 2. IMAGINE (Ideate) — [X mins]
87
+ ### 2. IMAGINE (Ideate)
88
+
89
+ > **Duration:** {{ XX }} mins
82
90
  [Students brainstorm possible solutions. Teacher suggests different approaches.]
83
91
 
84
- ### 3. PLAN (Design) — [X mins]
92
+ ### 3. PLAN (Design)
93
+
94
+ > **Duration:** {{ XX }} mins
85
95
  [Students draw circuit diagrams, create flowcharts, or write pseudocode before physical assembly.]
86
96
 
87
- ### 4. CREATE (Build & Code) — [X mins]
97
+ ### 4. CREATE (Build & Code)
98
+
99
+ > **Duration:** {{ XX }} mins
88
100
  [Students start hardware assembly and typing code based on their design.]
89
101
 
90
102
  > **ACT Contract**: Detailed operational instructions must expand the Activity Sequence above and must not change the planned evidence target.
91
103
 
92
- ### 5. TEST & IMPROVE (Iterate) — [X mins]
104
+ ### 5. TEST & IMPROVE (Iterate)
105
+
106
+ > **Duration:** {{ XX }} mins
93
107
  [Students test their product, record bugs, and proceed with debugging/iteration.]
94
108
 
95
- ### 6. SHARE & EVALUATE (Present) — [X mins]
109
+ ### 6. SHARE & EVALUATE (Present)
110
+
111
+ > **Duration:** {{ XX }} mins
96
112
  [Students demo their product, explain how it works, and highlight improvements made.]
97
113
 
98
114
  > **QUIZ Contract**: Detailed project rubrics must assess the evidence and success criteria defined in the Lesson Design Plan.
@@ -17,13 +17,17 @@ template_required_sections:
17
17
  - "Assessment Map"
18
18
  - "Artifact Contract"
19
19
  - "B. Lesson Flow"
20
- - "Artifact Linkage"
20
+ - "Warm-up / Hook"
21
+ - "Core Concepts"
22
+ - "Guided Practice"
23
+ - "Independent Practice"
24
+ - "Wrap-up & Checkpoint"
21
25
  ---
22
26
  <!-- INJECT_BODY -->
23
27
 
24
28
  # LESSON [XX]: [LESSON TITLE]
25
29
 
26
- ## [REQUIRED] A. Lesson Design Plan
30
+ ## A. Lesson Design Plan
27
31
 
28
32
  > OWNERSHIP: Each fact lives in exactly ONE section. The Artifact Contract
29
33
  > column of the Activity Sequence is the single owner of which satellite
@@ -73,14 +77,18 @@ template_required_sections:
73
77
 
74
78
  ---
75
79
 
76
- ## [REQUIRED] B. Lesson Flow
80
+ ## B. Lesson Flow
77
81
 
78
- ### 1. Warm-up / Hook — [X mins]
82
+ ### 1. Warm-up / Hook
83
+
84
+ > **Duration:** {{ XX }} mins
79
85
  [Inquiry-based question, short game, or story to grab attention, connecting to prior knowledge or real-world applications.]
80
86
 
81
87
  ---
82
88
 
83
- ### 2. Core Concepts — [X mins]
89
+ ### 2. Core Concepts
90
+
91
+ > **Duration:** {{ XX }} mins
84
92
 
85
93
  ### Concept 1: [Concept Name]
86
94
  [Explain theory in age-appropriate language. Use real-world analogies. Max 3 paragraphs.]
@@ -92,19 +100,25 @@ template_required_sections:
92
100
 
93
101
  ---
94
102
 
95
- ### 3. Guided Practice — [X mins]
103
+ ### 3. Guided Practice
104
+
105
+ > **Duration:** {{ XX }} mins
96
106
  [Teacher demos or guides students step-by-step according to the Activity Sequence. Include code snippets, Mermaid diagrams, or basic wiring schematics.]
97
107
 
98
108
  ---
99
109
 
100
- ### 4. Independent Practice — [X mins]
110
+ ### 4. Independent Practice
111
+
112
+ > **Duration:** {{ XX }} mins
101
113
  [Students solve a problem or challenge based on the planned evidence target.]
102
114
 
103
115
  > **ACT Contract**: Detailed operational instructions must expand the Activity Sequence above and must not change the planned evidence target.
104
116
 
105
117
  ---
106
118
 
107
- ### 5. Wrap-up & Checkpoint — [X mins]
119
+ ### 5. Wrap-up & Checkpoint
120
+
121
+ > **Duration:** {{ XX }} mins
108
122
  [Summarize the 2-3 most important points. Provide 2-3 quick check questions to ensure understanding before class ends.]
109
123
 
110
124
  > **QUIZ Contract**: Detailed assessment criteria and rubrics must assess the evidence and success criteria defined in the Lesson Design Plan.
@@ -8,6 +8,13 @@ deliverable: "{{DELIVERABLE_CODE}}"
8
8
  version: "{{VERSION}}"
9
9
  date: "{{DATE}}"
10
10
  ---
11
+ template_required_sections:
12
+ - "Structural Constraints"
13
+ - "Quantitative Constraints"
14
+ - "Pedagogical Constraints"
15
+ - "Code & Technical Constraints"
16
+ - "Language Constraints"
17
+ ---
11
18
 
12
19
  # CONTENT GENERATION CONSTRAINTS
13
20
 
@@ -8,6 +8,14 @@ deliverable: "P3-SPEC"
8
8
  version: "v2.0"
9
9
  date: "YYYY-MM-DD"
10
10
  ---
11
+ template_required_sections:
12
+ - "Package Structure & Rules"
13
+ - "Transformation Rules (⚡)"
14
+ - "A. For Students (Student Version)"
15
+ - "B. For Parents (Parent Version)"
16
+ - "C. For Managers / Clients (Client Version)"
17
+ - "Data Sanitization Protocol"
18
+ ---
11
19
 
12
20
  # PACKAGING & TRANSFORMATION SPECIFICATION
13
21