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, the sketches, and the build all get reviewed with you pass by pass on a live board. 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.