Ramis
12dbf69431
Reframe README around the real bottleneck (human coordination, not engineering ability) with the "five-minute meeting" cost story; rewrite the demo script to match. Update gemini/livekit/mongodb/digitalocean specs to reflect shipped code (Gemini Live agent, TTS, embeddings, Lyria via Interactions API; current API routes; hermes_jobs collections). Add hermes.md. Rename graph.md -> cont_learning.md. Remove outdated/dead docs (agent-learning scaffolding, graph-discovery, handoffs, superpowers, idea/plan/demo-setup) and the bundled LiveKit starter under examples/. Rewire CLAUDE.md doc-first gate off the deleted PLAN.md. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LuV8W8oNYRsDWKoqK8Mkqc
142 lines
6.4 KiB
Markdown
142 lines
6.4 KiB
Markdown
# PodMan — 4-Minute Demo Script
|
||
|
||
**Theme:** Continual Learning. **Hard limit:** 4:00. Practice to land at 3:45.
|
||
|
||
**The one-line story:** writing code isn't the bottleneck anymore — *coordinating
|
||
who's writing what* is. PodMan is a pair programmer for the whole team: it watches
|
||
every member's work in real time, gives everyone live status without anyone having
|
||
to interrupt anyone, 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. PodMan removes the reason to ask. Multiply the saved
|
||
recovery time across every teammate, every day, and that is the value.
|
||
|
||
---
|
||
|
||
## The script (4:00)
|
||
|
||
### 0:00–0:30 — The problem + hook
|
||
|
||
> "AI made writing code easy. The thing still slowing teams down is coordination
|
||
> — checking each other's work, re-planning collisions, and the constant 'what
|
||
> are you working on?' A five-minute question really costs both people 25 minutes
|
||
> of lost focus. PodMan is a pair programmer for the whole team: it watches
|
||
> everyone's work live, so anyone can see another's status without interrupting
|
||
> them — and it 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:50 — 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:50–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.
|
||
PodMan gives a whole team 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 teammate. 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:50 | **Continual learning — quiet + escalate** |
|
||
| 2:50 | The five-minute meeting, killed — Gemini Live conversation |
|
||
| 3:30 | DigitalOcean + Lyria + close |
|
||
| 3:50 | Buffer |
|