{
  "schemaVersion": "1",
  "revision": "22ce5d34dbcb5a78",
  "id": "codex-video-packets",
  "slug": "video-packets",
  "title": "Turn recordings into video evidence packets",
  "summary": "A long recording is not one prompt. It is a pile of evidence with a timeline.",
  "category": "Context",
  "tags": [
    "video",
    "evidence",
    "oracle"
  ],
  "sources": [
    {
      "label": "Codex workflows companion",
      "url": "https://lapis-fossil-vsbc.here.now/#video-packets"
    },
    {
      "label": "Published workshop recording",
      "url": "https://www.dropbox.com/scl/fi/3m5p2dwkx0imuyu0dq5os/GMT20260626-155513_Recording_gallery_1920x1080.mp4?rlkey=60j5649let6pt4fdxpggozv1q&st=qhbuo513&dl=0"
    }
  ],
  "sourceUnits": [
    "src/content/final/chunk-12-turn-long-recordings-into-video-evidence-packets.md",
    "src/content/final/chunk-12-turn-long-recordings-into-video-evidence-packets.md#Turn Long Recordings Into Video Evidence Packets",
    "src/content/final/chunk-12-turn-long-recordings-into-video-evidence-packets.md#Turn Long Recordings Into Video Evidence Packets/The Failure",
    "src/content/final/chunk-12-turn-long-recordings-into-video-evidence-packets.md#Turn Long Recordings Into Video Evidence Packets/The Move",
    "src/content/final/chunk-12-turn-long-recordings-into-video-evidence-packets.md#Turn Long Recordings Into Video Evidence Packets/Keep The Video",
    "src/content/final/chunk-12-turn-long-recordings-into-video-evidence-packets.md#Turn Long Recordings Into Video Evidence Packets/Chunk By Evidence Density",
    "src/content/final/chunk-12-turn-long-recordings-into-video-evidence-packets.md#Turn Long Recordings Into Video Evidence Packets/Ask For Screen Evidence",
    "src/content/final/chunk-12-turn-long-recordings-into-video-evidence-packets.md#Turn Long Recordings Into Video Evidence Packets/Carry Prior Chunks Forward",
    "src/content/final/chunk-12-turn-long-recordings-into-video-evidence-packets.md#Turn Long Recordings Into Video Evidence Packets/Use It For Software Work",
    "src/content/final/chunk-12-turn-long-recordings-into-video-evidence-packets.md#Turn Long Recordings Into Video Evidence Packets/Copyable Artifact: Video Evidence Packet",
    "src/content/final/chunk-12-turn-long-recordings-into-video-evidence-packets.md#Turn Long Recordings Into Video Evidence Packets/Claim Boundaries",
    "src/lib/content/sections.ts",
    "src/lib/content/sections.ts#video-packets",
    "src/lib/content/sections.ts#recordingSpans"
  ],
  "collection": "codex",
  "categoryId": "context",
  "wordCount": 1233,
  "url": "/topics/codex-video-packets/",
  "markdownUrl": "/markdown/codex-video-packets.md?raw=1&v=22ce5d34dbcb5a78",
  "jsonUrl": "/api/v1/documents/codex-video-packets.json",
  "headings": [
    {
      "id": "the-failure",
      "text": "The Failure",
      "level": 2
    },
    {
      "id": "the-move",
      "text": "The Move",
      "level": 2
    },
    {
      "id": "keep-the-video",
      "text": "Keep The Video",
      "level": 2
    },
    {
      "id": "chunk-by-evidence-density",
      "text": "Chunk By Evidence Density",
      "level": 2
    },
    {
      "id": "ask-for-screen-evidence",
      "text": "Ask For Screen Evidence",
      "level": 2
    },
    {
      "id": "carry-prior-chunks-forward",
      "text": "Carry Prior Chunks Forward",
      "level": 2
    },
    {
      "id": "use-it-for-software-work",
      "text": "Use It For Software Work",
      "level": 2
    },
    {
      "id": "copyable-artifact-video-evidence-packet",
      "text": "Copyable Artifact: Video Evidence Packet",
      "level": 2
    },
    {
      "id": "claim-boundaries",
      "text": "Claim Boundaries",
      "level": 2
    },
    {
      "id": "related-resources",
      "text": "Related resources",
      "level": 2
    }
  ],
  "markdown": "# Turn recordings into video evidence packets\n\nA long recording is not one prompt. It is a pile of evidence with a timeline.\n\nDo not reduce it to a transcript too early. Keep the video as prompt material, cut the recording into chunks, send each chunk through the video-watching lane, extract screen evidence while it is still visible, and carry prior summaries forward.\n\nThe artifact you want is not a summary. It is a **video evidence packet**.\n\n## The Failure\n\nA five-hour workshop, app walkthrough, or bug reproduction contains too much visual detail for one tidy answer.\n\nIf one model response has to summarize the whole recording, it will usually flatten the exact details software work needs:\n\n- tooltip text\n- disabled button states\n- cursor actions\n- modal transitions\n- terminal output\n- code snippets\n- missing steps\n- retries and failed attempts\n- loading, error, and empty states\n\nThe problem is not only upload size. The problem is **answer density**. One huge answer cannot carry every useful screen fact.\n\n> It's very difficult to get good information out of it that way, because it's limited by the amount of tokens it can provide in one response.\n>\n> — John Lindquist\n\n## The Move\n\nCreate video evidence packets.\n\nA video evidence packet is a **chunked, source-preserving record** of what happened in a slice of video:\n\n- clip\n- transcript slice\n- chat slice\n- key frames\n- visible text\n- UI states\n- actions\n- code snippets or terminal output\n- omissions\n- model output\n- verification notes\n\nThe packet gives the next agent inspectable context without pretending it watched the whole recording.\n\n## Keep The Video\n\nVideo is not just a transcript with pictures nearby. For UI work, the screen matters.\n\nA tooltip, hover state, selected tab, disabled button, cursor path, dialog, terminal frame, or loading spinner can be the evidence. Keep the clip attached as prompt material until the visual claims have been extracted and checked.\n\nIn the demonstrated workflow, the local agent owned the files, prompts, saved outputs, and verification. **[Oracle](https://github.com/johnlindquist/oracle)** handled the browser handoff. **[Gemini](https://gemini.google.com/app)** was the video-watching lane for that run. The repo received the output as reviewable files.\n\nTreat exact model behavior, limits, quotas, pricing, and account budget as current-product details that must be rechecked before relying on them in shared guidance.\n\n## Chunk By Evidence Density\n\nUse chunks small enough that each answer can stay specific.\n\n> What you can do with an agent is split the video into, like, 15-minute chunks, and then in each of those chunks, you can say, what are the key frames, what are the key ideas, what are the key transcript points.\n>\n> — John Lindquist\n\nFifteen minutes is a reasonable default for workshop or walkthrough material. Five minutes can be useful when the screen is dense, the bug is subtle, or the output needs frame-level detail.\n\nDo not turn those numbers into doctrine. **Choose chunk size by evidence density.**\n\nBefore analysis, remove confirmed dead space when it is safe:\n\n- long silence\n- blank screens\n- motionless regions\n- breaks\n- inactive spans\n\nDo not delete chat, links, questions, or setup context that explains the next spoken section. Carry that forward.\n\n## Ask For Screen Evidence\n\nUse the same evidence lanes for each chunk.\n\n```text\nFor this video chunk, extract:\n\nVisual evidence:\n- key frames\n- visible text\n- UI states\n- cursor actions\n- modal/dialog states\n- loading/error/empty states\n- code snippets or terminal output\n- colors, layout shifts, and visual changes\n\nTranscript evidence:\n- key spoken points\n- claims made\n- instructions given\n- unanswered questions\n- deferred follow-ups\n\nAction evidence:\n- user actions\n- app responses\n- navigation steps\n- failed attempts\n- retries\n- omissions or confusing transitions\n\nVerification:\n- what is directly visible\n- what is transcript-supported\n- what is inferred\n- what needs manual review\n```\n\nThis is the difference between \"the user clicked around\" and \"the tooltip text appeared next to the control, then the follow-up prompt asked what it said.\"\n\n## Carry Prior Chunks Forward\n\nChunking solves the density problem and creates a **continuity problem**.\n\nFix that by carrying a compact **previous-summary ledger** into every later prompt:\n\n```text\nYou are analyzing chunk 10 of 15 from a long software workshop.\n\nPrevious chunk summary:\n- Chunk 01 introduced the repo and evidence boundary.\n- Chunk 02 covered agent-ready repo setup.\n- Chunk 03 covered narrow workspace agents.\n- Chunk 04 covered generated variations.\n- Chunk 05 covered visual review before implementation.\n\nFor this chunk:\n- preserve original timestamps\n- extract visible UI states, actions, text, code snippets, and omissions\n- separate transcript evidence, visual evidence, and inference\n- return a chunk summary that can be carried into the next prompt\n```\n\nEvery later chunk should know what came before it: active concepts, unresolved questions, decisions already made, and what the current chunk must not re-explain.\n\n## Use It For Software Work\n\nGood fits:\n\n- QA records a checkout regression and the packet extracts the disabled button state, selected shipping option, console error, and missing validation message.\n- A designer records a settings walkthrough and the packet extracts empty states, modal transitions, keyboard traps, contrast concerns, and confusing copy.\n- A product team records its own onboarding flow and the packet turns it into acceptance criteria.\n- A developer combines a debug marker packet with the video chunk around the marked moment.\n\nProduct research also fits, but keep the ethics boundary clear. Use public walkthroughs for UX critique, accessibility review, flow comparison, and internal design study. Do not present this as a way to copy proprietary UI, assets, copy, CSS, or product behavior.\n\n## Copyable Artifact: Video Evidence Packet\n\n```text\nSource:\n- recording:\n- source hash:\n- original timestamp range:\n- transcript slice:\n- chat slice:\n- chunk id:\n- prior summary included? yes/no\n\nPreprocessing:\n- silence reviewed:\n- motionless/blank spans reviewed:\n- removed spans:\n- carried-forward chat/questions:\n\nAsk the video model to extract:\n- key frames:\n- visible text:\n- transcript points:\n- user actions:\n- UI states:\n- code snippets or terminal output:\n- colors/layout changes:\n- loading/error/empty states:\n- omissions:\n- uncertainties:\n\nCumulative context:\n- previous chunks summarized:\n- unresolved questions:\n- concepts already introduced:\n- what this chunk must not re-explain:\n\nVerification:\n- claims supported by transcript:\n- claims supported by visual evidence:\n- claims supported by chat:\n- claims that are inference only:\n- private details removed:\n- screenshots/keyframes sanitized:\n- model/cost/limit claims removed or verified:\n```\n\nExample prompt:\n\n```text\nAnalyze this checkout bug recording as chunk 03 of 08.\n\nPrevious summary:\n[paste compact prior-summary ledger]\n\nExtract:\n- visible UI states\n- cursor actions\n- selected fields\n- loading/error/empty states\n- visible text\n- transcript claims\n- omitted steps\n- uncertainties\n\nSeparate visual evidence, transcript evidence, chat evidence, and inference.\nReturn a short carry-forward summary for the next chunk.\n```\n\n## Claim Boundaries\n\nThis workflow does not prove model limits, pricing, quota behavior, speed, or model superiority.\n\nIt proves that a recording was processed through a chunked, source-preserving workflow and that shared claims can be checked against transcript, video evidence, key frames, chat, and saved outputs.\n\nBefore sharing screenshots or key frames, sanitize them, copy them into the shared asset tree, add alt text, and review for private browser/account state.\n\n## Related resources\n\n- [Companion reference](https://lapis-fossil-vsbc.here.now/#video-packets)\n- [Resource directory and portable download](/topics/codex-resources/)\n- [Published recording](https://www.dropbox.com/scl/fi/3m5p2dwkx0imuyu0dq5os/GMT20260626-155513_Recording_gallery_1920x1080.mp4?rlkey=60j5649let6pt4fdxpggozv1q&st=qhbuo513&dl=0)"
}
