From 80da88e2bd1291f25a3aef1e97f897602a33de1b Mon Sep 17 00:00:00 2001
From: saagpatel <saagarpatel08@gmail.com>
Date: Sun, 7 Jun 2026 01:35:13 -0700
Subject: [PATCH] docs: add 90-second demo voiceover script
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Record-ready teleprompter companion to DEMO-PLAN.md: timecoded spoken
lines mapped to the five PortfolioCommandCenter tabs, [SCREEN] action
cues, swappable pickup lines, and a numbers cheat-sheet. Sanitized for
public — no PII, paths, handles, or individual portfolio repo names.
---
 DEMO-SCRIPT.md | 64 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 DEMO-SCRIPT.md

diff --git a/DEMO-SCRIPT.md b/DEMO-SCRIPT.md
new file mode 100644
index 0000000..2491bbd
--- /dev/null
+++ b/DEMO-SCRIPT.md
@@ -0,0 +1,64 @@
+# Demo Voiceover Script — Operator OS (90 seconds)
+
+Record-ready teleprompter script for the demo defined in [DEMO-PLAN.md](DEMO-PLAN.md).
+Drive **PortfolioCommandCenter**; read the **bold spoken lines**; do the
+`[SCREEN]` action just before each line. Total spoken ≈ 180 words ≈ 72 s of
+speech, leaving ~18 s of breathing room inside a 90 s cut.
+
+**Delivery:** conversational, confident, ~150 wpm. Pause on the dashes. Land hard
+on the word **forty-nine** — that's the line that sells the whole system.
+
+---
+
+### 0:00 — Cold open · app launch / Portfolio tab
+`[SCREEN]` Open the app cold. Let the full 129-row table paint. Don't narrate the loading.
+
+> **"This is every repo I've ever started — a hundred and twenty-nine of them — in one graded view. Not a commit log. A judgment call on every single one."**
+
+### 0:10 — Portfolio columns
+`[SCREEN]` Sort by risk tier. Slowly run the cursor across the columns: risk · context quality · registry status · tool · open-alert count.
+
+> **"Each repo carries a risk tier, a context-quality grade, and which agent built it. `git log` gives you a timestamp. This tells you what that timestamp actually means."**
+
+### 0:28 — Risk + Security tab
+`[SCREEN]` Switch to Risk + Security. Filter to elevated risk; let the security posture counts fill the frame.
+
+> **"And here's the number a timestamp can never give you — forty-nine of these repos have a live, high-or-critical security alert. Right now."**
+
+### 0:48 — Burndown tab
+`[SCREEN]` Switch to Burndown. Hover one advisory group so the "repos cleared by this bump" list expands.
+
+> **"It's not just a count — it's a fix list. Every advisory is grouped by the one dependency bump that clears it across every repo it touches."**
+
+### 1:02 — Trends → Weekly Digest
+`[SCREEN]` Flash the Trends drift chart (2–3 s), then cut to the Weekly Digest: headline, decision, next-step.
+
+> **"It keeps history, so I can watch risk drift over time. And every week it hands me one headline, one decision, one next move."**
+
+### 1:14 — Run auditor (header action)
+`[SCREEN]` Click **Run auditor** (fast mode). Let the views visibly reload on completion.
+
+> **"This isn't a static export. I regenerate the truth live, right from the app."**
+
+### 1:26 — Close · back on Portfolio, rest on the tool column
+`[SCREEN]` Return to Portfolio. Rest the cursor on the Claude Code / Codex attribution column. Hold for the final beat.
+
+> **"And it knows which agent built what — because two of them work this portfolio, under one control plane."**
+
+`[SCREEN]` Hold 1 s on the full table, then cut.
+
+---
+
+## Pickup lines (swap in if a beat runs long or you want a different close)
+
+- **Tighter cold open:** *"A hundred and twenty-nine repos. One question: which ones are actually worth finishing? This answers it."*
+- **Alt security beat:** *"Forty-nine live security alerts across the portfolio — and the exact bump that clears each one."*
+- **Alt close (coordination-forward):** *"Two autonomous agents, hundreds of branches, one source of truth keeping them honest."*
+
+## Numbers cheat-sheet (say these exactly)
+- **129** total repos · **49** with open high/critical alerts
+- Agent attribution: **Claude Code 53 · Codex 23** (the two coordinated lanes)
+- Recency: **91** repos touched in the last 7 days — "almost everything looks recent, which is *why* a timestamp is useless"
+
+*Pairs with DEMO-PLAN.md. Keep individual repo names blurred or off-frame when
+recording — show the system's shape, not the portfolio's contents.*