Ramis
bc50406587
Reframe the demo around the real shift: AI collapses the cost of writing code (humans-with-AI now, agent swarms next), so the bottleneck moves from engineering to coordination/management — and at agent scale no human can track progress or avoid collisions by hand. Add a dedicated 1-minute live script for showing real-time card+voice interventions with teammates, and align the 4-min opening/close with the thesis. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LuV8W8oNYRsDWKoqK8Mkqc
226 lines
11 KiB
Markdown
226 lines
11 KiB
Markdown
# PodMan — Demo Scripts
|
||
|
||
**Theme:** Continual Learning. Two scripts below: a **1-minute live script**
|
||
(§ first) for showing real-time interventions fast with teammates, and the full
|
||
**4-minute script** for the complete story. Practice the 4-min to land at 3:45.
|
||
|
||
**The thesis (say this first, in either script):** AI is collapsing the cost of
|
||
_writing_ code. More and more of every codebase is authored with AI assist — and
|
||
increasingly by **autonomous agents**. So the bottleneck of software engineering
|
||
is shifting away from engineering itself toward **organization, management, and
|
||
project coordination**. Pair a team with hundreds of agents all committing to the
|
||
same repo at once and it becomes **physically impossible for a human to track
|
||
progress or avoid stepping on someone else's work.** Code generation scaled;
|
||
human coordination did not. That gap is the new bottleneck.
|
||
|
||
**The one-line story:** writing code isn't the bottleneck anymore — _coordinating
|
||
who (and what) is writing what_ is. PodMan is a pair programmer for the whole
|
||
team — humans **and** agents: it watches every actor's work in real time, gives
|
||
everyone live status without anyone having to interrupt anyone, catches collisions
|
||
before they land, and learns your team's dynamics so it nudges less and helps more
|
||
over time.
|
||
|
||
**The hook to land:** a "quick five-minute question" actually costs ~25 minutes of
|
||
lost focus — for two people. Now multiply that across a team plus a swarm of
|
||
agents nobody can watch. PodMan removes the reason to ask and surfaces the
|
||
collision no human could have caught in time. That recovery time, saved across
|
||
every actor, every day, is the value.
|
||
|
||
---
|
||
|
||
## 1-Minute Live Script (you + teammates — real-time interventions)
|
||
|
||
**Goal:** prove the core loop in 60 seconds — multiple people working at once,
|
||
PodMan catches the collision and **notifies everyone live (card + voice)** with
|
||
nobody having to ask. **Hard limit:** 1:00.
|
||
|
||
**Setup before you start (off camera):**
|
||
|
||
- Pod open on the shared screen (`podman.live`), all teammates joined with screen
|
||
share on. Sound on — voice is live for **every** intervention now.
|
||
- Each teammate's git watcher running so local unpushed edits report in.
|
||
- Have everyone with `README.md` open and ready to type. Pre-pick the two who
|
||
will collide first (e.g. you + a teammate).
|
||
|
||
### 0:00–0:12 — The thesis (one breath)
|
||
|
||
> "Writing code is basically free now — humans with AI, and soon swarms of
|
||
> agents, all committing to one repo. Nobody can track that by hand. The
|
||
> bottleneck isn't engineering anymore, it's coordination. Watch."
|
||
|
||
_On screen:_ the pod view, teammate tiles live, activity stream moving.
|
||
|
||
### 0:12–0:35 — The collision, caught live (the money shot)
|
||
|
||
- On cue, **you and one teammate both edit `README.md`** and save (unpushed).
|
||
- Within a cycle, a **conflict card appears on everyone's screen**:
|
||
_"Conflict: <you> + <teammate> both on README.md (unpushed)."_
|
||
- The **Gemini voice fires out loud over LiveKit**: _"<you> and <teammate> are
|
||
both editing README.md. Please sync before pushing."_
|
||
- Say it: "Neither of us asked the other. Neither of us was watching. PodMan saw
|
||
both screens plus local git, and told the whole team in real time."
|
||
|
||
### 0:35–0:52 — It scales to the next actor
|
||
|
||
- Have a **third teammate** now edit the same file (or a second file). A **new**
|
||
card + voice fires for the new pair — _it doesn't go silent on the second
|
||
collision._
|
||
- Say it: "Every new actor that steps on live work gets caught — this is exactly
|
||
what breaks when you add agents you can't watch."
|
||
|
||
### 0:52–1:00 — Close
|
||
|
||
> "Real-time awareness for a whole team, humans and agents, with zero
|
||
> interruptions. That's the coordination layer code generation never had."
|
||
|
||
_Fallback:_ if voice doesn't fire, read the line aloud and point at the card —
|
||
cards are the default path. If a card won't trigger, switch the colliding pair
|
||
to a fresh file and re-save.
|
||
|
||
---
|
||
|
||
## The script (4:00)
|
||
|
||
### 0:00–0:30 — The problem + hook
|
||
|
||
> "AI made writing code almost free — humans with AI today, swarms of autonomous
|
||
> agents tomorrow, all committing to the same repo. The bottleneck stopped being
|
||
> engineering and became coordination: checking each other's work, re-planning
|
||
> collisions, the constant 'what are you working on?' At agent scale no human can
|
||
> even track it. A five-minute question already costs both people 25 minutes of
|
||
> lost focus. PodMan is a pair programmer for the whole team — humans and agents:
|
||
> it watches everyone's work live, so anyone sees another's status without
|
||
> interrupting them, catches collisions before they land, and learns your team as
|
||
> it goes."
|
||
|
||
_On screen:_ the pod view, two teammates joined, screen-share tiles live.
|
||
|
||
### 0:30–1:05 — Real-time team awareness (LiveKit + Gemini Vision)
|
||
|
||
- Point at the two live screen tiles. "These are real screen shares over
|
||
**LiveKit**. Our agent subscribes to the tracks and samples frames."
|
||
- "Each frame goes to **Gemini Vision**, which returns structured context — file,
|
||
symbol, activity — not a chatbot, a perception layer."
|
||
- Show the live activity stream filling in (Signals vs Reasoning sections).
|
||
- Land the value: "This is the part that replaces 'what are you working on?' —
|
||
every teammate's current work is just _visible_, in real time. Nobody had to
|
||
ask."
|
||
|
||
_Built-by-us callout:_ `backend/src/vision/gemini.ts`, the LiveKit agent worker.
|
||
|
||
### 1:05–1:40 — The catch (detection + first intervention)
|
||
|
||
- Have alice and bob both edit the **same file** with unpushed changes.
|
||
- "Normally nobody notices until merge time. GitHub can't see this — nothing's
|
||
pushed. Our detector fuses live screen context with **local git truth** from a
|
||
watcher on each laptop."
|
||
- A collision card appears: _"alice + bob both on detector.ts (unpushed)."_
|
||
- Let the **Gemini TTS** urgent voice fire once over LiveKit: _"alice and bob are
|
||
both editing detector.ts. Please sync before pushing."_
|
||
- Land the value: "That's a merge conflict and a wasted afternoon caught before it
|
||
happened — and neither of them had to be tracking the other."
|
||
|
||
_Built-by-us callout:_ `collision/detector.ts`, `action/hermes.ts`,
|
||
`voice/live.ts`.
|
||
|
||
### 1:40–2:10 — Cross-channel overlap (research + code)
|
||
|
||
- Keep alice editing `livekit.py`.
|
||
- Have bob share a browser tab on LiveKit docs/SDK pages.
|
||
- A collaboration nudge appears: _"🤝 bob is researching LiveKit agents
|
||
(docs.livekit.io) while alice edits livekit.py — sync up before duplicating
|
||
effort."_
|
||
- Land the value: "This is not a merge conflict. PodMan caught duplicated effort
|
||
across channels — code on one screen, research on another — and nudged the team
|
||
before two people solved the same problem twice."
|
||
|
||
_Built-by-us callout:_ `vision/gemini.ts`, `collision/research.ts`,
|
||
`memory/vectors.ts`.
|
||
|
||
### 2:10–2:50 — Continual learning (the theme — the money shot)
|
||
|
||
This is the differentiator. Two beats, both from pre-seeded memory:
|
||
|
||
1. **It learned to stay quiet.** Trigger a pattern that was dismissed as a false
|
||
alarm earlier. "Last session a teammate marked this kind of alert as not a
|
||
real conflict. Watch — PodMan stays silent. No nagging." (No card fires.)
|
||
2. **It learned to escalate.** Trigger the real-conflict pattern that was
|
||
accepted before. The card now says **"Seen before."** and goes straight to
|
||
the spoken urgent cue.
|
||
|
||
- "The only input was one accept/dismiss tap. No retraining, no labeling. This is
|
||
**MongoDB Atlas vector search** recalling similar past events plus a policy
|
||
that adapts on the recalled outcome."
|
||
- Optional: show `/api/memory/stats` counts climbing — accumulated experience.
|
||
|
||
_Built-by-us callout:_ `memory/vectors.ts` ($vectorSearch), `memory/policy.ts`
|
||
(outcome-conditioned gate), `memory/store.ts`.
|
||
|
||
### 2:50–3:30 — The five-minute meeting, killed (Gemini Live API)
|
||
|
||
- Frame it: "Instead of breaking a teammate's focus to ask what they're up to,
|
||
you ask PodMan."
|
||
- Open the live voice conversation. Ask out loud: _"PodMan, what is everyone
|
||
working on, and where is the collision detector implemented?"_
|
||
- It answers with **real tool calls** — `search_repo`, git history, current
|
||
collisions — not guesses.
|
||
- "This is the **Gemini Live API**, streaming speech-to-speech over LiveKit, with
|
||
custom function tools we wrote so it grounds every answer in the actual repo
|
||
and live state. That's the status sync, answered in seconds, with zero recovery
|
||
tax on anyone else."
|
||
|
||
_Built-by-us callout:_ `agents/podman-live-conversation/agent.py`.
|
||
|
||
### 3:30–3:50 — Stack + close
|
||
|
||
- "All on **DigitalOcean** — static frontend, API, and agent workers, supervised
|
||
by systemd. The ambient score is **Gemini Lyria** generated per pod through the
|
||
Interactions API."
|
||
- Close: "Engineering ability stopped being the bottleneck — coordination is, and
|
||
it only gets worse as agents start writing alongside us. PodMan gives a whole
|
||
team, humans and agents, real-time awareness without the interruptions, catches
|
||
collisions before they cost an afternoon, and learns each team's dynamics so it
|
||
helps more over time. Saved focus, multiplied across every actor. That's
|
||
continual learning, shipped."
|
||
|
||
### 3:50–4:00 — Buffer / Q&A handoff
|
||
|
||
---
|
||
|
||
## Sponsor-prize coverage (say each at least once)
|
||
|
||
| Prize | Spoken moment | Segment |
|
||
| ---------------- | -------------------------------------------------------------------------------- | ---------------------- |
|
||
| **Gemini** | Vision perception, Live API agent w/ tools, TTS voice, Lyria score | 0:30, 1:05, 2:50, 3:30 |
|
||
| **LiveKit** | "real screen shares over LiveKit", agent subscribes, TTS audio track, live voice | 0:30, 1:05, 3:30 |
|
||
| **MongoDB** | "Atlas vector search recalling past events" | 1:50 |
|
||
| **DigitalOcean** | "all on DigitalOcean, systemd-supervised workers" | 3:30 |
|
||
|
||
---
|
||
|
||
## If something breaks (live recovery)
|
||
|
||
| Failure | Recovery |
|
||
| ----------------------- | ----------------------------------------------------------------------- |
|
||
| Voice doesn't fire | Cut to the card; say the line aloud; cards are the default path anyway. |
|
||
| Live conversation drops | Skip 2:50–3:30; lean longer on the learning beat. |
|
||
| Collision won't trigger | Use the backup recording for that beat; keep narrating. |
|
||
| Agent flapping | Pre-checked — but if so, `systemctl restart podman-platform-agent`. |
|
||
|
||
**Rule:** never debug on stage. Narrate, fall back to recording, keep moving.
|
||
|
||
---
|
||
|
||
## Tight timing summary
|
||
|
||
| Time | Beat |
|
||
| ---- | ---------------------------------------------------------- |
|
||
| 0:00 | Problem (coordination cost) + hook + original-work line |
|
||
| 0:30 | Real-time team awareness — LiveKit + Gemini Vision |
|
||
| 1:05 | The catch — collision caught before merge |
|
||
| 1:40 | Cross-channel overlap — research + code nudge |
|
||
| 2:10 | **Continual learning — quiet + escalate** |
|
||
| 2:50 | The five-minute meeting, killed — Gemini Live conversation |
|
||
| 3:30 | DigitalOcean + Lyria + close |
|
||
| 3:50 | Buffer |
|