TrueMotion motion design
A video is an ordered list of scenes. A scene is one HTML document with one paused GSAP timeline. TrueMotion renders by seeking that timeline to exact times, so every visible change must be a function of timeline position.
Workflow
- Load the brief. Pick one visual system: a palette, a type pairing, a spacing scale, and a background treatment. Hold it across the whole film.
- Read scene-contract.md and motion-rules.md before writing any scene.
- Read typography.md and shot-direction.md for the type and composition decisions.
- Write scene 1 with
add_scene. For later scenes, read the previous one withread_scene(purpose: "evolve")when actors continue across the cut, or passfreshStart: truefor an intentional hard cut. - After every write, inspect the returned frames before continuing.
- Call
review_timeline. Fix what it flags withpatch_sceneorupdate_scene. - Call
render_videowith the final output path.
Authoring rules
- One timeline, paused, on
window.__SCENE_TIMELINE__. - Explicit
window.__SCENE_DURATION__in seconds. - Every entrance uses
fromTo()with both states written out. - Tokens
{{GSAP}},{{FONTS_CSS}},{{W}},{{H}},{{ICON:...}},{{ASSET:...}},{{ROUGH}},{{FX}},{{SHADERS}},{{THREE}},{{BRAND:*}}and{{COMPONENT:*}}are inlined locally. Never reference a CDN, a web font, or a local file path. - Available font families are
Display(600, 900),Body(300, 400) andMono(500). No other family names. - No emoji. Brand logos come from
{{ICON:slug}}; generic icons are inline SVG. - Mark editable copy with
data-om-idanddata-om-label.
The quality bar
A scene is finished when it has a clear hero, depth, continuous life, and a
deliberate resolve. A flat layout where text simply appears is not finished.
Trust the measurements from review_timeline over your own reading of the code.
References
Call list_skills through MCP to see the current reference set; load any file
with read_skill.
- scene-contract.md - required HTML shape and tokens.
- motion-rules.md - timing, easing, depth, anti-patterns.
- typography.md - type roles and minimum sizes.
- shot-direction.md - framing and actor hierarchy.
- continuity.md - matched cuts across scenes.
- evolve-scene.md - how to fork a scene safely.
- verification.md - the self-check before finishing.
- finishing.md - final polish and handoff.
- reference-library.md - pattern index.
- blocks/catalog.md - reusable block shapes.
- blocks/typing-input.md - prompt-bar typing.
- blocks/rough.md - hand-drawn SVG helper for
{{ROUGH}}. - blocks/fx.md - local inline-CSS effects for
{{FX}}. - blocks/shaders.md - CSS utility layer for
{{SHADERS}}. - blocks/brand.md - colour variables and logo for
{{BRAND:*}}. - blocks/components.md - reusable markup for
{{COMPONENT:*}}. - blocks/three.md - CSS-3D stage helper for
{{THREE}}. - patterns/ - beat sheets by video type.
- examples/ - complete scene sketches.