@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
@@ -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
 
@@ -8,6 +8,12 @@ deliverable: "{{DELIVERABLE_CODE}}"
8
8
  version: "{{VERSION}}"
9
9
  date: "{{DATE}}"
10
10
  ---
11
+ template_required_sections:
12
+ - "Session Information"
13
+ - "Structured Feedback by Lesson Phase"
14
+ - "General Observations"
15
+ - "Overall Classification & Action (For System / Human PM)"
16
+ ---
11
17
 
12
18
  # PILOT TEACHING FEEDBACK
13
19
  _Date Recorded: [YYYY-MM-DD]_
@@ -8,6 +8,14 @@ deliverable: "P1-T9"
8
8
  version: "{{VERSION}}"
9
9
  date: "{{DATE}}"
10
10
  ---
11
+ template_required_sections:
12
+ - "Project Overview"
13
+ - "Audience & Duration"
14
+ - "Learning Roadmap"
15
+ - "Learning Outcomes & Deliverables"
16
+ - "Technical Constraints"
17
+ - "Artifact Scope"
18
+ ---
11
19
 
12
20
  # PROJECT BRIEF: [PROJECT NAME]
13
21
 
@@ -8,6 +8,15 @@ deliverable: "P1-GATE"
8
8
  version: "v4.6"
9
9
  date: "YYYY-MM-DD"
10
10
  ---
11
+ template_required_sections:
12
+ - "Project Summary"
13
+ - "Macro Pipeline (Course Lifecycle)"
14
+ - "High-Level Roadmap"
15
+ - "Detailed Progress Tracking"
16
+ - "Critical Links"
17
+ - "Changelog (Latest Only)"
18
+ - "🎯 Current Milestone: Phase 1 - R&D"
19
+ ---
11
20
 
12
21
  # PROJECT STATUS: [PROJECT_NAME]
13
22
 
@@ -8,6 +8,13 @@ deliverable: "P2-T08"
8
8
  version: "{{VERSION}}"
9
9
  date: "{{DATE}}"
10
10
  ---
11
+ template_required_sections:
12
+ - "Metadata Specs"
13
+ - "Schema Structure"
14
+ - "Pedagogical Rules"
15
+ - "Visual Layout (Marp/Interactive)"
16
+ ---
17
+
11
18
  <!--
12
19
  Created by: Curriculum OS Builder
13
20
  Phase: P2 | Deliverable: P2-T08 (Assessment Infrastructure)
@@ -14,10 +14,9 @@ template_required_sections:
14
14
  - "Code Analysis / Debugging Question"
15
15
  - "Competency Rubric"
16
16
  ---
17
-
18
17
  # QUIZ: [LESSON TITLE]
19
18
 
20
- ## [REQUIRED] Assessment Objectives
19
+ ## Assessment Objectives
21
20
  > One row per Learning Objective from the LESSON A1 table. Bloom level of each
22
21
  > objective MUST match the LESSON A1 Bloom verb — do not re-target.
23
22
 
@@ -25,7 +24,7 @@ template_required_sections:
25
24
  |---|---|---|---|
26
25
  | LO1 | [What this quiz verifies for LO1] | [Same Bloom verb as LESSON A1] | [Observable student output] |
27
26
 
28
- ## [REQUIRED] Multiple-Choice Question Bank
27
+ ## Multiple-Choice Question Bank
29
28
  > ≥5 scenario-based questions, 4 options each. Every distractor must be a real,
30
29
  > common misconception from this lesson's domain (see Common Mistakes source in
31
30
  > the canonical knowledge context) — never random filler.
@@ -42,7 +41,7 @@ template_required_sections:
42
41
 
43
42
  <!-- Repeat per question. -->
44
43
 
45
- ## [REQUIRED] Code Analysis / Debugging Question
44
+ ## Code Analysis / Debugging Question
46
45
  > One deep code-tracing task: students predict output or identify the bug.
47
46
  > Provide a complete, runnable snippet with line numbers.
48
47
 
@@ -54,7 +53,7 @@ template_required_sections:
54
53
  - **Expected answer:** [Output or bug + fix]
55
54
  - **Bloom:** [Level] — **LO:** [LO code]
56
55
 
57
- ## [REQUIRED] Competency Rubric
56
+ ## Competency Rubric
58
57
  > 4-tier matrix tied to the Evidence column above.
59
58
 
60
59
  | Tier | Descriptor | Evidence Threshold |
@@ -8,6 +8,10 @@ deliverable: "{{DELIVERABLE_CODE}}"
8
8
  version: "{{VERSION}}"
9
9
  date: "{{DATE}}"
10
10
  ---
11
+ template_required_sections:
12
+ - "📊 Coverage Summary"
13
+ - "📚 Detailed Technical References"
14
+ ---
11
15
 
12
16
  # REFERENCE PACK: Pedagogical Source Grounds
13
17
 
@@ -10,9 +10,12 @@ date: "{{DATE}}"
10
10
  template_contract: "artifact-template-v1"
11
11
  template_required_sections:
12
12
  - "Game Rules & Setup Guide"
13
- - "Round 1: Speed Round (100-200 Pts)"
14
- - "Round 2: Code Duel & Debugging (300-400 Pts)"
15
- - "Round 3: Final Boss Architecture Challenge (500 Pts)"
13
+ - "Round 1: Rapid-Fire Speed Round (100200 Points)"
14
+ - "Question 1 (100 Pts):"
15
+ - "Question 2 (200 Pts):"
16
+ - "Round 2: Code Duel & Debugging (300–400 Points)"
17
+ - "Challenge 1 (300 Pts):"
18
+ - "Round 3: Final Boss Architecture Challenge (500 Points)"
16
19
  - "Kahoot / Quizizz CSV Export Format"
17
20
  ---
18
21
  <!-- INJECT_BODY -->
@@ -20,14 +23,14 @@ template_required_sections:
20
23
  # INTERACTIVE REVIEW GAME (QUIZ SHOW PACK): [UNIT / LESSON TITLE]
21
24
  _Unit: U[X] | Module: M[X.X] | Format: Live Classroom Quiz Show / Kahoot / Jeopardy Format_
22
25
 
23
- ## [REQUIRED] Game Rules & Setup Guide
26
+ ## Game Rules & Setup Guide
24
27
  - **Format:** 3 Rounds of progressive difficulty with team buzzers or interactive clickers.
25
28
  - **Team Size:** 3-5 students per squad.
26
29
  - **Bonus Mechanic:** Teams can wager points on Round 3 (Final Boss Challenge).
27
30
 
28
31
  ---
29
32
 
30
- ## [REQUIRED] Round 1: Rapid-Fire Speed Round (100–200 Points)
33
+ ## Round 1: Rapid-Fire Speed Round (100–200 Points)
31
34
 
32
35
  ### Question 1 (100 Pts):
33
36
  - **Category:** Vocabulary & Syntax
@@ -45,7 +48,7 @@ _Unit: U[X] | Module: M[X.X] | Format: Live Classroom Quiz Show / Kahoot / Jeopa
45
48
 
46
49
  ---
47
50
 
48
- ## [REQUIRED] Round 2: Code Duel & Debugging (300–400 Points)
51
+ ## Round 2: Code Duel & Debugging (300–400 Points)
49
52
 
50
53
  ### Challenge 1 (300 Pts):
51
54
  - **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 {
61
64
 
62
65
  ---
63
66
 
64
- ## [REQUIRED] Round 3: Final Boss Architecture Challenge (500 Points)
67
+ ## Round 3: Final Boss Architecture Challenge (500 Points)
65
68
  - **Scenario:** "Design a real-time multiplayer scorekeeper using Swift 6 Actors. You have 3 minutes to draft the Actor interface on your team whiteboard."
66
69
  - **Rubric:**
67
70
  - `+200 pts:` Declared `actor ScoreKeeper`.
@@ -70,7 +73,7 @@ func updateStore(store: DataStore) async {
70
73
 
71
74
  ---
72
75
 
73
- ## [REQUIRED] Kahoot / Quizizz CSV Export Format
76
+ ## Kahoot / Quizizz CSV Export Format
74
77
  ```csv
75
78
  Question,Option 1,Option 2,Option 3,Option 4,Correct Answer,Time Limit (sec)
76
79
  "What keyword creates an asynchronous suspension point?","defer","await","return","yield",2,20
@@ -12,12 +12,11 @@ template_required_sections:
12
12
  - "Assessment Overview"
13
13
  - "Assessment Rubric"
14
14
  ---
15
-
16
15
  # ASSESSMENT: [LESSON/PROJECT TITLE]
17
16
 
18
17
  _Unit: U[X] | Module: M[X.X] | Lesson: Lesson [XX]_
19
18
 
20
- ## [REQUIRED] Assessment Overview
19
+ ## Assessment Overview
21
20
  - **Type:** [Select: Formative / Summative / Self-assessment / Peer-review]
22
21
  - **Format:** [Select: Short Exercise / Exit Ticket / Practical Product / Project Presentation]
23
22
  - **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]_
25
24
 
26
25
  ---
27
26
 
28
- ## [REQUIRED] Assessment Rubric
27
+ ## Assessment Rubric
29
28
  _Note for @assessor: Describe SPECIFIC behaviors. Avoid vague words like "good" or "understand."_
30
29
 
31
30
  | Criteria | Weight | Excellent (4) | Proficient (3) | Developing (2) | Beginning (1) |