@amg555/frameforge-mcp 2.7.6 → 2.7.8

package/.agent/skills/video-pipeline/SKILL.md

@@ -1,384 +0,0 @@
----
-name: video-pipeline
-description: >
-  Autonomous AI video production pipeline. Given a topic, this skill
-  researches, fact-checks, writes the script, synthesises voice, renders
-  with FFmpeg, runs quality gates, and saves the output locally or POSTs
-  to any webhook — all without human intervention.
-  Works in IBM Bob, Codex, opencode, Cursor, Windsurf, Claude Code,
-  or any IDE that loads skills from ~/.claude/skills/ or .claude/skills/.
-  Trigger phrases: "make a video about", "produce a reel on", "overnight
-  batch", "queue videos", "generate video", "run the pipeline", "publish
-  video". Also activates when a user pastes a topic list and says
-  "make these" or "do the batch".
----
-
-# Video Pipeline Skill
-
-End-to-end autonomous video production. The AI proposes every creative
-decision; deterministic systems (FFmpeg, TTS, image gen, MCP) execute them;
-a quality gate blocks bad output before delivery.
-
-## Architecture
-
-```
-IDE Agent (IBM Bob / Codex / opencode / Cursor / Windsurf / Claude Code)
-    │
-    ▼  Cloudflare Remote MCP (recommended) ─────────────────────────────
-    │  https://video-mcp.YOUR_SUBDOMAIN.workers.dev/mcp
-    │  28 tools: create_video_from_script · edit_video · render_from_scenes
-    │            generate_scene_code · preview_scene · verify_scene_quality
-    │            ingest_media · edit_scenes · render_tts · multi_voice_tts
-    │            generate_scene_image · assemble_video · publish_video
-    │            research_topic · write_script · external_platform_call
-    │            queue_full_pipeline · get_job_status · export_to_editor
-    │            scaffold_animation_project · validate_storyboard · render_animation
-    │            plan_video_edit · sync_upstream_skills · check_upstream_updates
-    │            transcribe_media · ingest_url · mix_audio_pro
-    │
-    ▼  OR — Local stdio / HTTP MCP ────────────────────────────────────
-    │  node src/mcp-server/stdio.js   (stdio)
-    │  node src/mcp-server/server.js  (HTTP :3210)
-    │
-    ▼  Execution layer
-    │  LLM provider:   PROVIDER_LLM=groq|openrouter|anthropic|gemini
-    │                              |mistral|together|cerebras|openai
-    │                              |ollama|webhook
-    │  TTS provider:   PROVIDER_TTS=edge-tts|voxforge|elevenlabs|azure|openai|webhook
-    │  Visuals:        Code-driven animations (default) + user media (video_path / image_path)
-    │
-    ▼  Optional: queue_full_pipeline
-       queue_full_pipeline MCP tool → POST job to worker API (WORKER_API_URL)
-```
-
-All secrets come from environment variables — **never** hardcoded.
-See `docs/env.template` for the full reference.
-
----
-
-## Setup
-
-### Option A — Cloudflare Remote MCP (Recommended)
-
-Deploy once; works in every IDE with no local server process:
-
-```bash
-cd cloudflare-mcp
-npm install
-wrangler secret put WORKER_API_URL     # https://your-render-app.onrender.com
-wrangler secret put MCP_AUTH_TOKEN     # random 32-byte hex
-wrangler secret put INTERNAL_API_TOKEN # shared secret with render node
-wrangler deploy
-```
-
-Add to any IDE's MCP config:
-
-```json
-{
-  "mcpServers": {
-    "frameforge": {
-      "url": "https://video-mcp.YOUR_SUBDOMAIN.workers.dev/mcp",
-      "headers": { "Authorization": "Bearer YOUR_MCP_AUTH_TOKEN" }
-    }
-  }
-}
-```
-
-### Option B — Local stdio MCP
-
-**IBM Bob** (`~/.bob/mcp.json`):
-```json
-{
-  "mcpServers": {
-    "frameforge": {
-      "command": "node",
-      "args": ["<absolute-path>/src/mcp-server/stdio.js"],
-      "env": { "PROVIDER_LLM": "groq", "GROQ_API_KEY": "gsk_..." }
-    }
-  }
-}
-```
-
-**Codex / opencode / Cursor / Windsurf / Claude Code** (`~/.claude/mcp.json` or `.mcp.json`):
-```json
-{
-  "mcpServers": {
-    "frameforge": {
-      "command": "node",
-      "args": ["<absolute-path>/src/mcp-server/stdio.js"],
-      "env": { "PROVIDER_LLM": "groq", "GROQ_API_KEY": "${GROQ_API_KEY}" }
-    }
-  }
-}
-```
-
-### 2. Set environment variables
-
-Copy `docs/env.template` → `.env` and fill in. Minimum:
-
-```bash
-# LLM (pick one — Groq is free with no credit card)
-PROVIDER_LLM=groq
-GROQ_API_KEY=gsk_...
-
-# TTS (edge-tts is free offline)
-PROVIDER_TTS=edge-tts
-
-# Visuals are 100% code-driven (kinetic typography/motion graphics) + user media. No image key needed.
-
-# Delivery (optional — default is 'file' which copies to N8N_FILES_DIR/published/)
-# PUBLISH_WEBHOOK_URL=https://hooks.example.com/frameforge
-# REVIEW_NOTIFY_URL=https://hooks.example.com/review-gate
-```
-
-Run the interactive wizard for guided setup:
-```bash
-npm run setup
-```
-
----
-
-## Workflow (step-by-step)
-
-### Path 1 — Agent-First (Code-Driven Motion Graphics or Direct Custom Code)
-
-**You are already running an LLM (Claude Code / Opus 5.5 / Cursor / Bob) — use it.**
-Write the scenes yourself and hand them to FrameForge for rendering. No external API key needed.
-FrameForge renders full-canvas, broadcast-quality motion graphics (24fps pure function of `t`) with zero slideshow/card patterns:
-
-- **Option A — Natural Description:** Provide `visual_description` (e.g. "Earth rotating with 4 satellite orbits and microwave beams intersecting"). FrameForge automatically synthesizes a full-canvas procedural 3D/2D animation entity (orbital mechanics, 3D DNA helix, candlestick charts, neural mesh, 3D wireframe polyhedra).
-- **Option B — Direct Agent Code:** Provide `html` (complete page with `window.DURATION` & `window.seek(t)`) or `code` (canvas drawing instructions for `t`). FrameForge executes your program directly via headless Chromium.
-- **Option C — Generate & Inspect (Layer 3 Loop):** Call `generate_scene_code({ visual_description, style })` to synthesize canvas drawing code. Then call `preview_scene({ html, timestamps: [0.1, 1.5, 2.9] })` to render PNG stills to disk, visually verify the scene in the IDE, tweak if needed, and pass into `create_video_from_script`.
-- **Option D — Multilingual & Regional Scripts:** Pass `language: "ml"` (Malayalam), `"hi"` (Hindi), etc. Native DirectWrite/HarfBuzz font stacks (`Nirmala UI`, `Noto Sans Malayalam`) render conjuncts without broken glyphs.
-
-```js
-create_video_from_script({
-  topic: "GPS Satellites and Orbital Mechanics",
-  style: "cosmic_space",
-  language: "en",
-  scenes: [
-    {
-      narration: "GPS uses trilateration from atomic clock satellites orbiting Earth.",
-      caption: "TRILATERATION",
-      visual_description: "3D Earth rotating with 4 satellite orbits and microwave beams converging",
-      // Optional: you can pass your own Canvas code or complete HTML:
-      // code: "ctx.fillStyle = '#0c1116'; ctx.fillRect(0,0,W,H); ..."
-    },
-    {
-      narration: "Relativistic time dilation requires nanosecond daily corrections.",
-      caption: "TIME DILATION",
-      visual_description: "Quantum atomic clock oscillation with compounding nanosecond curve"
-    }
-  ],
-  title: "How GPS Actually Works"
-})
-```
-
-Then deliver it:
-```
-publish_video({ productionId, masterPath, channels: ["file"] })
-```
-
-### Path 2 — Code-Driven Animated Video (Playwright + ffmpeg, no AI images)
-
-Use when: the user wants Remotion-style motion graphics, image gen is unavailable, or they ask for "animated video" or "make it look good". Every pixel is a pure function of time `t`.
-
-> **Model effort (Opus 5.5 / Claude Code):**
-> - Beat sheet + first scene authorship → `effort: xhigh`
-> - Storyboard review, strip-range patches, encode-only runs → `effort: medium`
-> - `tool_choice` must be `auto` (forced tool use not supported in Opus 5.5)
-
-> **Beat sheet gate:** Reply with a beat sheet and 4 keyframe descriptions first. Stop. Wait for approval before writing any scene code.
-
-```
-// 1. Synthesise voice first — audio timing is ground truth
-multi_voice_tts({ text: "Narration.", outputPath: ".frameforge-files/voice_0.m4a" })
-
-// 2. Scaffold the compositor project (copies engine + all render scripts + briefings)
-scaffold_animation_project({
-  outDir: ".frameforge-files/my-anim/",
-  scenes: [ { narration: "...", caption: "...", visual_description: "..." } ],
-  audioPath: ".frameforge-files/voice_0.m4a"
-})
-// → returns nextSteps[] — read ANIMATION_GUIDE.md and edit STORYBOARD.md next
-
-// 3. Validate storyboard (four hard gates — must pass before scene code)
-validate_storyboard({ storyboardPath: ".frameforge-files/my-anim/STORYBOARD.md" })
-
-// 4. Write real animation in edit.js (pure functions of t — read ANIMATION_GUIDE.md)
-
-// 5. Pre-flight linter & purity verification (3-point repeat, wander, cold-jump)
-render_animation({ projectDir: ".frameforge-files/my-anim/", mode: "look" })
-render_animation({ projectDir: ".frameforge-files/my-anim/", mode: "verify" })
-
-// 6. Review stills (at least one sheet per shot, one strip per key motion)
-render_animation({ projectDir: ".frameforge-files/my-anim/", mode: "sheet" })
-render_animation({ projectDir: ".frameforge-files/my-anim/", mode: "strip",
-                   timestamps: [2.1, 2.6] })   // every frame of one motion
-render_animation({ projectDir: ".frameforge-files/my-anim/", mode: "crop",
-                   timestamps: ["9:16", 3.0] })  // mobile crop check
-
-// 7. Full render (only after stills pass)
-render_animation({ projectDir: ".frameforge-files/my-anim/", mode: "full",
-                   audioPath: ".frameforge-files/voice_0.m4a" })
-
-// 8. Closed-loop QA fix protocol (mandatory — Opus 5.5 / Claude Code pattern)
-render_animation({ projectDir: ".frameforge-files/my-anim/", mode: "quality" })
-// Returns: { passed, overallScore, worstFrames: [{time, score, issues}] }
-// If passed: false → fix loop (max 3 rounds):
-//   1. Read worstFrames[].  2. Patch edit.js for those timestamps only.
-//   3. render_animation({ mode: "strip", timestamps: [failingT - 0.5, failingT + 0.5] })
-//   4. render_animation({ mode: "quality" })
-//   5. Repeat until passed or 3 rounds — then escalate to user.
-// Never re-render full film to fix one timestamp. Use strip only.
-```
-
-Requires one-time: `cd <outDir> && npm install playwright && npx playwright install chromium`
-
-### Path 3 — Auto-Research (for unattended / batch runs)
-
-Use this when FrameForge runs **without** an IDE in the loop — overnight batch,
-`queue_full_pipeline`, or a standalone worker. The pipeline calls its own LLM
-for research and scripting, so `PROVIDER_LLM` + the matching API key are required:
-
-```
-1. research_topic({ topic: "...", style: "educational", format: "short-form reel" })
-2. write_script({ productionId, claims, topic, persona: "tech reviewer" })
-3. render_from_scenes({ productionId })
-4. publish_video({ productionId, masterPath, channels: ["file"] })
-```
-
-### Path 4 — Autonomous Local Video Editing (`edit_video`)
-
-When the user provides video clips (B-roll, screen recordings, camera footage) and audio/narration, FrameForge autonomously cuts, trims, color-grades, reframes, captions, and stitches them with seamless transitions locally:
-
-```js
-edit_video({
-  clips: [
-    {
-      video_path: "/path/to/clip1.mp4",
-      start_time: "00:05.5",
-      end_time: "00:15.0",
-      speed: 1.0,
-      color_grade: "cinematic",
-      caption: "AUTONOMOUS EDITING",
-      transition: "dissolve",
-      transition_duration: 0.5
-    },
-    {
-      video_path: "/path/to/clip2.mp4",
-      start_time: 0,
-      duration: 6.0,
-      speed: 0.8, // subtle slow-mo
-      color_grade: "cinematic",
-      caption: "SEAMLESS TRANSITIONS",
-      clip_volume: 0.3 // duck ambient sound
-    }
-  ],
-  audio_path: "/path/to/master_voiceover.m4a",
-  music_path: "/path/to/background_track.mp3",
-  music_volume: 0.07,
-  orientation: "landscape", // or "portrait" for Reels / TikTok / Shorts
-  auto_fit: true // automatically slice clips to fit total voiceover duration
-})
-```
-
-Supported features:
-- **Trimming & Cutting:** Accurate timestamp parsing (`"01:23.45"`, `"83.45s"`, numeric seconds).
-- **Speed Ramping:** `0.25x` to `4.0x` with chained `atempo` filters preserving pitch.
-- **Cinematic Color Grading:** `cinematic`, `warm`, `cool`, `vintage`, `bw`, `vibrant`, `cyberpunk`.
-- **Canvas Reframe:** `landscape` (1920×1080), `portrait` (1080×1920), `square` (1080×1080).
-- **Transitions:** `fade`, `dissolve`, `wipeleft`, `wiperight`, `slideup`, `slidedown`, `circleopen`, `smoothleft`.
-- **Audio Mixing & Ducking:** Original ambient audio level control, master voice track, background music with sidechain ducking and LUFS normalisation.
-
-### Voice Synthesis (per call)
-
-```
-multi_voice_tts({
-  text: "Narration text here",
-  outputPath: "/path/in/files-dir/voice_0.m4a",
-  platform: "elevenlabs",
-  voice: "your_cloned_voice_id",
-  apiKey: "sk_..."
-})
-```
-
-### Overnight batch
-
-```
-I'm going to sleep. Make as many videos as you can before 9 AM.
-Topics (queue them all):
-  1. How does GPS actually work?
-  2. Why planes don't fly over the Pacific in a straight line
-  3. The engineering inside a modern CPU
-
-Rules:
-- Strong hook, double-verify every fact.
-- After each video: run the quality gate, then publish to the output directory.
-- Leave me a summary when done.
-```
-
-The skill calls MCP tools sequentially using the StateMachine to track progress.
-If a stage fails it retries with exponential backoff; if it fails terminally it
-marks that production FAILED and moves to the next topic.
-
----
-
-## Provider reference
-
-| Role  | Provider     | Key env var               | Notes                          |
-|-------|-------------|--------------------------|-------------------------------|
-| LLM   | groq        | `GROQ_API_KEY`            | Default. Fast, free tier.      |
-| LLM   | openrouter  | `OPENROUTER_API_KEY`      | Any model via one key          |
-| LLM   | anthropic   | `ANTHROPIC_API_KEY`       | Claude Sonnet/Haiku/Opus       |
-| LLM   | gemini      | `GEMINI_API_KEY`          | Gemini 2.0 Flash / 2.5 Pro     |
-| LLM   | cerebras    | `CEREBRAS_API_KEY`        | 2000+ tok/s Llama              |
-| LLM   | openai      | `OPENAI_API_KEY`          | GPT-4o / o1                    |
-| LLM   | ollama      | _(none)_                  | Local, OLLAMA_BASE_URL         |
-| TTS   | edge-tts    | _(none)_                  | Free, offline, 300+ voices     |
-| TTS   | voxforge    | `VOXFORGE_URL` + `_KEY`   | Local neural TTS & cloning (Rust) |
-| TTS   | elevenlabs  | `ELEVENLABS_API_KEY`      | Voice cloning                  |
-| TTS   | azure       | `AZURE_SPEECH_KEY`        | Enterprise                     |
-| TTS   | openai      | `OPENAI_API_KEY`          | High quality                   |
-| Visual| code-driven | _(none)_                  | Default — pure-t canvas animation & kinetic text |
-| Visual| user-media  | _(none)_                  | Caller `image_path` / `video_path`   |
-
----
-
-## Quality gates (hard — will block delivery)
-
-| Gate                | Threshold            |
-|---------------------|----------------------|
-| File size           | > 1 MB               |
-| Video stream        | present              |
-| Resolution (master) | 1920×1080            |
-| Resolution (short)  | 1080×1920            |
-| Codec               | H.264                |
-| Pixel format        | yuv420p              |
-| Frame rate          | 24–30 fps            |
-| Integrated loudness | −14 ±1.5 LUFS        |
-| True peak           | ≤ −0.5 dBTP          |
-| Black frames        | none > 0.5 s         |
-| Frozen frames       | none > 0.5 s         |
-
----
-
-## Key files
-
-```
-src/mcp-server/server.js          MCP HTTP server (21 tools, port 3210)
-src/mcp-server/stdio.js           MCP stdio server (21 tools)
-cloudflare-mcp/src/index.js       Cloudflare Workers Remote MCP proxy (21 tools)
-src/pipeline/providers.js         LLM / TTS / Image abstraction (env-var-switchable providers)
-src/pipeline/state-machine.js     File + PostgreSQL production state
-src/pipeline/retry-policy.js      Exponential backoff, stage timeouts
-src/pipeline/telemetry.js         NDJSON cost tracking
-src/quality-gate/gate.js          9 hard gates
-src/audio-mixer/mixer.js          Sidechain ducking, LUFS normalisation
-src/shorts-extractor/extractor.js Silence-based 9:16 crop for Shorts
-src/fact-checker/checker.js       Claim risk classification + evidence gates
-src/video-renderer/renderer.js    Scene render + master assembly
-src/worker/server-render-free.js  Render-optimised worker API (Render free)
-src/worker/server.js              Full worker API
-docs/env.template                 Environment variable reference
-```

package/.agent/skills/video-pipeline/assets/project/ANIMATION_GUIDE.md

@@ -1,258 +0,0 @@
-# ANIMATION_GUIDE.md — Agent Context for HTML Video Projects
-
-> This file is loaded as context by the model before it writes any scene code.
-> It encodes the contract, the four storyboard gates, and the six determinism rules
-> that make headless-Chrome rendering reproducible and parallel.
->
-> Source: ClaudeAnimationBase ANIMATION_GUIDE.md + awesomeclaude.ai corpus study (703 prompts).
-
----
-
-## The Contract
-
-A video is a set of scene files where **every pixel is a pure function of time `t`**.
-
-The renderer owns the clock. Scenes never call `Date.now()`, `performance.now()`,
-`setTimeout`, `setInterval`, `Math.random()`, or any module-level mutable counter.
-The renderer injects a virtual clock shim before the page loads, advances it one frame
-at a time, and screenshots the result. Frame 400 can be captured hours after frame 399
-and the scene must not care.
-
----
-
-## Step 0 — Beat Sheet First
-
-**Never write scene code before the storyboard passes all four gates.**
-
-The workflow is always:
-
-1. Write a beat sheet (title, shots, events, reads, transitions).
-2. Reply with the beat sheet and four keyframe descriptions **only**. Stop.
-3. Wait for approval.
-4. Only after approval: write the scene files.
-
-Fixing a line in a beat sheet costs one message. Fixing a finished scene costs a rewrite.
-
----
-
-## The Four Storyboard Gates
-
-Run `node scripts/storyboard-validator.mjs STORYBOARD.md` to enforce these automatically.
-
-### Gate 1 — Every shot has an EVENT
-
-An event is something that **physically happens** in the shot. It is not a description
-of what the viewer sees, and it is not a mood adjective.
-
-| ❌ FAILS | ✅ PASSES |
-|---|---|
-| "Clawd stands in a meadow." | "Clawd turns to face the viewer and extends one hand." |
-| "A beautiful space scene." | "A comet crosses the frame left-to-right over 4 seconds." |
-| "We see the city at night." | "The city's lights flicker off one by one from the edges in." |
-
-### Gate 2 — Reads must not overlap
-
-Each shot has a list of **reads** — the discrete things a viewer must understand,
-with non-overlapping start and end timestamps.
-
-```
-# BAD — 0.0–1.5 and 1.0–2.5 overlap from 1.0–1.5
-reads:
-  - 0.0–1.5: Viewer recognises the character.
-  - 1.0–2.5: Viewer understands she is running away.
-
-# GOOD
-reads:
-  - 0.0–2.0: Viewer recognises the character.
-  - 2.0–4.0: Viewer understands she is running away.
-```
-
-### Gate 3 — Every seam has a named transition
-
-This includes the film open (transition_in on Shot 1) and film close
-(transition_out on the last shot). A storyboard that starts or ends
-without a declared transition fails.
-
-Recognised transition names:
-`cut` `fade-from-black` `fade-to-black` `dissolve` `wipe-left` `wipe-right`
-`iris-in` `iris-out` `cross-dissolve` `push-left` `push-right` `flash` `dip-to-white`
-
-### Gate 4 — No text on screen
-
-"Lost" must be acted, not captioned. "Heartbroken" must be shown, not written.
-
-The model **may not** write `text()`, `wallCard()`, `stamp()`, or `codeCard()` calls
-that convey plot-critical information (character names, place names, dates, emotions,
-narrative exposition). These helpers exist for UI/diagram/explainer content only,
-not for storytelling that belongs in the direction.
-
----
-
-## Six Determinism Rules
-
-These rules are what make the render reproducible, parallel, and resumable.
-
-### Rule 1 — Read time, never count frames
-
-```js
-// ❌ BAD — frame counter mutates across calls
-let frame = 0
-layer('x').on(() => { frame++; return { opacity: frame / 30 } })
-
-// ✅ GOOD — pure function of t
-layer('x').on(t => ({ opacity: Math.min(1, t / 1.0) }))
-```
-
-### Rule 2 — Seed everything with `hash(i)`
-
-`hash(i)` in `reel/engine.js` is a deterministic integer hash of its index.
-Use it wherever you need a stable pseudo-random value (star positions, brush seeds,
-particle offsets). Never use `Math.random()` inside a scene file.
-
-```js
-import { hash } from './reel/engine.js'
-
-// Star field — same every render
-for (let i = 0; i < 200; i++) {
-  const x = (hash(i)     % 1920)
-  const y = (hash(i + 1) % 1080)
-  // ...
-}
-```
-
-**Boil wobble exception:** hand-drawn wobble is deliberately re-seeded 12 times
-per second so it looks chaotic while remaining reproducible:
-
-```js
-const boilSeed = Math.floor(t * 12) // same bucket for every frame in that 1/12s window
-const wobble   = (hash(boilSeed) % 7) - 3  // –3 to +3 px
-```
-
-### Rule 3 — No integrating physics
-
-Never integrate velocity per tick. Use closed-form motion or precompute the
-simulation into an array before the layer is registered.
-
-```js
-// ❌ BAD — position depends on previous frame
-let vx = 0, x = 0
-layer('ball').on(() => { vx += 0.1; x += vx; return { left: x } })
-
-// ✅ GOOD — closed-form quadratic
-layer('ball').on(t => ({ left: 0.5 * 120 * t * t + 'px' }))
-```
-
-### Rule 4 — Await `document.fonts.ready` before frame 0
-
-The renderer calls `await page.evaluate(() => document.fonts.ready)` before
-advancing the clock. Scene code must not assume fonts are available before that
-await resolves — if a font load fails, every text frame renders in the system
-fallback and the entire video looks wrong.
-
-### Rule 5 — ffmpeg owns audio
-
-Never capture audio from the browser. Audio is a separate pass:
-
-1. TTS generates audio → word-level timestamps from `scripts/transcribe.py`
-2. Scene resolves animation anchors from those timestamps via `cuePhrase()`
-3. `node scripts/render.mjs full` renders video frames (silent)
-4. `uv run scripts/mix_audio_pro.py --sfx-events --room broadcast --platform youtube` builds the final audio track
-   (reads out/sfx-events.json from window.__events() automatically; use `mix_audio.py` for the simple chain)
-5. `node scripts/render.mjs mux` merges with `-c:v copy` (video stream untouched)
-
-`cuePhrase(phrase)` **throws a fatal build error** if the phrase cannot be found
-in the loaded captions track. If a phrase stops being spoken, the build fails and
-names the missing words — re-recording voice-over can never silently desync the film.
-
-### Rule 6 — Tag BT.709 and use `-t` not `-shortest`
-
-The renderer's ffmpeg encode always includes:
-
-```
--color_primaries bt709 -color_trc bt709 -colorspace bt709
-```
-
-Untagged HD video gets decoded with the wrong matrix on some players and colours shift.
-
-Always use `-t <duration>` for the output duration, not `-shortest`. `-shortest`
-hangs if the input has a subtitle or data stream.
-
----
-
-## Motion Vocabulary
-
-Write these explicitly in the brief. The model will follow them.
-
-**Allowed:** easeIn, easeOut, easeInOut, spring(t), lerp(t, a, b), fade, slide, scale, rotate.
-
-**Banned (AI slop tells):**
-- Particle bursts that emit from a single point
-- Lens flares
-- Neon glow on everything
-- RGB chromatic-aberration split used decoratively
-- Bouncy easing on text (`spring` on entrance is OK; double-bounce is not)
-- Perspective / `rotateY` in a flat/painted 2D style (breaks layout math and look)
-
----
-
-## Review Surface
-
-Before `node scripts/render.mjs full`, always generate stills:
-
-```bash
-# Shape of the film — first/middle/last of each shot
-node scripts/render.mjs sheet
-
-# Every frame of one motion or transition
-node scripts/render.mjs strip 2.1 2.6
-
-# Story-carrying face or detail at full resolution
-node scripts/render.mjs storyboard
-
-# Mobile crop check
-node scripts/render.mjs crop 9:16 3.0
-```
-
-Budget: **at least one sheet per shot, a strip per key motion and transition,
-a crop per story-carrying face.**
-
-Feed the PNGs back to the model. Name what failed. Then re-render the affected range.
-Re-rendering frame 400 costs nothing. Unguided revision costs everything.
-
----
-
-## Pre-render checklist (run before `render full`)
-
-```bash
-node scripts/look.mjs          # fonts, clipped text, NaN transforms, missing images
-node scripts/storyboard-validator.mjs STORYBOARD.md  # all four gates
-```
-
-Both must exit 0.
-
----
-
-## Subagent rules (long films)
-
-- One orchestrator, N chapter subagents.
-- **Chapter subagents may not edit shared helpers** (`reel/engine.js`, `reel/engine.css`,
-  `scripts/render.mjs`, `scripts/look.mjs`).
-- Each subagent loads its rules from `pipeline/briefings/<chapter>.md` on disk, not
-  from the parent context. This keeps context small and rules isolated.
-- Verification runs with subagents: 2 subagents at a time, each scanning 10 frames,
-  every 5 frames of the rendered sequence.
-
----
-
-## Cost reference (single data points, not benchmarks)
-
-| Project | Cost |
-|---|---|
-| 15s launch spot from a one-liner | ~$2 API |
-| Full lyric music video (high effort) | ~$200 |
-| 3-min Remotion film (~7,400 lines) | 7% of weekly quota |
-| Model tokens alone (~90K in / 15K out) | ~$0.66 at Opus 5.5 list price |
-
-Render is **free and local**. The expensive part is model iteration, which is why
-the storyboard gate and the still-review loop exist — they eliminate the most
-expensive kind of work: finishing a scene before discovering it was wrong.