Video Script

${var} — Selector: <source> [--minutes N].

• repo:<owner/repo> → script about that repo's latest update wave (README + recent releases/commits decide what "the update" is).
• <url> → script about that product page / doc / announcement.
• <topic> (anything else non-empty) → script about that topic; research it first.
• empty → pick the most script-worthy update from the last 7 days of memory/logs/ (a shipped feature, a release, a milestone with receipts). If nothing qualifies, log VIDEO_SCRIPT_NO_SOURCE, send no notification, and exit clean.
• --minutes N anywhere → runtime target (default 4; ~150 spoken words per minute).

Examples: "repo:aeonfun/aeon --minutes 6", "https://example.com/launch", "our new payments integration --minutes 3".

Today is ${today}. Write a recording-ready video script. No placeholders — every number, address, and date in it must be verified this run.

Shared preamble

1. Read memory/MEMORY.md and the last 7 days of memory/logs/ — know what has already been covered, and don't script the same story twice.
2. If a soul/ directory exists, read soul/SOUL.md and soul/STYLE.md for voice calibration. The script is the operator talking to a smart friend — if soul/ is empty, default to terse, direct, first-person.
3. Parse ${var} per the selector above into source + minutes.

Step 1 — Research and verify (never skip)

The format is called receipts-first because the receipts are real:

• Fetch the live source now (WebFetch / gh api for repos — README and recent releases/commits). Do not write numbers, counts, addresses, or dates from memory.
• Collect concrete verifiable artifacts: contract addresses, live dashboards, version numbers, dollar figures, dates. These become the cold open and the Receipts section.
• Every claim you could NOT verify either gets cut or becomes a checkbox in "Verify before recording".

Step 2 — Find the angle

The cold open is never the pitch. It is the single most concrete, verifiable, surprising fact — shown, not claimed (a live dashboard, a list of on-chain addresses, a terminal). Test: could a skeptic check it in 30 seconds? The flex is usually the credibility mechanism (immutability, safety gates, audit trail, reproducible tests), not the feature list.

Step 3 — Write the script

Header block:

# <project> — "<Working Title>" — Video Script

**Runtime target:** ~M:SS
**Framing:** receipts-first (open on <the artifact>)
**Byline:** <the project's public handle>
**One-line pitch:** <one sentence, no hype>
**Rev:** v1, ${today} — plain-language pass baked in; every technical term explained in one line or cut.

Chapters, each with a time range:

## <Chapter name> — 0:00 – 0:25

**VO:**
> Spoken text as blockquote. Short sentences. Operator voice.

**On screen:**
- Concrete shot list: screencaps, terminals, motion graphics, captions in `backticks`.

Canonical arc (adapt, don't force): cold open (the receipt, no greeting) → context/problem (one plain-language line for the underlying tech) → how it works (the mechanism, credibility story first) → what's new or the demo → straight talk (limits, flat delivery — every script has this section; it is a feature, not a concession) → close + CTA (one action).

After the chapters, ALWAYS:

• Plain-language glossary — jargon → the phrasing used on screen, plus terms deliberately cut.
• Assets checklist — everything to capture or build; mark what must be captured day-of.
• Anti-tells checklist — the voice rules below plus per-video specifics (what not to oversell, whose failures not to dunk on).
• Verify before recording — dated checkboxes for every volatile fact, each with where to re-check it.
• Receipts — the verified facts with sources and the date verified (mandatory when the video makes on-chain or factual claims).