to-scenes
To scenes
Turn BEATS.md and NARRATION.md into SCENES.md. A scene is a small event in a world, not a container for information. Its visuals serve the narration: they reveal, demonstrate, compare, or hold exactly when the spoken idea needs them.
Process
- Read both inputs, the applicable design truth, and
references/hyperframes-capability-envelope.md. Recompute the beats and narration artifact digests; continue only when the narration'ssource_digestmatches the current beats and both stored artifact digests match their files. The envelope constrains feasibility without prescribing implementation. Treat narration as revisable evidence, not a locked timeline. - Find a physical or spatial expression for each abstract beat: give the concept a body, put it in a world, and cause a visible state change. Coordinate that change with the narration's explanation, emphasis, and pauses instead of designing a separate visual performance.
- Group beats that belong to one continuous event; split a beat when its explanation requires distinct visual events.
- Design the film as a whole: establish a continuity object or motion, vary worlds and shot scales, place visual peaks, and name the rhythm.
- Flag narration sentences whose order, length, or duplication fights the visual event. Revise
NARRATION.mdonly after preserving the originating beat's claim and job. After any revision, recompute itsartifact_digestand revalidate its beats and article lineage before using it as a source. - Write
SCENES.mdusingreferences/scene-format.md. Read that file before drafting or auditing scenes, and record the current beats and narration digests. For every demonstration, define the exact visible sequence, choose its truth mode, and declare how every code surface is labeled; do not leave those decisions for production. - Create or select the single HyperFrames review project and record its path and revision in
SCENES.md. Build each scene's smallest useful 16:9 proof: Hero when one state is sufficient, Start/Hero/End when change or continuity must be judged, and additional states only for a named risk. Use real typography, near-final copy, and real code or evidence-backed terminal components wherever those determine the result. Embed or link those proof images from the owning scene section inSCENES.md, with their state IDs and project revision. - Classify every scene's feasibility using the capability envelope, naming dependencies and fallbacks where required.
- Run the scene audit in the format reference. If narration changes after scenes exist, revise every affected scene, refresh
source_narration_digest, recompute the scenesartifact_digest, mark affected rendered proof stale, and repeat the audit before completion.
Resolve the visual grammar and declared scene risks with the rendered evidence referenced from SCENES.md before advancing. Record project identity, revision, source digests, proof paths, aspect ratio, reviewed risks, and decisions in project state and SCENES.md.
Before presenting SCENES.md, a changed NARRATION.md, or any later revision, follow ../boring-video/references/markdown-review.md. The authoritative SCENES.md pairs each semantic scene contract with inspectable rendered evidence from the shared HyperFrames project. Do not represent unrendered prose as visual evidence.