cat > /mnt/user-data/outputs/Module-3-Spec.md << 'EOF'
# Module 3 — Teaching with AI in the Classroom
**Staff AI Course · Iqra Teachers Training**
Spec v0.2 — 23 July 2026 · Status: DRAFT for leadership review · Not for build until Module 2 ships
v0.2 supersedes v0.1: assumption register added, every claim labelled, phased launch introduced, live-AI channel dependency resolved by design instead of assumed away.
---
Labelling convention (course rule, applied throughout)
- **[SOURCED]** — verified fact or leadership-stated fact, with source named
- **[DESIGN]** — a decision this spec proposes; needs leadership sign-off, not verification
- **[ASSUMPTION → VERIFY]** — currently unverified; the module must not depend on it until checked; verification path stated
---
Position in the course
- Module 1: Foundations — live [SOURCED: production platform]
- Module 2: Data Protection for Teachers — committed next [SOURCED: course roadmap]
- **Module 3: Teaching with AI in the Classroom** ← this spec
- Planned cards unchanged: Spotting AI in Student Work · AI Vocabulary
**[DESIGN]** Ordering: rails before road. Teachers learn what must never enter an AI tool (Module 2) before they operate one in front of a class (Module 3).
**[DESIGN]** Prerequisite gate: Module 1 certificate + Module 2 completion.
---
The critical dependency, stated openly
**Live AI use in a classroom requires a sanctioned channel, and none exists today.**
- [SOURCED: platform state] The only institutional AI surface teachers currently have is the course platform Assistant. Teachers do not hold school AI accounts.
- [SOURCED: Module 2 principle] Personal AI accounts are excluded for school work.
- Therefore, as of today, a teacher **cannot compliantly perform live AI interaction at the board**. Any module that trains it before the channel exists trains a violation.
**[DESIGN] Resolution — phased launch:**
- **Phase 3.1 (launchable now):** *Prepare with AI* + proven interactive tools. All AI work happens through the platform Assistant before the lesson; the board only displays reviewed results. No live AI at the board. This phase alone delivers most of the classroom value.
- **Phase 3.2 (gated on build):** *Think with AI Live* + *Class as Co-Pilot* unlock only when **Classroom Mode** ships — a full-screen assistant surface on the existing platform: server-side Anthropic API (same architecture as the course Assistant), institutional login, usage logged, personal-data guard active, no student data accepted. No new architecture; a new surface on the existing one.
- The module is written so Phase 3.1 is complete and certifiable on its own. Phase 3.2 lessons are built and benched (order-99 pattern already used in the course) until Classroom Mode is verified in production.
---
Assumption register
Every assumption this module rests on, with its verification path. **None may be treated as true in teacher-facing content until cleared.**
| # | Assumption | Status | Verification path |
|---|---|---|---|
| A1 | All the school and the school classrooms have interactive smartboards | [SOURCED: stated by Khurram, 23 Jul] — treat as leadership-stated; inventory not independently checked | Confirm count + models with Mr. Atif / Ms. Shamaela before the phrase "every classroom" appears in teacher copy |
| A2 | Installed boards have a working browser | [ASSUMPTION → VERIFY] | Physical test, one board per school |
| A3 | Boards have internet access in classrooms | [ASSUMPTION → VERIFY] — school networks often restrict panels | Same physical test; check with whoever manages the network |
| A4 | Boards can open a locally saved or platform-hosted HTML file full-screen | [ASSUMPTION → VERIFY] | Same physical test: open one platform-hosted lesson screen end-to-end |
| A5 | Third-party interactive tools (graphing, geometry, simulations) are free for school use, work on the panels, and pass the authorised-tools check | [ASSUMPTION → VERIFY] — no tool is named in teacher copy until each is individually verified for terms, panel compatibility, and Arabic support | Per-tool check at build time; verified list maintained in platform content, not hard-coded in lessons |
| A6 | A witness structure exists for the capstone in both schools | [ASSUMPTION → VERIFY] — the school has section heads [SOURCED: knowledge bank]; the school leadership structure for this purpose unconfirmed | Ask Mr. Atif; spec uses the neutral term "designated leader" until then |
| A7 | Lesson engine can host Module 3 lessons without engine changes | [ASSUMPTION → VERIFY] — plausible from Module 1, but only Claude Code can confirm against the codebase | Claude Code read-first review at build time |
| A8 | Lesson Screens library and witness-confirmation flow are feasible in current stack | [DESIGN + ASSUMPTION → VERIFY] — new features, not yet scoped | Claude Code scoping session; not promised to leadership until scoped |
| A9 | Classroom Mode is feasible as a surface on the existing assistant architecture | [ASSUMPTION → VERIFY] — architecture supports it in principle (server-side calls already live); effort unknown | Claude Code scoping session |
| A10 | Teachers' boards can be used for training sessions (rooms bookable, panels usable off-timetable) | [ASSUMPTION → VERIFY] | Confirm with principals when scheduling |
**Rule for the build:** A2–A4 are a single 30-minute physical test per school. That test is the go/no-go gate for the entire module. It happens before any content is written, any card is published, or any promise reaches leadership.
---
Module premise (teacher-facing copy — corrected)
v0.1 claimed "nothing in this module requires new hardware." That is the *goal*, not yet a fact — it holds only if A1–A4 verify. Teacher-facing premise, rewritten to assert only what is safe:
> This module teaches **lesson patterns** — ways of combining your classroom's interactive board, its browser, and the school's AI platform so lessons become more visual, more interactive, and more responsive, while you stay fully in charge. You will build real material for your own class, and everything you build is reviewed by you before any student sees it.
No claims about hardware coverage, no named third-party tools, no reference to unbuilt features.
---
Lessons — Phase 3.1 (launchable)
Cross-references use lesson NAMES, never numbers [SOURCED: course rule].
Lesson: Lesson Patterns, Not Buttons
Lesson: The Public Screen Rule
Lesson: Prepare with AI
Lesson: Proven Tools on the Big Screen
Lesson: A Lesson Plan with AI Inside
Lesson: Show the Impact
Lessons — Phase 3.2 (built, benched until Classroom Mode is live and witnessed in production)
Lesson: Think with AI Live
Lesson: Class as Co-Pilot
---
Capstone — Deliver One Segment
**[DESIGN]** Performance task, not planted errors:
1. Build one board-ready screen for your own subject and grade, AND
2. Deliver a ten-minute segment using it, witnessed by a **designated leader** (term pending A6) or recorded.
Phase 3.2 addition, when live: include one live-AI moment with the validation step spoken aloud.
Certificate for Module 3 certifies **classroom application** — as Module 1's certifies validation skill. Witness confirmation uses the existing role mechanism [SOURCED: admin role seeds exist]; the confirmation *flow* is new build (A8).
---
Build scope (Claude Code, later — nothing starts without explicit instruction)
- Module 3 lessons + checkpoints in existing engine (A7 verify first)
- Verified-tools content page (simple, admin-editable)
- Lesson Screens library (A8 — scope before promise)
- Witness confirmation flow (A8)
- Classroom Mode surface (A9 — scope before promise; gates Phase 3.2)
- Catalogue: Module 3 "planned" card via a NEW migration; migration 12 untouched [SOURCED: migration 12 rule]
Delivery format
**[DESIGN]** First module with a mandatory in-person session: conducted in a classroom, at the board (A10). Online lessons prepare; the room session builds; the capstone proves. Each teacher leaves the room session with their capstone screen started.
Governance summary (leadership copy, not teacher-facing)
- All AI access flows through the school platform — server-side, institutional, logged; the same architecture already live for the course Assistant [SOURCED: production platform]
- No student personal data on the board or in any AI tool — Module 2's rule enforced in the highest-visibility setting
- Preview Rule is the content-safety control: AI material reaches children only after teacher review
- No hardware or software purchases implied; no vendor is endorsed
- Phase 3.2 does not launch until Classroom Mode is witnessed working in production — the course's own "never claim before witnessed" rule [SOURCED: launch discipline, Module 1]
Sequenced open items (order matters)
1. **Board test** (A2–A4): one 30-minute test per school — the go/no-go gate
2. Board inventory confirmation (A1) with both principals
3. Claude Code scoping: A7, A8, A9 — read-first, no build
4. Witness structure (A6) with Mr. Atif
5. Tool verification (A5) — per tool, at content-build time
6. Naming: "Teaching with AI in the Classroom" vs. shorter catalogue title
7. Arabic track: follows the approved cookie-mode plan; born-bilingual if this lands after B4
EOF
echo "written"; wc -l /mnt/user-data/outputs/Module-3-Spec.md