Godot Headless Workflow (Agent Development Loop)

The complete edit→validate→test→run→export loop for Godot projects without ever opening the editor. Every change must pass the headless gate before you claim it works.

Golden Rules

1. Never trust an edit you haven't validated headlessly. A script that looks right but was never parsed is not done.
2. GDScript only unless the project already uses C# (see godot-csharp-patterns). Pin the engine version in the project's AGENTS.md (e.g., Godot 4.7.2 stable, GDScript).
3. Scenes are text (.tscn/.tres) — editable by hand with care, or better, generated by tool scripts. See §Text Asset Safety.
4. Never touch .godot/ — it's a regenerable cache.
5. The editor GUI is optional. Use it (or the package's MCP bridge) only for visual layout iteration; logic, tests, and builds are all CLI work.

Prerequisites