{
  "schemaVersion": "1",
  "revision": "22ce5d34dbcb5a78",
  "id": "codex-video-workflows-practice",
  "slug": "video-workflows-practice",
  "title": "Video analysis and evidence workflows: practice drills",
  "summary": "Exercises for choosing video input, preserving and hashing source media, recording metadata, constructing analysis prompts and Oracle calls, separating evidence lanes, checking outputs, extracting visual evidence, reviewing omissions, and producing…",
  "category": "Context",
  "tags": [
    "video",
    "oracle",
    "evidence",
    "practice"
  ],
  "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!/exercises/07-video-as-prompts.md",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/exercises/07-video-as-prompts.md#Exercises: 07. Video As Prompts",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/exercises/07-video-as-prompts.md#Exercises: 07. Video As Prompts/Exercise 1: Decide Whether Video Is Useful",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/exercises/07-video-as-prompts.md#Exercises: 07. Video As Prompts/Exercise 2: Create The Run Folder",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/exercises/07-video-as-prompts.md#Exercises: 07. Video As Prompts/Exercise 3: Preserve Source Media",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/exercises/07-video-as-prompts.md#Exercises: 07. Video As Prompts/Exercise 4: Write The Gemini Prompt",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/exercises/07-video-as-prompts.md#Exercises: 07. Video As Prompts/Exercise 5: Check Oracle Call Shape",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/exercises/07-video-as-prompts.md#Exercises: 07. Video As Prompts/Exercise 6: Separate Evidence Lanes",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/exercises/07-video-as-prompts.md#Exercises: 07. Video As Prompts/Exercise 7: Verify The Analysis",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/exercises/07-video-as-prompts.md#Exercises: 07. Video As Prompts/Exercise 8: Extract Keyframes",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/exercises/07-video-as-prompts.md#Exercises: 07. Video As Prompts/Exercise 9: Write An Omissions Pass Prompt",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/exercises/07-video-as-prompts.md#Exercises: 07. Video As Prompts/Exercise 10: Create A Bug Repro Prompt",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/exercises/07-video-as-prompts.md#Exercises: 07. Video As Prompts/Exercise 11: Convert Video Evidence Into A Section 6 Matrix",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/exercises/07-video-as-prompts.md#Exercises: 07. Video As Prompts/Exercise 12: Section 8 Bridge",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/exercises/07-video-as-prompts.md#Exercises: 07. Video As Prompts/Final Check",
    "downloads/codex-power-user-workshop-2026-06-27.bundle"
  ],
  "collection": "codex",
  "categoryId": "context",
  "wordCount": 1262,
  "url": "/topics/codex-video-workflows-practice/",
  "markdownUrl": "/markdown/codex-video-workflows-practice.md?raw=1&v=22ce5d34dbcb5a78",
  "jsonUrl": "/api/v1/documents/codex-video-workflows-practice.json",
  "headings": [
    {
      "id": "exercise-1-decide-whether-video-is-useful",
      "text": "Exercise 1: Decide Whether Video Is Useful",
      "level": 2
    },
    {
      "id": "exercise-2-create-the-run-folder",
      "text": "Exercise 2: Create The Run Folder",
      "level": 2
    },
    {
      "id": "exercise-3-preserve-source-media",
      "text": "Exercise 3: Preserve Source Media",
      "level": 2
    },
    {
      "id": "exercise-4-write-the-gemini-prompt",
      "text": "Exercise 4: Write The Gemini Prompt",
      "level": 2
    },
    {
      "id": "exercise-5-check-oracle-call-shape",
      "text": "Exercise 5: Check Oracle Call Shape",
      "level": 2
    },
    {
      "id": "exercise-6-separate-evidence-lanes",
      "text": "Exercise 6: Separate Evidence Lanes",
      "level": 2
    },
    {
      "id": "exercise-7-verify-the-analysis",
      "text": "Exercise 7: Verify The Analysis",
      "level": 2
    },
    {
      "id": "exercise-8-extract-keyframes",
      "text": "Exercise 8: Extract Keyframes",
      "level": 2
    },
    {
      "id": "exercise-9-write-an-omissions-pass-prompt",
      "text": "Exercise 9: Write An Omissions Pass Prompt",
      "level": 2
    },
    {
      "id": "exercise-10-create-a-bug-repro-prompt",
      "text": "Exercise 10: Create A Bug Repro Prompt",
      "level": 2
    },
    {
      "id": "exercise-11-convert-video-evidence-into-a-section-6-matrix",
      "text": "Exercise 11: Convert Video Evidence Into A Section 6 Matrix",
      "level": 2
    },
    {
      "id": "exercise-12-section-8-bridge",
      "text": "Exercise 12: Section 8 Bridge",
      "level": 2
    },
    {
      "id": "final-check",
      "text": "Final Check",
      "level": 2
    },
    {
      "id": "related-resources",
      "text": "Related resources",
      "level": 2
    }
  ],
  "markdown": "# Video analysis and evidence workflows: practice drills\n\nThese exercises practice turning video into verified prompt material.\n\nUse a short clip when possible. A 30-90 second bug reproduction or design feedback clip is enough.\n\n## Exercise 1: Decide Whether Video Is Useful\n\nChoose `video`, `text/log`, or `code context`.\n\n| Scenario | Best Input | Why |\n| --- | --- | --- |\n| checkout button disappears after a sequence of clicks | | |\n| unit test failure points to one function | | |\n| designer explains spacing problems while moving through UI | | |\n| terminal command prints one clear stack trace | | |\n| app feels slow after refresh but logs are clean | | |\n| long tutorial should become exercises and references | | |\n| auth/session architecture needs cross-file review | | |\n\nFill out:\n\n```markdown\n# Input Choice\n\n- scenario:\n- chosen input:\n- why:\n- what video would add:\n- what text/logs would add:\n- what code context would add:\n```\n\n## Exercise 2: Create The Run Folder\n\nRun:\n\n```bash\nRUN_ID=\"exercise-video-$(date +%Y%m%d-%H%M%S)\"\nRUN_DIR=\"runs/$RUN_ID\"\nmkdir -p \"$RUN_DIR\"/{inputs,receipts,analysis,final,keyframes,contact-sheets}\nmkdir -p \"$RUN_DIR/chunks/01\"\nfind \"$RUN_DIR\" -maxdepth 3 -type d | sort\n```\n\nFill out:\n\n```markdown\n# Video Run Folder\n\n- run id:\n- run dir:\n- inputs:\n- receipts:\n- chunks:\n- analysis:\n- final:\n- keyframes:\n```\n\n## Exercise 3: Preserve Source Media\n\nFor a local video:\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\nFor a URL:\n\n```bash\nyt-dlp --dump-single-json --skip-download --no-check-formats \"$URL\" \\\n  > \"$RUN_DIR/receipts/source.metadata.json\"\nyt-dlp -f \"bv*+ba/best\" -o \"$RUN_DIR/inputs/source-video.%(ext)s\" \"$URL\"\n```\n\nConfirm:\n\n```bash\ntest -s \"$RUN_DIR/inputs/source-video.sha256\" && echo \"sha256:OK\"\ntest -s \"$RUN_DIR/receipts/ffprobe.source.json\" && echo \"ffprobe:OK\"\n```\n\nFill out:\n\n```markdown\n# Source Media Notes\n\n- source path or URL:\n- local video path:\n- sha256 path:\n- ffprobe path:\n- original duration:\n- original timestamps preserved? yes/no\n```\n\n## Exercise 4: Write The Gemini Prompt\n\nRun:\n\n```bash\ncat > \"$RUN_DIR/chunks/01/gemini-prompt.md\" <<'EOF'\nAnalyze this video as prompt material for a software project.\n\nReturn:\n\n1. short summary\n2. timestamped workflow\n3. transcript evidence\n4. chat evidence\n5. visual evidence\n6. inferences, clearly labeled\n7. likely downstream artifacts\n8. omissions or uncertainty\n\nRules:\n\n- Do not invent URLs, tools, commands, files, UI labels, or speakers.\n- Preserve original timestamps.\n- Separate visible facts from spoken claims and inferences.\n- Include the exact sentinel below as the last line.\n\nEND_OF_VIDEO_ANALYSIS\nEOF\n\nprintf 'END_OF_VIDEO_ANALYSIS\\n' \\\n  > \"$RUN_DIR/chunks/01/expected-sentinel.txt\"\n\nrg -n \"END_OF_VIDEO_ANALYSIS\" \"$RUN_DIR/chunks/01/gemini-prompt.md\"\n```\n\nFill out:\n\n```markdown\n# Gemini Prompt Notes\n\n- prompt path:\n- sentinel:\n- required lanes:\n- forbidden inventions:\n- timestamp rule:\n- uncertainty rule:\n```\n\n## Exercise 5: Check Oracle Call Shape\n\nWrite the call shape with an absolute video path.\n\n```js\nmcp__oracle__consult({\n  prompt: \"[exercise-video-analysis]\\n\\n{contents of chunks/01/gemini-prompt.md}\",\n  files: [\"/absolute/path/to/runs/<run-id>/chunks/01/chunk.mp4\"],\n  engine: \"browser\",\n  model: \"gemini-3-pro\",\n  browserAttachments: \"always\",\n  slug: \"exercise-video-analysis\"\n})\n```\n\nFill out:\n\n```markdown\n# Oracle Video Call Shape\n\n- engine:\n- model:\n- browserAttachments:\n- file path absolute? yes/no\n- slug:\n- why API mode is wrong:\n```\n\n## Exercise 6: Separate Evidence Lanes\n\nUse a video analysis result or a short mock result. Fill the lanes separately.\n\n```markdown\n# Evidence Lanes\n\n## Transcript Evidence\n\n- timestamp:\n- quote or paraphrase:\n\n## Chat Evidence\n\n- timestamp:\n- message:\n\n## Visual Evidence\n\n- timestamp:\n- visible fact:\n- keyframe:\n\n## Inference\n\n- inference:\n- based on:\n- confidence:\n- what would confirm it:\n```\n\nQuestion:\n\n```text\nWhich claims are visible facts, and which are only spoken claims or inferences?\n```\n\n## Exercise 7: Verify The Analysis\n\nRun checks against the saved files.\n\n```bash\ntest -s \"$RUN_DIR/inputs/source-video.sha256\" && echo \"source-hash:OK\"\ntest -s \"$RUN_DIR/receipts/ffprobe.source.json\" && echo \"ffprobe:OK\"\ntest -s \"$RUN_DIR/chunks/01/gemini-prompt.md\" && echo \"prompt:OK\"\ntest -s \"$RUN_DIR/chunks/01/expected-sentinel.txt\" && echo \"sentinel-file:OK\"\n```\n\nIf Oracle output exists:\n\n```bash\nrg -n \"END_OF_VIDEO_ANALYSIS\" ~/.oracle/sessions/<slug>/output.log\n```\n\nFill out:\n\n```markdown\n# Analysis Verification\n\n- source hash exists? yes/no\n- ffprobe exists? yes/no\n- prompt exists? yes/no\n- sentinel required? yes/no\n- sentinel found in output? yes/no\n- timestamps preserved? yes/no\n- unsupported URLs/tools/commands removed? yes/no\n- visual claims have keyframes? yes/no\n```\n\n## Exercise 8: Extract Keyframes\n\nRun:\n\n```bash\nmkdir -p \"$RUN_DIR/keyframes\"\nffmpeg -i \"$RUN_DIR/inputs/source-video.mp4\" \\\n  -vf \"fps=1/10\" \\\n  \"$RUN_DIR/keyframes/frame-%04d.jpg\"\nfind \"$RUN_DIR/keyframes\" -type f | head\n```\n\nOptional contact sheet:\n\n```bash\nffmpeg -pattern_type glob -i \"$RUN_DIR/keyframes/*.jpg\" \\\n  -vf \"scale=320:-1,tile=4x4\" \\\n  \"$RUN_DIR/contact-sheets/source-contact-sheet.jpg\"\n```\n\nFill out:\n\n```markdown\n# Keyframe Notes\n\n- keyframe folder:\n- contact sheet:\n- visual claim checked:\n- timestamp:\n- confirmed? yes/no\n```\n\n## Exercise 9: Write An Omissions Pass Prompt\n\nRun:\n\n```bash\ncat > \"$RUN_DIR/analysis/omissions-prompt.md\" <<'EOF'\nReview the prior video analysis for omissions.\n\nFocus only on missing visible UI states, skipped timestamps, unsupported claims,\ninvented details, and uncertainty. Do not rewrite the whole analysis. Return a\npatch-style list of corrections and end with END_OF_VIDEO_ANALYSIS.\nEOF\n```\n\nFill out:\n\n```markdown\n# Omissions Pass\n\n- why an omissions pass is needed:\n- missing visual state:\n- missing timestamp:\n- unsupported claim:\n- uncertainty:\n- expected correction:\n```\n\n## Exercise 10: Create A Bug Repro Prompt\n\nWrite:\n\n```markdown\n# Implementation Prompt From Video\n\n## Source\n\n- video:\n- source hash:\n- ffprobe:\n- analysis:\n- keyframes:\n\n## Observed Failure\n\n- timestamp:\n- visual evidence:\n- transcript/chat evidence:\n- expected behavior:\n- actual behavior:\n\n## Request\n\nImplement the smallest safe fix.\n\n## Constraints\n\n- do not change:\n- preserve:\n\n## Verification\n\n- command:\n- what passing means:\n```\n\nConfirm:\n\n```bash\ntest -s \"$RUN_DIR/final/implementation-prompt.md\" && echo \"implementation-prompt:OK\"\n```\n\n## Exercise 11: Convert Video Evidence Into A Section 6 Matrix\n\nPick one variable from the video-derived work.\n\n```markdown\n# Video-Derived Variation Matrix\n\n## Goal\n\n## Evidence From Video\n\n- timestamp:\n- observation:\n- keyframe:\n- why it matters:\n\n## Invariants\n\n- same repo state:\n- same source evidence:\n- same target flow:\n- same verification command:\n- same review criteria:\n\n## Variable Under Test\n\n- variable:\n- why this variable matters:\n- what is out of scope:\n\n## Candidates\n\n| ID | Variable setting | Output location | Verification command |\n| --- | --- | --- | --- |\n| v1 | | | |\n| v2 | | | |\n| v3 | | | |\n```\n\n## Exercise 12: Section 8 Bridge\n\nWrite a marker that carries the evidence discipline forward.\n\n```bash\nmkdir -p \"$RUN_DIR/final\"\ncat > \"$RUN_DIR/final/section8-bridge-agent-marker.md\" <<'EOF'\n# Agent Marker Bridge\n\n- previous section: Section 7\n- evidence type: video prompt material\n- source hash:\n- ffprobe:\n- analysis:\n- output.log:\n- sentinel:\n- visual evidence:\n- uncertainty:\n- next marker:\n- Section 8 target: Debugging with Agent Markers\nEOF\n\ntest -s \"$RUN_DIR/final/section8-bridge-agent-marker.md\" \\\n  && echo \"agent-marker-bridge:OK\"\n```\n\nFill out:\n\n```markdown\n# Section 8 Bridge Notes\n\n- what evidence was preserved:\n- what uncertainty remains:\n- what marker should the debugging agent leave next:\n- what would be lost without the marker:\n```\n\n## Final Check\n\nRun:\n\n```bash\ntest -s \"$RUN_DIR/inputs/source-video.sha256\" && echo \"sha256:OK\"\ntest -s \"$RUN_DIR/receipts/ffprobe.source.json\" && echo \"ffprobe:OK\"\ntest -s \"$RUN_DIR/chunks/01/gemini-prompt.md\" && echo \"prompt:OK\"\ntest -s \"$RUN_DIR/chunks/01/expected-sentinel.txt\" && echo \"sentinel:OK\"\nfind \"$RUN_DIR/final\" -type f | sort\n```\n\nFill out:\n\n```markdown\n# Final Video Prompt Run Check\n\n- source preserved? yes/no\n- source hash saved? yes/no\n- ffprobe saved? yes/no\n- original timestamps preserved? yes/no\n- prompt saved? yes/no\n- Oracle call shape correct? yes/no\n- output.log checked? yes/no\n- sentinel verified? yes/no\n- evidence lanes separated? yes/no\n- keyframes/contact sheet saved? yes/no\n- unsupported claims removed? yes/no\n- omissions pass considered? yes/no\n- downstream artifact saved? yes/no\n- ready to use as prompt material? yes/no\n```\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/)"
}
