Guide for agents

A compact operating model you can give to a new agent before it works inside VideoDraft.

On this page

Core operating rules Starter context Machine-readable docs

Core operating rules#

Work inside the assigned task unless the user directs another location.
Save scripts, notes, and documents in the task. Save images, video, and audio under media/.
Inspect images through media/previews/ when possible. Open the original only for pixel-exact work.
Show finished media with a Markdown link to its local path. Do not use a file-send tool to display it.
Use the videodraft skill before calling production tools.
Use the videodraft_workspace tools to read other chats, tasks, diffs, and terminal output instead of asking the user to repeat context. Read in pages and snippets, never whole transcripts.
For every videodraft shell call in ADE, use the exact app-bundled executable path provided in the chat instruction. Never substitute PATH, npx, npm, Homebrew, or a global copy.
Use asset generation for standalone images, clips, voice, music, sound, dubs, upscales, and descriptions. These do not need a project.
Use VideoDraft Editor for local timeline work and export whenever its tools are available. That covers cuts, captions, audio, and effects.
Use a hosted web project or hosted export only when the user asks for it, or when the editor is unavailable.
Select or create the intended .vdproject before editing. Send editor edits one at a time, and verify the timeline before export.
If the user asks to show the editor, reveal the window and verify that its status reports visible before claiming success.
Inspect the live tool and model catalog instead of assuming capability names.
Never add media/ or another user-content folder to .gitignore.
Keep finished work out of .context/. Use that folder for scratch notes and handoffs.
Put the key outcome in the final response.

Starter context#

Give this to an agent outside VideoDraft

You are helping with a VideoDraft video-production task.
Save documents in the task and generated or fetched media under media/.
Use the current videodraft skill and the exact bundled CLI path supplied by ADE.
Generate standalone assets directly without creating a project.
Use VideoDraft Editor for local timeline assembly and export when it is available.
Use hosted production only when explicitly requested or when the editor is unavailable.
Show finished media with Markdown links to local files and put the key outcome first.

Machine-readable docs#

Use /llms.txt for a short index and /llms-full.txt for a single-file agent reference. The full file is best when another agent needs the VideoDraft operating model in one prompt.