Private
Public Access
conductor(tracks): scaffold plan.md + metadata.json + state.toml for 12 child + 1 synthesis tracks
This commit is contained in:
@@ -0,0 +1,64 @@
|
||||
{
|
||||
"track_id": "video_analysis_brain_counterintuitive_20260621",
|
||||
"name": "The Most Counterintuitive Way to Build a Brain",
|
||||
"created": "2026-06-21",
|
||||
"status": "spec_approved",
|
||||
"blocked_by": [
|
||||
"video_analysis_campaign_20260621",
|
||||
"video_analysis_free_lunches_levin_20260621"
|
||||
],
|
||||
"blocks": [],
|
||||
"priority": "A",
|
||||
"type": "per-child research track (Pass 1 of 3)",
|
||||
"parent": "video_analysis_campaign_20260621",
|
||||
"domain": "meta-tooling (research artifacts; no manual_slop src/ changes)",
|
||||
"cluster": "C",
|
||||
"youtube_id": "cDxtFtoQVNc",
|
||||
"youtube_url": "https://youtu.be/cDxtFtoQVNc",
|
||||
"author": null,
|
||||
"scope": {
|
||||
"new_files": [
|
||||
"artifacts/transcript.json",
|
||||
"artifacts/ocr.md",
|
||||
"artifacts/frames/*.jpg",
|
||||
"artifacts/extraction_meta.json",
|
||||
"artifacts/video.mp4 (gitignored)",
|
||||
"artifacts/video.log",
|
||||
"report.md (1000-10000 LOC target)",
|
||||
"summary.md (200-400 words)"
|
||||
],
|
||||
"modified_files": [],
|
||||
"deleted_files": []
|
||||
},
|
||||
"estimated_effort": {
|
||||
"method": "scope (per conductor/workflow.md Tier 1 Track Initialization Rules). NO day estimates.",
|
||||
"phase_1": "1 task: acquire (transcript + download)",
|
||||
"phase_2": "1 task: keyframes extraction",
|
||||
"phase_3": "1 task: OCR",
|
||||
"phase_4": "1 task: synthesis (delegate to Tier 3 worker)",
|
||||
"phase_5": "1 task: verification",
|
||||
"summary": "5 tasks per child. 12 children total = 60 tasks in campaign."
|
||||
},
|
||||
"verification_criteria": [
|
||||
"All 7 deliverable artifacts present (transcript.json, video.log, frames/, extraction_meta.json, ocr.md, report.md, summary.md)",
|
||||
"report.md is 1000-10000 LOC markdown",
|
||||
"summary.md is 200-400 words",
|
||||
"All 8 report sections populated (TL;DR, Key Concepts, Frame Analysis, Transcript Highlights, Math/Theoretical Content, Connections, Open Questions, References)",
|
||||
"Idempotency check passes",
|
||||
"Per-task commits with git notes"
|
||||
],
|
||||
"risk_register": [
|
||||
{
|
||||
"id": "R5-brain_counterintuitive",
|
||||
"title": "yt-dlp access failure (oEmbed returned 401 for E-cluster videos)",
|
||||
"likelihood": "low",
|
||||
"scope_impact": "Phase 1 Acquire blocked if yt-dlp also fails",
|
||||
"mitigation": "Phase 1 Step 0 verifies yt-dlp access before downloading. Fall back to manual transcript sourcing if yt-dlp fails."
|
||||
}
|
||||
],
|
||||
"user_directives": [
|
||||
"1000-10000 LOC markdown per video report (per user 2026-06-21)",
|
||||
"Lossless preservation: transcripts (JSON), frames (raw images), OCR (plain text) must be preserved in machine-readable form",
|
||||
"Cross-references: forward + backward to other children in the campaign"
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,60 @@
|
||||
# Plan: video_analysis_brain_counterintuitive_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 *The Most Counterintuitive Way to Build a Brain* and ship `report.md` (1000-10000 LOC) + `summary.md` (200-400 words).
|
||||
|
||||
**Parent:** This is child #8 of the [video_analysis_campaign_20260621](../../video_analysis_campaign_20260621/) umbrella.
|
||||
|
||||
**Source:** https://youtu.be/cDxtFtoQVNc (YouTube ID `cDxtFtoQVNc`)
|
||||
**Cluster:** C (Biological / cognitive / generic systems)
|
||||
**Author:** (unknown)
|
||||
|
||||
---
|
||||
|
||||
## Phase 1: Acquire
|
||||
|
||||
- [ ] **Step 1: Run extract_transcript.py**
|
||||
- `uv run python scripts/video_analysis/extract_transcript.py https://youtu.be/cDxtFtoQVNc 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/cDxtFtoQVNc 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_brain_counterintuitive_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
|
||||
@@ -0,0 +1,36 @@
|
||||
# Track state for video_analysis_brain_counterintuitive_20260621
|
||||
# Updated by Tier 2 Tech Lead (during execution)
|
||||
|
||||
[meta]
|
||||
track_id = "video_analysis_brain_counterintuitive_20260621"
|
||||
name = "The Most Counterintuitive Way to Build a Brain"
|
||||
status = "active"
|
||||
current_phase = 1 # Phase 1 = Acquire (first execution phase)
|
||||
last_updated = "2026-06-21"
|
||||
|
||||
[blocked_by]
|
||||
video_analysis_campaign_20260621 = "shipped"
|
||||
video_analysis_free_lunches_levin_20260621 = "shipped"
|
||||
|
||||
[blocks]
|
||||
# Depends-on: umbrella + cluster-blockers
|
||||
|
||||
[phases]
|
||||
phase_1 = { status = "pending", checkpointsha = "", name = "Acquire (transcript + download)" }
|
||||
phase_2 = { status = "pending", checkpointsha = "", name = "Keyframes extraction" }
|
||||
phase_3 = { status = "pending", checkpointsha = "", name = "OCR" }
|
||||
phase_4 = { status = "pending", checkpointsha = "", name = "Synthesis (Tier 3 worker)" }
|
||||
phase_5 = { status = "pending", checkpointsha = "", name = "Verification" }
|
||||
|
||||
[tasks]
|
||||
t1_1 = { status = "pending", commit_sha = "", description = "Run extract_transcript.py + download_video.py. Commit artifacts atomically." }
|
||||
t2_1 = { status = "pending", commit_sha = "", description = "Run extract_keyframes.py with threshold 0.4. Manual review of frames." }
|
||||
t3_1 = { status = "pending", commit_sha = "", description = "Run ocr_frames.py. Spot-check OCR." }
|
||||
t4_1 = { status = "pending", commit_sha = "", description = "Delegate report.md (1000-10000 LOC) + summary.md (200-400 words) to Tier 3 worker." }
|
||||
t5_1 = { status = "pending", commit_sha = "", description = "Idempotency check + audit + end-of-track report." }
|
||||
|
||||
[verification]
|
||||
all_artifacts_present = false
|
||||
report_loc_target_met = false
|
||||
summary_word_count_met = false
|
||||
end_of_track_report_committed = false
|
||||
Reference in New Issue
Block a user