Choose the right workflow
Match the direct or structured workflow to what your edit actually needs.
You do not need every agent in every program.
| Need | Recommended workflow |
|---|---|
| A quick edit from a clear request | author_agent.edit("...") |
| Careful source selection and narrative control | scout → storyboard → author |
| Transcript-aware selection, planning, or direct editing | grant tools=[transcribe] to the specialist that needs it |
| Transcodes, trims, extracted audio, or other mechanical derivatives | scout → prepare → storyboard → author |
| Titles, captions, graphics, or sound as distinct creative passes | author → one or more refine agents |
| A quality gate with automatic repair | validate → pass report to an edit agent → validate again |
| Create voiceover or image-to-video footage deterministically | scrambo.tools.genAI → storyboard/author |
| Ask a specialist to decide which generated assets are needed | generate specialist → storyboard → author |
Use the short direct-author path when a single prompt expresses the edit well. Use the structured scout/storyboard path when source choices, transcript evidence, section timing, or narrative order deserve their own reviewable handoffs.