diff --git a/docs/demo-runbook.md b/docs/demo-runbook.md
new file mode 100644
index 0000000..f0e02ab
--- /dev/null
+++ b/docs/demo-runbook.md
@@ -0,0 +1,56 @@
+# PodMan — Demo Runbook (final, read-off)
+
+> One page. Reflects the **current live state** (`podman.live`) as of the final hour.
+> Companion to `docs/demo.md` (full 4-min script) — this is the de-risked version.
+
+## ⛔ Read first — last-hour changes that affect the demo
+
+1. **Suppression is DISABLED for the demo** (`shouldIntervene` only filters `info`).
+   Every real collision now surfaces — good (no accidental silencing). **But the
+   `docs/demo.md` 2:10 beat "it learned to stay QUIET / no card fires" will NOT
+   work.** Do the **escalate** half only (below). Do not promise silence on stage.
+2. **Do NOT redeploy prod.** The live build has demo code not on `main`
+   (`userPodContext`); redeploying `main` would remove it *and* surface stale
+   "SUPPRESSED" beats. If the auto-deploy timer is on, stop it before the run:
+   `systemctl stop podman-hermes-sync-deploy.timer`.
+3. **Never debug on stage.** Narrate, fall back to the backup recording, keep moving.
+
+## ✅ Pre-flight (do once, before you start)
+
+- [ ] `curl https://podman.live/health` → `{"ok":true}`
+- [ ] Deploy timer stopped (above); confirm exactly one agent: `systemctl status podman-platform-agent`
+- [ ] Browser open on the pod; **click "Enable audio"** in-room (TTS needs it)
+- [ ] Backup recording cued on a second device
+- [ ] Two screen-shares live (the two "engineers")
+
+## 🎬 The 3-minute path (the coherent, working story)
+
+| Time | Do | Say (land the value) |
+|---|---|---|
+| **0:00** | Pod view, two live screen tiles | "Coordination is the bottleneck now, not coding. PodMan watches everyone's work live — no one has to ask 'what are you on?'" |
+| **0:30** | Point at tiles; show activity stream filling | "Real screen-shares over **LiveKit**; each frame → **Gemini Vision** returns file/symbol/activity — a perception layer, not a chatbot." |
+| **1:05** | Two engineers edit the **same file**, unpushed | "GitHub can't see this — nothing's pushed. We fuse live screen context with **local git truth**." → **collision card** appears. |
+| **1:40** | **Accept** the card | Real **GitHub sync-PR** is created + outcome recorded. "One tap closes the loop." |
+| **2:10** | **Trigger the same collision again** | Card now says **"Seen before."** and escalates straight to the **Gemini TTS voice** cue. "It recalled the prior event from **MongoDB Atlas vector search** and escalated — that's the learning." |
+| **2:35** | Cut to **GraphView** | "This graph is materialized **live from MongoDB right now** — and here's the **`learned_from` edge**: PodMan learned who owns this file from the accepted outcome. Not a mock." |
+| **3:00** | Stack + close | "All on **DigitalOcean**, systemd-supervised; ambient score is **Gemini Lyria**. Coordination awareness, collisions caught before they cost an afternoon, memory that sharpens each session." |
+
+## 🗣️ Sponsor coverage (say each ≥ once)
+- **Gemini** — Vision (0:30), TTS voice (2:10), Lyria (3:00) — add Live conversation if time allows
+- **LiveKit** — "real screen-shares over LiveKit" (0:30), TTS over LiveKit (2:10)
+- **MongoDB** — "Atlas vector-search recall" + "graph materialized live from MongoDB" (2:10, 2:35)
+- **DigitalOcean** — "all on DigitalOcean, systemd-supervised" (3:00)
+
+## 🚑 If it breaks
+| Failure | Recovery |
+|---|---|
+| Voice doesn't fire | Cut to the card, say the line aloud — cards are the default path |
+| Collision won't trigger | Use the backup recording for that beat; keep narrating |
+| Graph looks empty/odd | Reload once; if still off, narrate from the recording |
+| Agent silent | Suspect a duplicate `podman-hermes` process, not the UI — but **don't fix on stage** |
+
+## Optional (only if ahead of time): the five-minute-meeting killer
+Open the live voice conversation; ask *"PodMan, what is everyone working on, and where is the collision detector?"* → answers via real tool calls (**Gemini Live API**). Skip entirely if tight on time or if it drops.
+
+---
+**The spine:** live awareness → collision caught pre-push → accept → **"Seen before." + voice + `learned_from` edge**. That's the win. Suppression/"stays quiet" is intentionally out this run.