Storyboarding
Turn accepted source evidence into an ordered, timed narrative plan.
plan = timeline.storyboard_agent.plan(brief, prompt, tools=(), name="storyboard")
# Or consume the accepted source_brief.json already in the current run:
plan = timeline.storyboard_agent.plan(prompt, tools=(), name="storyboard")The explicit form fingerprints the passed source-brief artifact. The prompt-only
form parses the current source_brief.json, grounds it against manifest.json,
and fingerprints both files so either source selection or generated-source
changes invalidate a cached plan. Both return a structured plan with a canvas,
total duration, ordered sections, and grounded source windows.
Pass tools=[transcribe] when the storyboard itself needs transcript evidence
that an earlier pass did not establish. This grant applies only to that planning
call.
Use its prompt to define the edit's architecture:
- target duration and orientation;
- section order and approximate timing;
- which audio is the narrative spine;
- when B-roll should cover dialogue;
- montage rhythm or beat relationship;
- where titles, captions, or visual breathing room are needed;
- required opening and closing behavior.
Avoid vague requests such as make it cinematic. Say what cinematic means for
this piece: perhaps slow establishing shots, longer holds, low transition
density, natural sound at scene changes, and no animated text.