DOCS/OPERATIONS & PUBLISHING/Autonomous Agent Guide

Autonomous Agent Guide

Driving the engine with Claude Code, Antigravity, or Cursor using AGENTS.md.

Shotrunner is designed to be directed autonomously by AI coding agents. Every CLI tool is deterministic, returning clear gate output and structured exit codes.

Supported AI Agents

Any agent environment with terminal execution and file editing capabilities can orchestrate the pipeline:

•Claude Code
•Google Antigravity
•Cursor
•OpenHands
•Windsurf
•GitHub Copilot Workspace

AGENTS.md Orchestrator Rules

The root AGENTS.md file instructs your agent on state transitions and subagent spawning:

•
State Ledger Check: Read series/<series>/logs/<slug>.log before executing. Never re-run a stage marked as PASS.
•
Parallel Subagent Spawning: After Stage 02 PASS, spawn the Audio Subagent (03 → 04) and Visual Subagent (05 → 06 → 07) concurrently.
•
Automated Self-Correction: On gate failure (e.g. word count, missing phoneme), read stderr, repair the file, and re-run (max 2 retries).
•
Upload Permission Gate: Never upload to YouTube without asking for explicit user confirmation first.

Prompt Patterns

Agent Prompts

1# Run automated topic discovery for a series

2run curious-corners

4# Direct research toward a specific event

5run mini-stories about the deepest underwater submarine rescue

7# Produce a short on an anime character

8run frieren-beyond-journeys-end about the ancient hero Kraft

Was this "Autonomous Agent Guide" page helpful?

CLI Reference

Complete command matrix and syntax for all 16 shorts CLI subcommands.

YouTube Publishing

Permission-gated uploads, channel auto-resolution, tags, and OAuth management.