The DEEP Build Kit · Card 12
Level 3 ■ Black: track card
Your Level 3 learning plan: sketch content, interface and state, plan before coding, enable a colleague content edit without logic changes, test two boundaries and regressions, and explain two coding choices. Publishing and further auditing add optional depth.
For: Level 3 ■ Black: you answered yes to both "Have you shared something you built with AI: a page or tool someone else opened?" and "Have you used a coding agent, such as Claude Code or Codex?"
Card 12 · Level 3 ■ Black · your day on one card, 0:00–3:00
- Your goal by the end of the session: a planned build, tested, then published or accessibility-checked.
- Minimum engineering evidence: the sketch, a colleague content change without logic edits, two boundary results, original-check regression results, and two explained coding choices. The learning plan below makes that evidence visible before optional publishing or further auditing.
- Your tool: Claude Code, in the Claude desktop app, or Codex, in the ChatGPT desktop app, installed and signed in. Each also runs in a terminal (card 09).
- Install failed? Use a working, school-permitted Level 2 tool (track card 11). Keep the engineering challenge: separate checked content from interaction logic, have a colleague change one content item, test two boundaries and explain two coding choices. A helper can support the content handoff; record it unfinished if it cannot be verified.
- Your problem: your own, on a blank page, with two constraint cards.
Your day
| Time | Block | What you do | Card | Checkpoint |
|---|---|---|---|---|
| −0:15 | Install clinic (optional) | Install the Claude or ChatGPT desktop app (or the terminal version) and sign in; run one test prompt | 09 | The agent answers |
| 0:00 | Hook (15) | Watch one problem built three ways; predict whether the Claude Code build passes its three checks, then watch them run | 01 | You know the two rules |
| 0:15 | Define the outcome (25) | Your own problem on the canvas. Last 5 minutes: pair critique | 02 | Outcome statement and three success checks written |
| 0:40 | Write the spec (15) | A blank page. Draw two constraint cards and write them in | 03, 14 | Spec written, with both constraints as requirements |
| 0:55 | Build Sprint 1 (50) | Sketch and plan, thin slice, core checks, colleague content edit and two boundaries; use the timed plan below | 04 | Content handoff and regression evidence, two coding choices explained |
| 1:15 | Save point | Commit or save a numbered copy, then rate yourself (below) | 04 | A saved version |
| 1:45 | Break (10) | Before you leave your seat, find out who your test partner is | ||
| 1:55 | Test like an engineer (20) | Swap with your test partner and run each other's checks | 05 | Bug log filled in, on each other's cards |
| 2:15 | Build Sprint 2 (20) | Repair a real failure, or test an unclear requirement if none failed. At 2:30: save, then fill in your station card | 06, 15 | Each failed check re-run |
| 2:35 | Gallery walk (20) | Round A: the 1s host, the 2s tour. Round B: swap. Try one build from each level | 15 | One fix circled |
| 2:55 | Retro and commitment (5) | Your commitment card (2); workshop feedback (3) | 07 | Commitment written; feedback sent |
1. Your spec (0:40)
- A blank page (card 03, version C). Use the ten headings of the template as a checklist, not a form. Your outcome statement and three success checks go in word for word.
- Draw two constraint cards (card 14). Write each in as a requirement, with the check that proves it.
2. Start the agent and plan first (0:55)
Sketch on paper first: the checked content and its named data section; the screens and controls; the state and reset behaviour; what it stores and where (nothing, or this browser only); the rules and files. Write three core checks and two boundary expectations before implementation.
Teacher workflow, including menu 9: your own spec names the teacher user, checked preparation steps and workflow checks. The planning prompt below still applies; your tool needs no quiz, right/wrong feedback or retrieval activity.
Then make an empty folder and start the agent in it, set to plan first (the Build Room's Tool guides and card 09 have the steps):
- Claude Code, desktop app: in the Code tab, choose Local, select your folder, and set the mode selector next to the send button to Plan.
- Claude Code, in a terminal: type
claude --permission-mode plan, and check the line under the prompt box says⏸ plan mode on. If you launched with--permission-mode planyou're already in plan mode. Shift+Tab is only for when you started with plainclaude: press it until you see⏸ plan mode on. - Codex, desktop app: in the ChatGPT app, open Codex, add your folder as a project, leave permissions on Ask for approval (never Full access), and type
/plan. If a label differs on your screen, the prompt below still asks for the plan in words. - Codex, in a terminal: type
codex --sandbox read-only. The prompt below asks for the plan in words.
Check the mode before you paste. Without plan mode, or read-only in a terminal, either agent may edit files and run commands without asking.
Then paste:
Build the classroom tool in my spec below. Follow its red lines: no login; nothing saved or sent unless my spec says so; no calls to any AI service or other website; one self-contained HTML file unless my spec says otherwise.
Plan first: list the files, what each screen does, what it stores, and how you'll check each success check. Don't write code until I say go.
MY SPEC, WITH MY TWO CONSTRAINTS AND MY SKETCH:
[PASTE]
Claude Code in a terminal: after the paste, type Follow the instructions in my paste. and press Enter.
Pasted text can contain instructions, so check what you paste: read it through before you send it, and paste only your own spec.
"Don't write code until I say go" is a request in words. Check the plan against your sketch, and correct it. Predict three things you expect to see, then say go.
- Claude Code: plan mode blocks edits until you approve the plan. When you approve it, choose Yes, manually approve edits (in the desktop app, switch the mode to Manual), then accept or reject each change.
- Codex, desktop app: the plan is your only check before edits: on Ask for approval, Codex may edit files in your folder without asking. Codex, in a terminal: if it asks to edit a file or run a command, read the request before you approve it.
Your learning plan
Coding goal: Separate checked content, interface and state; explain two coding choices, enable a colleague content edit without logic edits, and verify boundaries and regressions.
These are planning estimates, not measured learner completion times. Keep the whole-room schedule. Use generation time to check content, write expectations or review the plan; do not fill it with cosmetic changes.
Evidence to leave with:
- A sketch distinguishes checked content, UI controls, state, rules and files; the plan matches it.
- Explain two coding choices and how they serve the user, including the content/state/UI distinction.
- A colleague changes one item in a named content-data section without editing interaction logic; the change appears correctly.
- Two boundary cases have predicted and observed results; all three original checks are rerun after the content change and any repair.
- A peer opens the final artifact unaided; the saved version, contribution, retest and any remaining failures are recorded.
Sprint 1: fifty minutes
| Minutes within the sprint | Task | Proof |
|---|---|---|
| 0–8 | Sketch content, UI, state, rules and files. Write three core checks and two boundary expectations; compare the agent plan. | An annotated sketch and test table that exist before implementation. |
| 8–20 | Approve the plan and build one thin slice. At elapsed minute 20, save the available version even if partial. | One core action works, or a saved partial version with the blocking check named. |
| 20–30 | Run the three core checks, content comparison and key access checks on the current artifact. | Expected/observed results; repair blocking failures before attempting further depth. |
| 30–40 | Core task S13: a colleague changes one supplied item in the named content-data section, without editing logic. | The new content appears correctly; record the edited section and rerun the original checks. |
| 40–50 | Core task S14 and handoff: predict and test two boundaries, retest regressions, and explain two coding choices to a peer. | Two boundary logs, original-check results, a peer contribution and an explanation of content, state and UI. |
At elapsed minute 20, save the available version, even if partial. A saved reference page, current project backup or numbered file is evidence of progress; name what still fails.
Peer testing: In the 20-minute swap, use the story/setup and two nine-minute silent tests. The peer opens the final artifact, runs the three original checks and two named boundaries, and verifies the colleague content change. You stay silent and read the recorded evidence afterwards.
Sprint 2: twenty minutes
| Minutes within the sprint | Task | Proof |
|---|---|---|
| 0–3 | Choose the highest-priority failed check. If none failed, write one new boundary check or clarify an unclear requirement. | A check with exact actions and an expected result; no invented bug or unrelated feature. |
| 3–11 | Repair one real failure, or run the new check and repair only if it fails. Ask what changed and why. | One bounded change tied to a check, or evidence that the new check passed without changes. |
| 11–15 | With a peer, retest the changed or new check and the three short original checks on the final artifact. Log anything not completed. | Exact expected/observed results and version; record Failed or Not run honestly if the focused retest cannot finish. |
| 15–20 | Save the final version and prepare your station card. Name the peer contribution, coding decision and next use. | A saved artifact, station card, known limits and one useful next step. |
If stuck: Save and name the blocker; keep the useful outcome and move to a working permitted tool if needed. Simplify to one screen and interaction. Finish the sketch, core test evidence and two coding-choice explanations; record an unfinished content handoff instead of claiming it passed.
If ready: Complete the content-edit and two-boundary core tasks first. Then ask a colleague to supply a second checked content pack using the same interaction code, or add repeatable behaviour tests with tools already working. Publishing is optional; deepen the same useful task.
Do not pretend a partial tool is finished. The final version is ready when its success checks pass; record every unmet check honestly. Use the four-minute retest for the changed or new case and three short core checks. Start content and access review during Sprint 1; ask a helper to review code and Network activity in parallel. If a check needs longer, record Not run, its next action and the version saved. Do not claim a pass or finished delivery from an incomplete run.
Your architecture and test evidence
Complete this sketch before implementation. Keep checked content separate from the interaction logic so your colleague knows what may be changed.
| Part | Your sketch |
|---|---|
| Content | [checked questions, answers or steps; named data section] |
| Interface | [screens, controls, labels and visible status] |
| State | [what changes after an action; initial and reset state; where it lives] |
| Rules | [input/action → decision → state change → visible response] |
| Files | [files needed and why; keep the delivery self-contained] |
Write the expected results before generation. Record the observed result and saved version after running each check.
| Check | Exact action or input | Expected result | Observed result and version |
|---|---|---|---|
| Core 1 | [ ] | [ ] | [ ] |
| Core 2 | [ ] | [ ] | [ ] |
| Core 3 | [ ] | [ ] | [ ] |
| Boundary A | [ ] | [ ] | [ ] |
| Boundary B | [ ] | [ ] | [ ] |
Content handoff (S13 is core today): my content-data section is [ ]. My colleague changed [ ] to [teacher-checked, made-up replacement]. No interaction logic changed. I compared the displayed result with the replacement and reran the three core checks.
Boundary evidence (S14 is core today): choose two relevant boundaries such as an empty list, last item, repeated Check, undo or Reset. Predict both, run both and record actual results. After a content edit or repair, rerun all three original checks. A failing boundary is useful evidence; it is not a pass until independently retested.
Explain two choices without reading the agent reply: I put [content] in [named section] so a colleague can [ ]. I keep [state] in [place] and show [UI response] because [user need]. Explain the difference between content, state and interface; show your partner where each appears in the sketch and final file.
3. Save a version each time a check passes
First check that Git is there: type git --version in a terminal, or ask the agent to run it. If it prints a version number, ask the agent: "Commit this with the message: check [number] passes."
No Git? Save a numbered copy instead: index-v2.html, index-v3.html, and so on. Keep the old copies.
4. The save point (1:15)
- Save a version: commit, or save a numbered copy (
index-v2.html). - Rate yourself. Stuck: a sticky note on your laptop lid; a helper comes. On track: carry on. Ready for more: take a stretch card (card 14).
5. The swap (1:55): 9 minutes each way
Find your test partner before the break. Pair with anyone at a different level; if you can't, pair with someone who hasn't seen your build. Sit next to them when you come back. An odd number makes one trio, with 6-minute turns.
- The maker hands over the tool, the canvas and this card, then says nothing until the turn ends.
- The tester runs each success check exactly as written, then tries two relevant edge cases from card 05: for a quiz, try no answer or a right answer in another form; for a workflow, try repeated use or an empty list; test keyboard use and phone width too. For phone width: Narrow the browser window to its smallest, or send the file to your phone.
- The tester logs each failure in the bug log below: Check / Expected / What happened.
- Swap roles.
Bug log. The tester writes here, on the maker's card.
| Check | Expected | What happened |
|---|---|---|
6. Fix a failed check (2:15)
Fix failed checks only: no new features. If none failed, write one new boundary check or clarify an unclear requirement; test it and repair only a real failure. One change per prompt. Read what the agent says it changed, re-run the check yourself, then the others, then commit or save a numbered copy.
Success check [number] failed. When I [what I did], I expected [what should happen], but [what happened]. Fix only this.
Keep everything else unchanged. Explain what you changed and how I'd check it.
Your stretch
Complete the S13 content handoff and S14 two-boundary test in your learning plan first; they are core Level 3 work today. All checks pass? Choose further depth:
- Publish it on GitHub Pages (card 17), then re-run three of your checks on the live link, on a phone.
- Run the keyboard and contrast audit (card 08) and log each line.
Switching level
- The install failed, or the agent is the problem? Take the same spec to Level 2 ▲ Orange (track card 11), in AI Studio or any AI chat tool. Your blank-page spec already covers the template's sections.
- Your checks before anyone else uses it: card 08, safe building, then all 12 quality checks and the audit.
The whole kit: www.deepeducationnetwork.com/courses/build-with-ai/kit
DEEP Education Network · Build with AI · Two rules: no student names or data anywhere; nothing student-facing calls AI.