docs: Prompt Guide as a novice-to-capstone arc + text corrections from validation

[vanceingalls]

Summary

Two bodies of documentation work from the prompt-guide campaign:

1. Prompt Guide restructured as a novice-to-capstone arc

The 29-page reference manual (by-video-type / by-feature sections) is now a single novice-to-advanced
arc — no standalone reference sections survive ("full dissolve"). Every page becomes a chapter at the
level where the reader is ready for it, with an entry bridge ("you can already X — this adds Y") and
a literal exit bridge (*Next: [Title](/slug) — clause.*) chaining straight into the next chapter.
Bridge-chain integrity was verified end to end: all 30 chapters' exit bridges point at the actual next
page in nav order, zero mismatches.

• Level 1 — Your first video: workflow rides (product-launch, explainers, code & PRs, captions &
  talking-heads, music & slideshows, motion graphics), reframed as one-prompt first wins; gains a new
  Changelog videos section for the /changelog-video skill, validated with a real build against
  this repo's own last-two-weeks digest.
• Level 2 — Control: anatomy, specification dial, vocabulary, visual specs; examples becomes the
  level-end gallery. Anatomy gains a note on the composition-structure mandate (feat(skills): add COMPOSITION_STRUCTURE to feedback repro packet + soft-warn lint #2599).
• Level 3 — Life: motion grammar, transitions.
• Level 4 — Substance: code blocks, data & maps, overlays, captions catalog, generated artwork,
  VFX, runtimes & 3D — reframed as additive capabilities layered onto earlier chapters.
• Level 5 — Voice and sound: media & audio, plus a new Bring any footage section documenting
  the automatic HEVC/hostile-codec proxy subsystem (refactor(parsers): single shared FFmpeg/FFprobe binary resolver #2585–feat(media): alpha-capable authoring proxies #2598), validated with a real HEVC test
  clip built into a picture-in-picture piece.
• Level 6 — Scale: design systems, variables & templating (with a correction for the
  variables-no-longer-shadow-authored-CSS fix, fix(core): stop composition variables from shadowing authored CSS custom properties #2553), a brand-new Storyboards chapter (prompting
  the plan instead of the scenes — arc, direction block, one breather, one callback, per-frame
  negative list — validated with a real silent 3-frame build), editing, iterating, recreating
  references, rendering & output, Remotion migration.
• Level 7 — Capstone: a new chapter built around a real public promo film for HyperFrames itself
  ("Write HTML. Render video.") — 7 frames, ~48s, one long-form prompt that composes nearly every
  technique the guide teaches (kinetic type, per-character code typing, a matched-motion transition,
  real data-viz, a generated-artwork hybrid, a continuous camera-push montage, and a callback +
  breather landing). The prompt is printed in full and dissected chapter-by-chapter. Exposes ground/
  ink/productName as composition variables and ships both the default render and a --variables
  re-skin — including an honest note that one frame (a generated illustration) bakes its palette at
  generation time and doesn't follow the CSS-driven override the other six frames do.
• Appendix: rules-and-anti-patterns becomes the consolidated cheat sheet (existing rules link
  back to where they're taught) plus 8 new lint-rule rows — seek-order safety, cold-seek visibility,
  SVG draw-on — each grounded against the actual linter source (packages/lint/src/rules/gsap.ts),
  phrased as prompt guidance.

New validation builds beyond the existing 64 embedded renders: changelog-video, proxy-footage,
storyboard-mini, and the capstone film (default + re-skin) — each built exactly as written by a
fresh builder agent, passing lint/check, rendered, and frame-verified before its page shipped.

2. Text corrections from the validation campaign

• hyperframes-core SKILL.md — "First-pass lint gotchas": root element needs data-start="0"; initial states via gsap.fromTo, never CSS transform + tween on the same property.
• docs/concepts/compositions.mdx — data-composition-src resolves relative to the project root, not the referencing file.
• gsap-transforms-and-perf.md — createElementNS SVG has no reliable center pivot; draw at local (0,0) inside a positioning <g>.

Behavior fixes from the same campaign are in #2110; Tier 3 block bugs tracked in #2107.

Test plan

• All new validation builds (changelog-video, proxy-footage, storyboard-mini, capstone
  default + re-skin) pass lint/check/render exactly as written by a fresh builder agent
• Every embedded S3 URL across the guide (68 total) verified serving (200, video/mp4)
• docs.json parses; full nav walked and every exit bridge verified against the actual next
  chapter in order (0 mismatches across all 30 chapters)
• bun run format:check and mintlify broken-links both clean
• Capstone film's technique-table coverage independently verified frame-by-frame (ffprobe +
  visual frame extraction) against the render, not just the builder's own report

🤖 Generated with Claude Code