STORYBOARD.md schema. The workflow translates your plan into the smaller machine-readable shape the build consumes.
“Storyboard” is also a question the agent asks in the opening interview. Say yes there and the plan (in chat), the sketches (a
storyboard.html page you open in a browser), and the build all get reviewed with you pass by pass. That answer changes the review process, not the route. Either way, the plan this page teaches is what the build works from.Prompt the plan, not the scenes
A storyboard is a short, structured document that sits above the individual frames. It holds three things:- one arc
- one direction block that every frame inherits
- a light per-frame spec — not a full description — for each key moment
Storyboard a 3-frame piece: hook → substance → landing, silent, ~15 seconds, with a callback that pays off the opening motif.Everything below is the vocabulary that turns “storyboard” from a loose word into a plan the build can execute in one pass.
State the film’s shape once
Before any frame, fix four things that every frame will be judged against:- Message — the one-sentence thesis the whole film has to prove. If a frame doesn’t serve it, cut the frame, not the message.
- Arc — the beat sequence, named plainly.
Hook → Substance → Landing, orHook → Problem → Solution → Proof → CTA. Use a shape word like “listicle” when the frames are parallel entries rather than a rising sequence. - Audience — who it’s for, in a phrase. It calibrates tone and jargon for every frame at once.
- Mood — one music or energy descriptor, like “tense synth pulse, resolving to warm”. Every frame’s pacing should agree with it, even in a silent piece.
Set the direction once, apply it to every frame
A storyboard’s direction block is the set of rules every frame obeys without restating them. Four are worth naming explicitly. Two-color discipline. Name a ground color and one ink color. Then say the rule out loud: nothing ever gets a second hue for emphasis. A bigger moment gets bigger through inversion, weight, scale, or density.- ❌
use the brand colors, plus a highlight color for the important bits - ✅
ground: deep navy; ink: warm white. Emphasis = invert, scale up, or go denser — never a third color.
no purple-blue AI gradients, no bokeh, no browser chrome, no drop-shadow cards, no infinite loops or randomnessSwap in whatever clichés are wrong for your film. The point is naming them before a frame drifts into one.
Give each frame a job
The direction block covers everything shared. So each frame’s own prompt only needs to say what’s different about it:persuasion and beat. Without them, a frame is “a scene that shows the stat.” With them, it becomes “a scene that proves the stat, and here’s how it feels to land.”
A frame with a named persuasion device and beat gives the build a reason for every choice. A frame with only a visual description gives it none.
The callback
Introduce a motif early: a shape, a mark, a phrase, a piece of color. Have it return later, denser or fuller, as a deliberate payoff. Say both halves in the plan — where the motif is planted, and how it changes when it returns.A single thin accent dot appears top-right in frame 1 at low weight. In the landing frame, that same dot expands and fills into the full logo lockup — same motif, now complete.State the return explicitly. Otherwise a rebuild is free to treat the early motif as throwaway texture. The callback only works if the plan says the second appearance is the same element, not a new one that resembles it.
Worked example: a silent 3-frame storyboard
Storyboard a 3-frame, ~15-second, 1920x1080 piece. Silent — no narration, no VO track. Message: “Fernwell gives you back the hours other tools take.” Arc: Hook → Substance → Landing. Audience: small-team operators evaluating a new tool. Mood: tense synth pulse resolving to warm. Direction for every frame: ground color deep navyRendered from the prompt above, unedited — no audio track, exactly as asked.#0b1220, ink color warm off-white#f4efe6. Nothing else gets a hue — emphasis is inversion, scale, or density only. Reveals stage on internal timestamps, since the piece is silent and there’s no spoken cue. At each frame’s t=0 only its first element is on screen. The rest arrive on the timestamps below. Holds stay fully still, no drift or breathing. No purple-blue AI gradients, no bokeh, no browser chrome, no drop-shadow cards, no infinite loops or randomness. Frame 1 — Hook (0.0–4.0s), type: hook, persuasion: counterexample, beat: recognition + tension, focal: the headline. At 0.0s: bold ink headline “Most tools slow you down.” slams in, centered. At 1.5s: a single thin accent dot (ink color, small, low weight) fades in top-right — the motif, planted quietly. Hold from 3.0–4.0s. Frame 2 — Substance, the breather (4.0–10.0s), type: benefit_highlight, persuasion: numbered enumeration, beat: aha, focal: the stat. This is the one deliberately calmer, more static frame in the piece. Everything else develops continuously. This one mostly holds. At 4.0s: the accent dot from frame 1 carries over, now larger, sitting quietly left-of-center. At 5.0s: a big stat “3.2 hrs / week” fades in beside it, no motion after it lands. Static hold 6.0–10.0s. Frame 3 — Landing (10.0–15.0s), type: cta, persuasion: callback + distillation, beat: resolve + inevitability, focal: the completed motif. At 10.0s: the accent dot from frames 1–2 expands and fills into the full Fernwell wordmark lockup — same motif, now complete, denser and larger. At 12.0s: tagline “Fernwell. Built for flow.” stamps in below it. Hold 13.5–15.0s.
Related
Anatomy of a one-shot prompt
The six-part skeleton a single beat uses — the same discipline, one frame at a time.
Recreating something you saw
Transcribing motion frame by frame — the same rigor a storyboard’s per-frame timestamps need.
Design systems and brand
The two-color discipline and brand tokens a storyboard’s direction block draws from.
How a HyperFrames project works
STORYBOARD.md as a production artifact — where this chapter’s plans land, downstream of BRIEF.md.Capstone thread — the Level 7 film stretches this chapter’s callback device across its whole runtime. The
<div class="clip"> chip typed in the opening rides the wire through every region. It finally snaps into the render slot as the payoff (cut from the film, below).
The clip card — the <div class="clip"> typed in the opening travels the whole journey: it slides onto the wire as a clip chip after being typed, rides ahead of the camera between regions (handing itself off — visible leaving one region and arriving in the next), and is the thing that finally renders at the end. It is the protagonist.
That clause paying off, rendered — the protagonist chip arriving at the render slot after a full minute on the wire.
Next: Editing existing videos — the editor verbs that turn a first render, storyboard or not, into the twenty edits after it.