# Plan: video_analysis_platonic_intelligence_kumar_20260621

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox syntax for tracking.

**Goal:** Execute the 5-phase pipeline (Acquire → Keyframes → OCR → Synthesis → Verification) for *Towards a Platonic Intelligence with Unified Factored Representations* and ship `report.md` (1000-10000 LOC) + `summary.md` (200-400 words).

**Parent:** This is child #5 of the [video_analysis_campaign_20260621](../../video_analysis_campaign_20260621/) umbrella.

**Source:** https://youtu.be/1mXUFweWOug (YouTube ID `1mXUFweWOug`)
**Cluster:** B (Platonic / geometric AI representations)
**Author:** Akarsh Kumar

---

## Phase 1: Acquire

- [ ] **Step 1: Run extract_transcript.py**
 - `uv run python scripts/video_analysis/extract_transcript.py https://youtu.be/1mXUFweWOug artifacts/transcript.json`
 - Commit `artifacts/transcript.json` atomically.
- [ ] **Step 2: Run download_video.py**
 - `uv run python scripts/video_analysis/download_video.py https://youtu.be/1mXUFweWOug artifacts/video.mp4`
 - Commit `artifacts/video.mp4` (gitignored) + `artifacts/video.log` atomically.

## Phase 2: Keyframes

- [ ] **Step 1: Run extract_keyframes.py**
 - `uv run python scripts/video_analysis/extract_keyframes.py artifacts/video.mp4 artifacts/frames --threshold 0.4`
 - Commit `artifacts/frames/*.jpg` + `artifacts/extraction_meta.json` atomically.
- [ ] **Step 2: Manual review** — flag any frames that look wrong.

## Phase 3: OCR

- [ ] **Step 1: Run ocr_frames.py**
 - `uv run python scripts/video_analysis/ocr_frames.py artifacts/frames artifacts/ocr.md --backend winsdk`
 - Commit `artifacts/ocr.md` atomically.
- [ ] **Step 2: Spot-check OCR quality.**

## Phase 4: Synthesis (DELEGATE TO TIER 3 WORKER)

- [ ] **Step 1: Delegate report writing**
 - Inputs: `artifacts/transcript.json` + `artifacts/ocr.md` + `artifacts/frames/*.jpg`
 - Output: `report.md` (1000-10000 LOC) + `summary.md` (200-400 words)
 - 8-section structure per umbrella spec §FR6
 - Cross-references to other children (forward + backward)
- [ ] **Step 2: Human review + iterate**

## Phase 5: Verification

- [ ] **Step 1: Idempotency check** — re-run scripts, confirm outputs match modulo timestamps
- [ ] **Step 2: Audit checklist** — every section of `report.md` populated, no "TBD"
- [ ] **Step 3: Write end-of-track report** at `docs/reports/TRACK_COMPLETION_video_analysis_platonic_intelligence_kumar_20260621.md`
- [ ] **Step 4: Update state.toml** to `status = "completed"`

## Self-review

- [ ] `report.md` is 1000-10000 LOC markdown
- [ ] `summary.md` is 200-400 words
- [ ] All 7 deliverable artifacts present
- [ ] All 8 report sections populated
- [ ] Per-task commits with git notes
