---
id: "{{ID}}"
title: "{{TITLE}}"
type: "CODE"
created_by: "Curriculum OS Builder"
phase: "P3"
deliverable: "P3-T3"
version: "{{VERSION}}"
date: "{{DATE}}"
template_contract: "artifact-template-v1"
template_required_sections:
  - "Technical Overview & Architecture Blueprint"
  - "Hardware Pinout & Wiring Configuration Matrix"
  - "Starter Code Sandbox"
  - "Verified Reference Solution Code"
  - "Automated Test / Verification Script"
  - "Common Syntax & Runtime Pitfalls Matrix"
---
# CODE LAB: [LESSON TITLE]

## Technical Overview & Architecture Blueprint
> How the code in this lab is structured and why. Reference the canonical
> identifiers (files, types, functions) from the LESSON Code Symbol Ledger —
> use those exact names, do not invent alternatives.

- **Architecture:** [Mermaid or ASCII diagram of the components/data flow]
- **Key decisions:** [2-4 bullets on design choices students should notice]

## [CONDITIONAL] Hardware Pinout & Wiring Configuration Matrix
> INCLUDE this section ONLY for lessons whose activity contract involves
> physical hardware wiring. For pure software / theory lessons, OMIT the
> entire section — do not emit placeholder wiring tables.

| Component | Pin / Connection | Notes |
|---|---|---|
| [Component] | [Pin] | [Why this wiring] |

## Starter Code Sandbox
> Skeleton the students start from, with explicit TODO comments marking every
> point they must implement.

```[language]
// [Starter code with TODO markers]
```

## Verified Reference Solution Code
> 100% syntactically valid, production-ready, fully commented. Must satisfy
> the verification script below.

```[language]
// [Complete reference solution]
```

## Automated Test / Verification Script
> How to compile / run / verify: exact commands and expected output.

```bash
# [Verify commands]
```

- **Expected result:** [What success looks like]

## Common Syntax & Runtime Pitfalls Matrix
> Extract the Common Mistakes table VERBATIM from the canonical knowledge
> context (KX). Do not re-invent or paraphrase — one canonical list per lesson.

| Pitfall | Symptom | Fix |
|---|---|---|
| [From KX Common Mistakes] | [What the student sees] | [Concrete correction] |