@thanh01.pmt/curriculum-kit 1.4.41 → 1.4.43

package/docs/refs/templates/SLIDE_template.md

@@ -0,0 +1,389 @@
+---
+marp: true
+theme: default
+paginate: true
+header: "{{HEADER_TITLE}}"
+footer: "LearnWell Platform | {{LESSON_ID}}"
+---
+
+<!-- Slide 1: Title & Inquiry Mission Hook -->
+# 🚀 {{TITLE}}
+
+### {{SUBTITLE}}
+
+- **Target Level:** {{AUDIENCE}}
+- **Toolchain / Stack:** {{TECH_STACK}}
+- **Pacing:** {{DURATION_MINS}} mins
+
+<!--
+Presenter Notes:
+- HOOK & PURPOSE: Introduce the lesson with high energy. Connect today's mission directly to a real industry practice.
+- TIMING: Spend ~2 minutes max on this slide.
+- COLD CALL: Ask 1 student: "Who has encountered [core problem] before?"
+-->
+
+---
+
+<!-- Slide 2: Agenda & Journey Map -->
+## 🗺️ Agenda & Milestone Journey Map
+
+| Time | Stage | Focus Activity |
+| :--: | ----- | -------------- |
+{{AGENDA_ROWS}}
+
+<!--
+Presenter Notes:
+- ROADMAP: Set clear expectations for each sprint.
+- HIGHLIGHT: Emphasize that theory is kept minimal (~3-5 mins per burst) with immediate hands-on labs.
+-->
+
+---
+
+<!-- Slide 3: Warm-Up & Prior Knowledge Recall -->
+## ⚡ Warm-Up: Diagnostic Quick-Fire
+
+<div class="columns">
+<div>
+
+### 🧠 Prior Knowledge Recall
+- **Concept A:** {{RECALL_CONCEPT_A}}
+- **Concept B:** {{RECALL_CONCEPT_B}}
+- **Bridging Question:** {{RECALL_BRIDGE_QUESTION}}
+
+</div>
+<div>
+
+<div class="card highlight">
+
+**⚡ 60-Second Challenge:**
+{{WARMUP_CHALLENGE_PROMPT}}
+
+</div>
+
+</div>
+</div>
+
+<!--
+Presenter Notes:
+- DIAGNOSTIC: Check if prerequisites are solid.
+- SCAFFOLDING: If students struggle with Concept A, quickly remind them of [key intuition].
+-->
+
+---
+
+<!-- Slide 4: Real-World Hook Scenario -->
+## 🎯 Hook Scenario: The Engineering Dilemma
+
+<div class="card warning">
+
+### ⚠️ System Failure in Production:
+{{HOOK_SCENARIO}}
+
+</div>
+
+<div class="columns">
+<div>
+
+- **Core Dilemma:** {{HOOK_CONSTRAINT}}
+- **Why Naive Approach Fails:** {{HOOK_FAILURE_REASON}}
+
+</div>
+<div>
+
+- **Engineering Mission:** {{HOOK_QUESTION}}
+- **Success Target:** {{HOOK_METRIC}}
+
+</div>
+</div>
+
+<!--
+Presenter Notes:
+- STAKES: Paint the authentic consequence of this failure (e.g. app crash, data loss, performance degradation).
+- DO NOT reveal the solution yet! Keep curiosity high.
+-->
+
+---
+
+<!-- [CONCEPT_MICRO_CYCLES_START] -->
+
+<!-- Slide 5: Core Concept 1 - Mental Model & Analogy -->
+## 🧠 Concept 1: {{CONCEPT_1_NAME}}
+
+<div class="columns">
+<div>
+
+### 💡 The Core Mental Model
+- **Definition:** {{CONCEPT_1_DEFINITION}}
+- **Intuitive Analogy:** {{CONCEPT_1_ANALOGY}}
+- **Why It Matters:** {{CONCEPT_1_BENEFIT}}
+
+</div>
+<div>
+
+<div class="card">
+
+**⚡ Golden Rule:**
+{{CONCEPT_1_GOLDEN_RULE}}
+
+</div>
+
+</div>
+</div>
+
+<!--
+Presenter Notes:
+- TALK TRACK: Explain the analogy clearly using the everyday mental model.
+- MISCONCEPTION ALERT: Students often confuse [A] with [B]. Clarify the boundary now.
+-->
+
+---
+
+<!-- Slide 6: Architecture & Data Flow Visual -->
+## 🔄 Architecture: {{CONCEPT_1_NAME}} Visualized
+
+```mermaid
+{{CONCEPT_1_MERMAID_DIAGRAM}}
+```
+
+- **Step 1 (Input):** {{FLOW_STEP_1}}
+- **Step 2 (Transform):** {{FLOW_STEP_2}}
+- **Step 3 (Output):** {{FLOW_STEP_3}}
+
+<!--
+Presenter Notes:
+- DIAGRAM WALKTHROUGH: Trace the flow arrows step-by-step.
+- COLD CALL CHECK: "What happens between Step 2 and Step 3 if the condition fails?"
+-->
+
+---
+
+<!-- Slide 7: Syntax Anatomy & Code Demo (I Do) -->
+## ⚙️ Code Anatomy: {{CONCEPT_1_NAME}}
+
+<div class="columns">
+<div>
+
+### 📝 Implementation Blueprint
+```{{TECH_LANGUAGE}}
+{{CONCEPT_1_CODE_SNIPPET}}
+```
+
+</div>
+<div>
+
+### 🔍 Anatomy & Mechanics
+- **Line 1-2:** {{CODE_EXPLANATION_L1}}
+- **Line 3-4:** {{CODE_EXPLANATION_L2}}
+- **Line 5+:** {{CODE_EXPLANATION_L3}}
+
+<div class="card highlight">
+
+**⚠️ Syntax Trap:** {{SYNTAX_TRAP_NOTE}}
+
+</div>
+
+</div>
+</div>
+
+<!--
+Presenter Notes:
+- LIVE DEMO: Point directly to the highlighted lines on screen.
+- EMPHASIZE: Explain why this syntax was chosen over the legacy way.
+-->
+
+---
+
+<!-- Slide 8: Quick Micro-Practice (We Do / You Do) -->
+## 🚀 Quick Micro-Practice: Try It Now (3 Mins)
+
+<div class="card highlight">
+
+**🎯 Your Task:** {{MICRO_PRACTICE_TASK}}
+
+</div>
+
+<div class="columns">
+<div>
+
+### 🥉 Starter Hint:
+```{{TECH_LANGUAGE}}
+{{STARTER_CODE_HINT}}
+```
+
+</div>
+<div>
+
+### ⏱️ Pacing & Success Check:
+- **Time limit:** 3 minutes at your workstation.
+- **Expected result:** {{EXPECTED_MICRO_OUTPUT}}
+- 🟢 Thumbs up when console prints expected output!
+
+</div>
+</div>
+
+<!--
+Presenter Notes:
+- PACING: Start a 3-minute timer on your watch/phone.
+- CIRCULATE: Walk the room immediately to catch students with setup or typo issues early.
+-->
+
+<!-- [CONCEPT_MICRO_CYCLES_END] -->
+
+---
+
+<!-- Slide 9: Integrated Hands-On Lab: Capstone Challenge -->
+## 🛠️ Integrated Hands-On Lab: Capstone Mission
+
+### 🎯 Mission Objective:
+{{ADVANCED_LAB_GOAL}}
+
+<div class="columns">
+<div>
+
+<div class="card">
+
+#### 🥉 Bronze Tier (Foundational)
+- {{BRONZE_TASK_1}}
+- {{BRONZE_TASK_2}}
+
+</div>
+
+<div class="card highlight">
+
+#### 🥈 Silver Tier (Standard)
+- {{SILVER_TASK_1}}
+- {{SILVER_TASK_2}}
+
+</div>
+
+</div>
+<div>
+
+<div class="card success">
+
+#### 🥇 Gold Tier (Mastery Extension)
+- {{GOLD_TASK_1}}
+- {{GOLD_TASK_2}}
+
+</div>
+
+<div class="card warning">
+
+**🚨 Gotcha Alert:**
+{{LAB_GOTCHA_WARNING}}
+
+</div>
+
+</div>
+</div>
+
+<!--
+Presenter Notes:
+- DIFFERENTIATION: Guide students to start at Bronze. Once Bronze tests pass, immediately challenge Silver.
+- FACILITATION: Pair students up if anyone is stuck on environment issues.
+-->
+
+---
+
+<!-- Slide 10: Formative Checkpoint: Traffic Light Assessment -->
+## 🚦 Formative Checkpoint: Status Calibration
+
+<div class="columns">
+<div>
+
+<div class="card success">
+
+### 🟢 Green Light (Ready to Accelerate)
+- Solved Bronze + Silver successfully.
+- Ready to tackle Gold tier or help peers!
+
+</div>
+
+<div class="card warning">
+
+### 🟡 Yellow Light (Need Quick Assist)
+- Stuck on syntax or compilation error.
+- Check troubleshooting table on board.
+
+</div>
+
+</div>
+<div>
+
+<div class="card" style="border-left: 4px solid #ef4444;">
+
+### 🔴 Red Light (Blocked)
+- Core concept unclear.
+- Step back to Slide 6 architecture diagram.
+
+</div>
+
+<div class="card highlight">
+
+**💡 Quick Self-Test Question:**
+{{CHECKPOINT_DIAGNOSTIC_QUESTION}}
+
+</div>
+
+</div>
+</div>
+
+<!--
+Presenter Notes:
+- FORMATION: Ask for hand signals (1 finger = Red, 2 = Yellow, 3 = Green).
+- INTERVENTION: If >30% show Red/Yellow, spend 2 minutes addressing the single biggest sticking point on the whiteboard.
+-->
+
+---
+
+<!-- Slide 11: Exit Ticket & Metacognitive Reflection -->
+## 🎟️ Exit Ticket & Metacognition (5 Mins)
+
+1. **Scenario 1 (Application):**  
+   {{EXIT_Q1}}
+
+2. **Scenario 2 (Diagnostic Trap):**  
+   {{EXIT_Q2}}
+
+3. **Metacognitive Self-Check:**  
+   > *{{EXIT_REFLECTION}}*
+
+<!--
+Presenter Notes:
+- ACCOUNTABILITY: Every student must submit their exit answers before leaving.
+- REVIEW: Review submissions to calibrate pacing and review points for the next lesson.
+-->
+
+---
+
+<!-- Slide 12: Summary & Key Takeaways -->
+## 🏁 Summary & Key Takeaways
+
+<div class="columns">
+<div>
+
+### 🏆 Core Rules to Remember:
+- ✅ **Rule 1:** {{TAKEAWAY_1}}
+- ✅ **Rule 2:** {{TAKEAWAY_2}}
+- ✅ **Rule 3:** {{TAKEAWAY_3}}
+
+</div>
+<div>
+
+<div class="card highlight">
+
+### 🔮 Next Milestone Preview:
+{{NEXT_MILESTONE_PREVIEW}}
+
+*Coming up next: {{NEXT_TOPIC_TEASER}}*
+
+</div>
+
+</div>
+</div>
+
+<!--
+Presenter Notes:
+- WRAP-UP: Commend students for their progress and hard work today.
+- CONNECTION: Show how today's foundation directly powers the next exciting milestone.
+-->

package/docs/refs/templates/STATION_ROTATION_template.md

@@ -0,0 +1,80 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "STATION_ROTATION"
+created_by: "Curriculum OS Builder"
+phase: "{{PHASE}}"
+deliverable: "P3-T15"
+version: "{{VERSION}}"
+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"
+---
+<!-- 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
+- **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.
+
+```
+┌──────────────────────────────────────┬──────────────────────────────────────┐
+│ 👨‍🏫 STATION 1: Teacher-Led (Guided)  │ 👥 STATION 2: Pair Lab (Hands-on)    │
+│ Target: High-order debugging & SOT   │ Target: Collaborative peer challenge │
+├──────────────────────────────────────┼──────────────────────────────────────┤
+│ 💻 STATION 3: Digital Lab (Async)    │ 🖊️ STATION 4: Offline / Architecture │
+│ Target: Independent test-driven code │ Target: Diagramming, cards & models  │
+└──────────────────────────────────────┴──────────────────────────────────────┘
+```
+
+---
+
+## [REQUIRED] 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?"*
+  - *"Why is value semantics safer than reference semantics when passing across concurrency domains?"*
+- **Differentiation Trigger:** If students struggle, demonstrate with physical LEGO / token passing.
+
+---
+
+## [REQUIRED] 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.
+- **Success Milestone:** Pass tests `testStation2Stage1()` and `testStation2Stage2()`.
+
+---
+
+## [REQUIRED] 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.
+  2. Complete 5 self-graded micro-challenges (Instant Feedback).
+  3. Record completion code into the Station Recording Sheet.
+
+---
+
+## [REQUIRED] 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 | Task Completed | Signature / Verification Stamp | 1 Key Insight Learned |
+| :---: | :--- | :--- | :--- |
+| **1 (Teacher)** | Debugging Probe Discussion | [Teacher Stamp] | |
+| **2 (Pair Lab)** | Stage 1 & 2 Test Suite | [Peer Signature] | |
+| **3 (Digital)** | 5 Micro-Challenges Code: `___` | [Auto-Generated Token] | |
+| **4 (Offline)** | Flowchart Diagram Approved | [Mentor Initials] | |

package/docs/refs/templates/TASK_CARDS_template.md

@@ -0,0 +1,111 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "TASK_CARDS"
+created_by: "Curriculum OS Builder"
+phase: "{{PHASE}}"
+deliverable: "P3-T14"
+version: "{{VERSION}}"
+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)"
+  - "Teacher Answer Key & Scoring Matrix"
+---
+<!-- INJECT_BODY -->
+
+# 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
+- **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)
+
+```
+┌──────────────────────────────────────────────┬──────────────────────────────────────────────┐
+│ 🃏 CARD 01: Mental Model Anchor     [Bronze] │ 🃏 CARD 02: Code Tracing             [Bronze]│
+│                                              │                                              │
+│ [Question / Prompt Testing Core Principle]   │ Given:                                       │
+│ E.g., "Define the difference between @State  │ let numbers = [1, 2, 3]                      │
+│ and @Binding in 1 concise sentence."         │ What is the exact value after:               │
+│                                              │ numbers.map { $0 * 2 }.filter { $0 > 3 }     │
+│ 💡 Hint: Check Handout Section 1             │ 💡 Hint: Trace element by element            │
+├──────────────────────────────────────────────┼──────────────────────────────────────────────┤
+│ 🃏 CARD 03: Syntax Spot Check       [Bronze] │ 🃏 CARD 04: Vocabulary Link          [Bronze]│
+│                                              │                                              │
+│ "Which keyword allows an asynchronous        │ "Match the term 'Data Race' to the correct   │
+│ function to suspend execution without        │ definition (A, B, or C)."                    │
+│ blocking the underlying thread?"             │                                              │
+│ [A] break  [B] await  [C] defer  [D] sync    │                                              │
+└──────────────────────────────────────────────┴──────────────────────────────────────────────┘
+```
+
+---
+
+## [REQUIRED] Set B: Code Diagnosis & Debugging (Cards 5–8)
+
+```
+┌──────────────────────────────────────────────┬──────────────────────────────────────────────┐
+│ 🃏 CARD 05: Spot The Compiler Bug   [Silver] │ 🃏 CARD 06: Fix The Concurrency Leak [Silver]│
+│                                              │                                              │
+│ struct ProfileView: View {                   │ actor BankAccount {                          │
+│     var username: String = "Alex"            │     var balance = 100                        │
+│     var body: some View {                    │ }                                            │
+│         TextField("Name", text: username)    │ // Non-isolated caller                       │
+│     }                                        │ func printBalance(acc: BankAccount) {        │
+│ }                                            │     print(acc.balance) // Error here         │
+│ Task: What character is missing on line 4?   │ Task: Fix the error on line 6.               │
+├──────────────────────────────────────────────┼──────────────────────────────────────────────┤
+│ 🃏 CARD 07: Logic Flaw Detector     [Silver] │ 🃏 CARD 08: State Mutation Trap      [Silver]│
+│                                              │                                              │
+│ [Provide a snippet where condition is always │ [Provide a snippet mutating immutable view   │
+│ false due to type mismatch or scope issue]   │ properties or escaping closures]             │
+│ Task: Rewrite lines 3-4 to correct logic.    │ Task: Explain why mutation is rejected.      │
+└──────────────────────────────────────────────┴──────────────────────────────────────────────┘
+```
+
+---
+
+## [REQUIRED] Set C: Application & Synthesis (Cards 9–12)
+
+```
+┌──────────────────────────────────────────────┬──────────────────────────────────────────────┐
+│ 🃏 CARD 09: System Architecture       [Gold] │ 🃏 CARD 10: Performance Optimization  [Gold]│
+│                                              │                                              │
+│ "Design an Actor model for a Chat app with   │ "A list with 10,000 items lags when          │
+│ 100 simultaneous message streams. Name the   │ scrolling. Propose 2 specific optimizations  │
+│ 2 core methods and data invariants."         │ to achieve 60 FPS."                          │
+├──────────────────────────────────────────────┼──────────────────────────────────────────────┤
+│ 🃏 CARD 11: Real-World Scenario       [Gold] │ 🃏 CARD 12: Challenge & Refactor      [Gold]│
+│                                              │                                              │
+│ "A user loses internet during payment. How   │ [Provide a 10-line messy imperative code]    │
+│ does your async pipeline guarantee idempotent│ Task: Refactor into a clean declarative      │
+│ transaction recording without duplicate buy?"│ pipeline using modern idioms.                │
+└──────────────────────────────────────────────┴──────────────────────────────────────────────┘
+```
+
+---
+
+## [REQUIRED] 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 |
+| **02** | `[4, 6]` | 1 pt |
+| **03** | `[B] await` | 1 pt |
+| **04** | Definition B (Two threads accessing same memory with at least one write). | 1 pt |
+| **05** | Missing `$` projection: `$username` | 2 pts |
+| **06** | Must add `await` and mark function `async`: `await acc.balance` | 2 pts |
+| **07** | [Exact refactored lines] | 2 pts |
+| **08** | [Exact explanation of View struct value semantics] | 2 pts |
+| **09** | [Actor blueprint with isolated message queue] | 3 pts |
+| **10** | 1. Use LazyVStack / List view recycling; 2. Pre-fetch images asynchronously. | 3 pts |
+| **11** | [Idempotency token + local cache before network dispatch] | 3 pts |
+| **12** | [Clean idiomatic refactored code] | 3 pts |

package/docs/refs/templates/TIERED_PRACTICE_template.md

@@ -0,0 +1,114 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "TIERED_PRACTICE"
+created_by: "Curriculum OS Builder"
+phase: "{{PHASE}}"
+deliverable: "P3-T11"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Computational Objective & Tier Matrix"
+  - "Bronze Tier (Foundational Scaffolding)"
+  - "Silver Tier (Independent Application)"
+  - "Gold Tier (Enrichment & Optimization)"
+  - "Automated Test Verification Matrix"
+  - "Answer Key & Mentor Hints"
+---
+<!-- INJECT_BODY -->
+
+# 3-TIER DIFFERENTIATED PRACTICE LAB: [LESSON TITLE]
+_Unit: U[X] | Module: M[X.X] | Lesson: Lesson [XX] | Mode: Adaptive Lab_
+
+## [REQUIRED] Computational Objective & Tier Matrix
+> *Principle: All students MUST achieve Bronze; Silver is target mastery; Gold is for gifted/accelerated learners.*
+
+| Tier Level | Cognitive Target (Bloom) | Scaffolding Ratio | Success Criteria |
+| :--- | :--- | :--- | :--- |
+| 🥉 **Bronze** | Remember / Understand | **70% Starter Code / 30% Fill-in** | Complete basic syntax & pass Baseline Unit Test. |
+| 🥈 **Silver** | Apply / Analyze | **30% Starter Code / 70% Implementation** | Implement business logic, edge-case handling & multi-component binding. |
+| 🥇 **Gold** | Evaluate / Create | **0% Code / Open Architecture** | Optimize performance, refactor with concurrency/state isolation & self-author tests. |
+
+---
+
+## [REQUIRED] 🥉 Bronze Tier: Foundational Scaffolding (Baseline for All)
+- **Target Audience:** All learners (mandatory milestone).
+- **Guiding Prompt:** [Clear, unambiguous instruction with concrete references to Handout].
+
+### Starter Code & Fill-in Slots:
+```swift
+// Starter Boilerplate provided to students
+import SwiftUI
+
+struct [BronzeComponentView]: View {
+    // TODO 1 [Bronze]: Declare the missing state variable with appropriate property wrapper
+    // [Fill in line here]
+    
+    var body: some View {
+        VStack(spacing: 16) {
+            Text("[Title Text]")
+                .font(.headline)
+            
+            // TODO 2 [Bronze]: Connect state variable to Text/TextField binding
+            // [Fill in UI element here]
+        }
+        .padding()
+    }
+}
+```
+
+- **Verification Check:** Run test `testBronzeBaseline()` — Expect status `PASS`.
+
+---
+
+## [REQUIRED] 🥈 Silver Tier: Independent Application (Target Mastery)
+- **Target Audience:** Learners who completed Bronze without mentor intervention.
+- **Guiding Prompt:** [Add dynamic logic, validation, state mutations, or multiple interactive elements].
+
+### Specification & Requirements:
+1. **Dynamic Input Validation:** [E.g., Prevent empty submissions; format currency/dates].
+2. **State Transition Logic:** [E.g., Toggle boolean flags, update array state immutably].
+3. **User Feedback:** [E.g., Display contextual error banner if condition fails].
+
+### Implementation Target:
+```swift
+struct [SilverComponentView]: View {
+    // Write full implementation satisfying the 3 requirements above
+}
+```
+
+- **Verification Check:** Run test `testSilverLogicAndValidation()` — Expect status `PASS`.
+
+---
+
+## [REQUIRED] 🥇 Gold Tier: Enrichment & Optimization (Open Extension)
+- **Target Audience:** Advanced learners finished ahead of schedule.
+- **Architectural Challenge:** [E.g., "Decouple state into an isolated Actor / ViewModel with async/await Debounce or Cache invalidation"].
+
+### Constraints & Invariants:
+- ⚡ **Constraint 1:** [E.g., "Must guarantee zero data-race under concurrent mutations"].
+- ⚡ **Constraint 2:** [E.g., "Must implement clean dependency injection without global singletons"].
+
+---
+
+## [REQUIRED] Automated Test Verification Matrix & Mentor Hints
+```swift
+// XCTest / Unit Test Suite for Instant Auto-Grading
+final class [ArtifactTestSuite]: XCTestCase {
+    func testBronzeBaseline() {
+        // Assert Bronze state binding
+    }
+    func testSilverLogicAndValidation() {
+        // Assert Silver business rules
+    }
+    func testGoldConcurrencySafety() async {
+        // Assert Gold invariants
+    }
+}
+```
+
+### Mentor Debugging Cheatsheet:
+- **Common Bronze Stumble:** [e.g., Forgetting `$` when binding to TextField].
+- **Common Silver Stumble:** [e.g., Mutating state from non-main thread without MainActor].
+- **Gold Discussion Prompt:** *"How does this implementation scale when 10,000 events fire per second?"*