aa-autopilot

aa-autopilot

Resolve the Agent-Agile playbook root: use the first of these that exists — (1) ${CLAUDE_PLUGIN_ROOT}/playbooks, (2) ./.claude/agent-agile/playbooks, (3) ./.agents/agent-agile/playbooks, (4) ~/.claude/agent-agile/playbooks, (5) ~/.agents/agent-agile/playbooks, (6) ./playbooks.

Read playbooks/execution.md sections "Autopilot" (including "The ambiguity protocol"), "Circuit breakers", and "Resume protocol", and follow them exactly; do not re-derive or improvise the loop or soften a circuit breaker.

Wiring

1. Gate mode. Parse a --gate full-auto|checkpoint argument. If absent, use the gate field in .planning/CONFIG.md. If neither is set, the mode is interactive.
2. Preflight. Run the same collision check and PREREQS.md check as /aa-execute-epic's pre-flight, before the loop starts at all — an autopilot run never begins on an unchecked epic.
3. The loop. For each pending epic in .planning/ROADMAP.md, in order:
   • Run the /aa-plan-epic behavior to slice the next pending epic into worker-ready story cards.
   • Run the /aa-execute-epic behavior for that epic: Wave 0 through Verification.
   • Re-run the pre-flight prerequisite check for this epic specifically before Wave 1 launches — prerequisites can go stale between epics (a key expires, a quota runs out), so this is deliberate, not redundant with step 2.
   • Apply the gate for this epic:
     • Full-auto — the verifier's verdict stands in for the human: pass approves, a redo-list triggers the redo path. Demo briefs accumulate so a human can review the whole run's DEMO.md files at the end.
     • Checkpoint — the epic runs and verifies automatically; notify the user only between epics, at natural pause points, rather than gating every single one.
     • Interactive — stop and present DEMO.md and the verifier's verdict to the user at this epic, exactly as a standalone /aa-execute-epic run would.
   • On approve, the integrator has already written LEARNINGS.md and flipped the ROADMAP.md row (per Wave 2); move to the next pending epic.
   • On redo or replan, follow "The review gate" in playbooks/execution.md, then resume the loop from that epic once it re-verifies.
4. Circuit breakers. Follow the circuit breakers in playbooks/execution.md "Circuit breakers" exactly as written — never push through or work around one (a panel-refresh BLOCK left unresolved at slicing time also stops the loop, per playbooks/critics.md "Panel refresh"):
   • An epic fails verification even after its full redo — stop the autopilot loop entirely. The most an epic ever gets is: fail → scoped redo (if eligible) → fail → full redo → fail → stop.
   • A prerequisite goes missing mid-run — stop immediately, reset its PREREQS.md status to pending, and notify whoever needs to resupply it.
   • Never fake a credential and never silently mock a missing paid service.
5. Stopping. Whenever the loop stops — a circuit breaker, an interactive gate, the end of the roadmap, or a context reset — update .planning/STATE.md per "Resume protocol": what's in progress, what's next, the pointers the next session needs (at most three files), and the blocker if there is one. STATE.md must say exactly where the run stopped and why; the next session reads only this file to resume.