Mark's Reports

app · 2026-04-14

Bidet AI — "Clean Classroom" Feature Brief

Author: Claude Code (G16), for Apex Claude to implement

Date: 2026-04-14

Source recordings: Saint Francis 6th grade history, Class A (10:44 AM) and Class B (11:34 AM), Monday 2026-04-14

Topic taught: Nixon-era détente → Ping Pong Diplomacy with China → SALT I with USSR → Middle East (Israel's 1948 founding, Suez Canal, Six-Day War) → current-events bridge to Strait of Hormuz and oil shipping


1. What this feature is

A new tab in Bidet AI — working title "Clean Classroom" — that takes a classroom clean_ transcript and transforms it into student-facing class notes for any kid who missed that period. It is not a summary for Mark. It is a study handout for a 6th grader.

Mark's spec, verbatim:

"I need a new tab... clean classroom. It needs to analyze it and format for class notes. Excludes the way off topic, mentions the topic of the tangent. Designed to be a replacement for anyone missing class. It should answer, verify and gently correct my open questions and statements."

2. How Mark actually teaches (verified from both recordings)

This matters because the prompt has to respect how he runs a room:

Tangent rule of thumb: If it doesn't connect back to the chapter/unit within ~2 sentences, it's a tangent. Alaska pipeline is a tangent from Middle East oil, but Mark ties it back to oil shipping so it counts as on-topic. The student trip / carry-on rules / Air Canada flight question at the end of Class A is a pure tangent — body ends before that.

3. What "Clean Classroom" should output

Student-facing notes that:

1. Cover the on-topic material in teaching order (the order Mark presented it, not textbook order).

2. Use Markdown headings per major topic, bold for terms to know, bullets for facts.

3. Include a "What you missed in one minute" TL;DR block at the top — 3–5 bullets.

4. Exclude way-off-topic tangents from the body, but note the tangent parenthetically in italics so the absent student knows it happened: (Class briefly discussed the upcoming student trip to Italy and carry-on rules — ask a classmate if you need details.)

5. Gently fill in Mark's open questions and partial-wrong statements — phrased as study-support, not correction. Use bracketed notes like [Answer: …] or [Quick fact: …]. Never "Mr. Barnett got this wrong." If he said "I'd have to look it up" — look it up and add the answer in brackets.

6. Flag open questions for next class so the student walks in ready: > Open for next class:

7. End with a "Key terms" glossary and a "Possible quiz questions" section (Mark mentioned a Friday quiz in Class A — students will want this).

4. UI — new tab in Bidet AI

Tab location: Add as a fourth tab alongside existing Record / Clean / Analyze tabs. Name it "Student Notes" in the UI (cleaner than "Clean Classroom" — Mark's spec says the name is flexible).

Inputs:

Output panel:

No user-visible prompt editing — keep it one-click. Mark doesn't want to tune prompts; that's our job.

5. Pipeline — how it slots in

Existing pipeline produces clean_<ts>.txt (cleaned transcript), forai_<ts>.txt (LLM-ready), and analysis_<ts>.txt (summary for Mark). Clean Classroom runs as a fourth parallel output, consuming the same clean_ file as input but calling a separate LLM pass with the system prompt below. Output goes to notes_<ts>.md next to the other dumps and is surfaced in the new Student Notes tab. No changes to the existing three outputs. Runs automatically after a recording finishes and on-demand via the dropdown.

6. System prompt (the key deliverable)


You are generating class notes for a middle-school student (6th grade by default)
who missed today's class. Your input is a cleaned-up transcript of the teacher,
Mr. Barnett, teaching a history lesson. The transcript is ~90% Mr. Barnett and
~10% brief student questions. Mr. Barnett teaches Socratically: he asks the class
questions and nudges them toward answers, he thinks out loud and sometimes self-
corrects, and he rides tangents to make the material real before snapping back.

Your job: turn this raw teaching into clean, student-facing class notes that can
fully replace being in the room that day.

REQUIRED OUTPUT STRUCTURE (Markdown):

1. Title line: `# Class Notes — <date> — <topic inferred from transcript>`
2. `## What you missed in one minute` — 3 to 5 plain-language bullets.
3. `## Notes` — the main body, broken into `###` subheadings for each major topic
   in the order Mr. Barnett taught it. Use bullets for facts, **bold** for terms
   to know, and short paragraphs where a story needs to flow (Mr. Barnett often
   teaches through story — keep that).
4. `## Key terms` — glossary, one line each.
5. `## Open for next class` — anything Mr. Barnett left hanging on purpose.
6. `## Possible quiz questions` — 4 to 6 questions a student could use to self-check.

RULES:

- **Exclude way-off-topic tangents from the body.** Examples of way-off-topic:
  upcoming field trips, airline logistics, classroom supply requests, side chat
  about sports scores, comments about specific students. When you cut a tangent,
  replace it with a single italic line in the body so the absent student knows it
  happened, e.g.:
  *(Class briefly discussed the upcoming Italy trip and carry-on rules — ask a
  classmate for details.)*

- **Keep on-topic tangents.** If Mr. Barnett drifts from Middle East oil into the
  Alaska pipeline and ties it back to oil shipping, that counts as on-topic —
  include it.

- **Gently fill in open questions and self-corrections.** When Mr. Barnett asks
  the class a question and no clear answer lands, or he says "I'd have to look
  that up," or he hedges ("I think so, I'm pretty sure"), supply the correct
  answer inline using a bracketed note:
  **[Answer: …]** or **[Quick fact: …]**
  Never say "Mr. Barnett was wrong" or "Mr. Barnett didn't know." Frame every
  fill-in as helpful context for the student, not a correction of the teacher.

- **When Mr. Barnett self-corrects mid-sentence, use the corrected version only.**
  Don't preserve the stumble.

- **Preserve Mr. Barnett's voice and analogies.** He explains canals as "man-made
  rivers," compares missile silos to grain silos in Milton, GA, and says "money
  makes the world go around." Keep those — they're how the kids will remember it.

- **If a student question in the transcript triggered an important explanation,
  you may quote the student question in italics** as a section opener, because
  that's often where the best teaching happened. Do not name the student.

- **Open for next class** goes in its own section at the end. Only include items
  Mr. Barnett intentionally left open for next period, not things he forgot or
  you filled in.

- **Reading level:** 6th grade. Short sentences. Active voice. Define any word a
  6th grader might not know on first use.

- **Length target:** roughly the length of the transcript's on-topic content,
  compressed about 2x. A 40-minute class should yield ~800–1500 words of notes.

- **Do not fabricate.** If the transcript is too garbled to tell what was taught,
  say so in the TL;DR and output only what you can verify.

- **Do not name any students by name**, even if names appear in the transcript.
  Student questions are attributed as "A student asked…" only.

Return only the Markdown notes. No preamble, no explanation.

7. Example output snippets — drawn from the actual 10:44 AM Class A recording

These are spot-examples, not a full draft. Use them to calibrate tone.

Example 1 — TL;DR opener:

## What you missed in one minute
- Review of political cartoons: cartoonists exaggerate one feature (Nixon's nose, Obama's ears, Trump's hair and tie).
- Ping Pong Diplomacy: the US used a friendly ping pong match as cover to open talks with communist China under Nixon.
- The real goal was to pull China away from backing North Vietnam so the Vietnam War could end.
- Nixon's foreign policy after Vietnam: help other countries, but don't take "basic responsibility" — no more Vietnams.
- Intro to the Middle East: why Israel exists, and why the Suez Canal and Strait of Hormuz matter for world oil.

Example 2 — body section with an on-topic tangent kept in and a gentle fill-in bracketed:

### Ping Pong Diplomacy
After 1949, China became communist, and the US refused to even recognize the Chinese government. America hated communism. But Nixon wanted a way in. Going to China openly would have been too controversial, so the US and China set up a "friendly" — a ping pong match between the two national teams.
On the surface: just ping pong. Behind the scenes: American and Chinese diplomats (people whose job is negotiating instead of fighting) were meeting and making deals. That is what diplomacy means — talking it out instead of shooting it out.
Why did the US want to be friends with China? Not because of China itself — because of Vietnam. China was supplying weapons to North Vietnam and Ho Chi Minh. If China stopped helping North Vietnam, North Vietnam couldn't keep fighting, and the Vietnam War could end. [Quick fact: Nixon officially visited China in February 1972, and it was the first time a sitting US president had ever done so.]

Example 3 — self-correcting a hedge as a bracketed fact:

Mr. Barnett mentioned the US and USSR agreed to exchange in two specific areas under détente. [Answer: science and technology.] This came out of the SALT talks, which we'll cover more next class.

Example 4 — tangent excluded from body, noted in italics:

### The Strait of Hormuz (current events bridge)
Today, Iran is doing something similar to what Egypt did with the Suez Canal. The Strait of Hormuz is a very narrow gap of ocean between Iran and the Arabian Peninsula. Almost all of the oil from Kuwait, Iraq, and Iran has to be loaded onto ships and pass through this strait to reach the rest of the world. Iran has effectively shut it down — ships are parked and not moving. That is why gas prices are going up right now.
(Class briefly discussed why it's sometimes cheaper to fly from Florida to Canada than from Georgia to Canada, related to Atlanta airport hubs and Air Canada routes — ask a classmate if you want the details.)

Example 5 — "Open for next class" section:

## Open for next class
- We will finish the reading on the Soviet Union section and move into the full Arab-Israeli wars.
- Homework: finish the reading (about a page and a half).
- Quiz on Friday — about 5 questions, covering this week's material.

8. What NOT to include in the notes

9. Implementation notes for Apex Claude

10. Verification — these recordings DID transcribe cleanly

Both Class A and Class B came through clearly. The diarization is usable, Mark's voice carries the lesson, student questions are distinguishable. No gibberish. Feature can be built and tested against these two files as the first real-world inputs.


End of brief. Apex Claude: implement. G16 Claude: standing by to iterate on the system prompt once you have the first real output to compare against.