{
  "schemaVersion": "1",
  "revision": "22ce5d34dbcb5a78",
  "id": "codex-video-workflows-team-guide",
  "slug": "video-workflows-team-guide",
  "title": "Video analysis and evidence workflows: team walkthrough",
  "summary": "Evidence-preserving video analysis workflow: preserve and hash media, inspect with ffprobe, prompt Gemini through Oracle browser mode, check session output, separate evidence lanes, and produce downstream prompts, requirements, bugs, QA, or variation…",
  "category": "Team practice",
  "tags": [
    "video",
    "oracle",
    "evidence",
    "team-guide"
  ],
  "sources": [
    {
      "label": "Portable Codex workflow resources",
      "url": "https://lapis-fossil-vsbc.here.now/downloads/codex-power-user-workshop-2026-06-27.bundle"
    }
  ],
  "sourceUnits": [
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Presenter Goal",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Timing Options",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Timing Options/10-Minute Version",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Timing Options/20-Minute Version",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Timing Options/35-Minute Version",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Things To Say",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Live Demo Script",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Live Demo Script/1. Create Run Folder",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Live Demo Script/2. Preserve Source",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Live Demo Script/3. Write Prompt With Sentinel",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Live Demo Script/4. Show Correct Call Shape",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Live Demo Script/5. Verify Output",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Live Demo Script/6. Bridge To Downstream Work",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Cut Path",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Boundaries",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Boundaries/From Section 6",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Boundaries/To Section 8",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Failure Paths To Preserve",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Presenter Checklist",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/07-video-as-prompts.md#Instructor Notes: 07. Video As Prompts/Presenter References",
    "downloads/codex-power-user-workshop-2026-06-27.bundle"
  ],
  "collection": "codex",
  "categoryId": "team-practice",
  "wordCount": 780,
  "url": "/topics/codex-video-workflows-team-guide/",
  "markdownUrl": "/markdown/codex-video-workflows-team-guide.md?raw=1&v=22ce5d34dbcb5a78",
  "jsonUrl": "/api/v1/documents/codex-video-workflows-team-guide.json",
  "headings": [
    {
      "id": "team-learning-goal",
      "text": "Team Learning Goal",
      "level": 2
    },
    {
      "id": "walkthrough-depth",
      "text": "Walkthrough Depth",
      "level": 2
    },
    {
      "id": "essential-walkthrough",
      "text": "Essential Walkthrough",
      "level": 3
    },
    {
      "id": "expanded-walkthrough",
      "text": "Expanded Walkthrough",
      "level": 3
    },
    {
      "id": "deep-dive-walkthrough",
      "text": "Deep-Dive Walkthrough",
      "level": 3
    },
    {
      "id": "talking-points",
      "text": "Talking Points",
      "level": 2
    },
    {
      "id": "live-demo-script",
      "text": "Live Demo Script",
      "level": 2
    },
    {
      "id": "1-create-run-folder",
      "text": "1. Create Run Folder",
      "level": 3
    },
    {
      "id": "2-preserve-source",
      "text": "2. Preserve Source",
      "level": 3
    },
    {
      "id": "3-write-prompt-with-sentinel",
      "text": "3. Write Prompt With Sentinel",
      "level": 3
    },
    {
      "id": "4-show-correct-call-shape",
      "text": "4. Show Correct Call Shape",
      "level": 3
    },
    {
      "id": "5-verify-output",
      "text": "5. Verify Output",
      "level": 3
    },
    {
      "id": "6-bridge-to-downstream-work",
      "text": "6. Bridge To Downstream Work",
      "level": 3
    },
    {
      "id": "minimal-useful-path",
      "text": "Minimal Useful Path",
      "level": 2
    },
    {
      "id": "boundaries",
      "text": "Boundaries",
      "level": 2
    },
    {
      "id": "from-section-6",
      "text": "From Section 6",
      "level": 3
    },
    {
      "id": "to-section-8",
      "text": "To Section 8",
      "level": 3
    },
    {
      "id": "failure-paths-to-preserve",
      "text": "Failure Paths To Preserve",
      "level": 2
    },
    {
      "id": "team-checklist",
      "text": "Team Checklist",
      "level": 2
    },
    {
      "id": "further-references",
      "text": "Further References",
      "level": 2
    },
    {
      "id": "related-resources",
      "text": "Related resources",
      "level": 2
    }
  ],
  "markdown": "# Video analysis and evidence workflows: team walkthrough\n\n## Team Learning Goal\n\nTeach video as evidence-rich prompt material, not as a novelty or transcript shortcut.\n\nBy the end of this section, the room should understand:\n\n- why video can carry context text drops\n- when video is worth the overhead\n- how `oracle-video` relates to `oracle-packx`\n- why Gemini browser mode is required for video\n- how source hashes, `ffprobe`, timestamps, keyframes, and `output.log` make analysis checkable\n- why transcript, chat, visual evidence, and inference must stay separate\n- how verified video analysis becomes prompts, bugs, requirements, QA, lessons, or Section 6 variation matrices\n\n## Walkthrough Depth\n\n### Essential Walkthrough\n\n1. Say: video is prompt material.\n2. Show the short path vs long path table.\n3. Show the correct Oracle/Gemini call shape.\n4. Show `shasum`, `ffprobe`, and `END_OF_VIDEO_ANALYSIS`.\n5. Show evidence lanes.\n6. End with downstream prompt examples.\n\n### Expanded Walkthrough\n\nAdd:\n\n- run folder shape\n- `yt-dlp` metadata/download flow\n- keyframes/contact sheet\n- omissions pass\n- bug repro prompt shape\n\n### Deep-Dive Walkthrough\n\nAdd:\n\n- chunking long recordings\n- requirements artifact\n- Section 6 variation matrix from video evidence\n- exercises\n\n## Talking Points\n\nOpening:\n\n> Video is prompt material.\n\nOn transcripts:\n\n> A transcript tells you what was said. It does not prove what was visible.\n\nOn evidence lanes:\n\n> Spoken claims, visible facts, chat messages, and inferences do different jobs. Keep them separate.\n\nOn Gemini:\n\n> Text models do not watch the video. The video-watching step belongs to Gemini through Oracle browser mode.\n\nOn source preservation:\n\n> If the original media is not preserved, every later claim gets harder to trust.\n\nOn Section 8:\n\n> Section 7 preserves evidence from video. Section 8 puts that same discipline inside live debugging with markers.\n\n## Live Demo Script\n\n### 1. Create Run Folder\n\n```bash\nRUN_ID=\"checkout-repro\"\nRUN_DIR=\"runs/$RUN_ID\"\nmkdir -p \"$RUN_DIR\"/{inputs,receipts,analysis,final,keyframes,contact-sheets}\nmkdir -p \"$RUN_DIR/chunks/01\"\n```\n\n### 2. Preserve Source\n\n```bash\ncp /path/to/source-video.mp4 \"$RUN_DIR/inputs/source-video.mp4\"\nshasum -a 256 \"$RUN_DIR/inputs/source-video.mp4\" \\\n  > \"$RUN_DIR/inputs/source-video.sha256\"\nffprobe -hide_banner -show_format -show_streams -of json \\\n  \"$RUN_DIR/inputs/source-video.mp4\" \\\n  > \"$RUN_DIR/receipts/ffprobe.source.json\"\n```\n\n### 3. Write Prompt With Sentinel\n\n```bash\ncat > \"$RUN_DIR/chunks/01/gemini-prompt.md\" <<'EOF'\nAnalyze this video as prompt material for a software project.\n\nSeparate transcript evidence, chat evidence, visual evidence, and inference.\nPreserve timestamps.\nDo not invent URLs, tools, commands, files, UI labels, or speakers.\nEnd with END_OF_VIDEO_ANALYSIS.\n\nEND_OF_VIDEO_ANALYSIS\nEOF\n```\n\n### 4. Show Correct Call Shape\n\n```js\nmcp__oracle__consult({\n  prompt: \"[checkout-repro-video]\\n\\n{contents of chunks/01/gemini-prompt.md}\",\n  files: [\"/absolute/path/to/runs/checkout-repro/chunks/01/chunk.mp4\"],\n  engine: \"browser\",\n  model: \"gemini-3-pro\",\n  browserAttachments: \"always\",\n  slug: \"checkout-repro-video\"\n})\n```\n\n### 5. Verify Output\n\n```bash\nrg -n \"END_OF_VIDEO_ANALYSIS\" ~/.oracle/sessions/checkout-repro-video/output.log\n```\n\n### 6. Bridge To Downstream Work\n\nShow one of:\n\n- repro steps\n- implementation prompt\n- design-change brief\n- QA checklist\n- Section 6 variation matrix\n\n## Minimal Useful Path\n\nIf 5 minutes behind, cut:\n\n- `yt-dlp`\n- contact sheet command\n- long recording folder details\n- omissions pass prompt\n\nPreserve:\n\n- video is prompt material\n- Gemini browser mode\n- `browserAttachments: \"always\"`\n- source hash\n- `ffprobe`\n- evidence lanes\n- sentinel\n- downstream prompt\n\nIf 15 minutes behind, run only:\n\n```text\nsource -> hash -> ffprobe -> Gemini browser mode -> evidence lanes -> verified downstream prompt\n```\n\n## Boundaries\n\n### From Section 6\n\nSection 6 teaches:\n\n```text\none deliberate prompt -> controlled variations\n```\n\nSection 7 expands what can become prompt material:\n\n```text\nvideo -> verified evidence -> downstream prompt or variation matrix\n```\n\n### To Section 8\n\nSection 8 moves the same discipline into live debugging:\n\n```text\nmark -> capture -> explain -> review/export\n```\n\n## Failure Paths To Preserve\n\nWrong Oracle mode:\n\n> If video analysis used API mode, rerun in browser mode.\n\nTranscript-only summary:\n\n> Ask for visual evidence and an omissions pass. Do not treat transcript as full analysis.\n\nInvented URL/tool/file:\n\n> Remove it or label it as inference. Unsupported details cannot become requirements.\n\nNo sentinel:\n\n> Inspect `output.log`. If the sentinel is missing, rerun or request a focused correction.\n\nNo source hash:\n\n> Stop and preserve the source before continuing.\n\nLong recording not chunked:\n\n> Segment/chunk before asking for a full packet.\n\n## Team Checklist\n\nConfirm the materials include:\n\n```text\nvideo is prompt material\noracle-video\nGemini\nengine: \"browser\"\nmodel: \"gemini-3-pro\"\nbrowserAttachments: \"always\"\nabsolute file paths\nyt-dlp\nffprobe\nsha256\nsource hash\noriginal timestamps\nEND_OF_VIDEO_ANALYSIS\noutput.log\nkeyframes\ncontact sheets\ntranscript evidence\nchat evidence\nvisual evidence\ninference\nomissions pass\nno invented URLs/tools/commands/files\nbug reproduction\ndesign feedback\napp walkthrough\nrequirements\nQA checklist\nimplementation prompt\nSection 6 variation matrix\nSection 8 agent markers bridge\n```\n\n## Further References\n\n- team-facing file: `cheatsheets/07-video-as-prompts.md`\n- Exercises: `exercises/07-video-as-prompts.md`\n- `oracle-video` skill reference: `.agents/skills/oracle-video/SKILL.md`\n- `yt-dlp`: https://github.com/yt-dlp/yt-dlp\n- FFmpeg documentation: https://ffmpeg.org/documentation.html\n- `ffprobe` documentation: https://ffmpeg.org/ffprobe.html\n\n## Related resources\n\n- [Companion reference](https://lapis-fossil-vsbc.here.now/downloads/codex-power-user-workshop-2026-06-27.bundle)\n- [Resource directory and portable download](/topics/codex-resources/)"
}
