Common mistakes
Frequent pitfalls to avoid when writing Scrambo programs.
- Calling a facade before
editor.open(...). - Editing the timeline before
editor.start()has connected the browser. - Calling a refinement specialist before a first timeline exists.
- Passing a plain dictionary where storyboard or author expects an
Artifact. - Asking the scout to edit, the prepare agent to make creative selects, or a caption specialist to restructure the whole video.
- Hiding the narration source or target duration in vague language.
- Asking for transcript-based decisions without granting
tools=[transcribe]to the scout, storyboard, or author that must make them. - Calling
transcribe(...)directly or assuming a transcript grant persists to the next specialist. - Assuming an uploaded JSON file is automatically associated with similarly named media; it remains an untrusted candidate until an enabled agent imports it.
- Passing prose to
timeline.validate(...); it accepts a selection spec or aValidationPolicy, not a natural-language prompt. - Assuming every validation group applies to every edit. Select checks relevant to the layers you actually created.
- Closing the browser tab during a run.
- Depending on programmatic export in code meant to run against the cloud API.
The most reliable programs are explicit about outcomes, keep agent responsibilities narrow, pass artifacts directly, and validate the properties that matter for the deliverable.