Autoloop Handoff

This page is generated from meta.autoloop in the canonical progress file: docs/content/building-gormes/architecture_plan/progress.json.

It keeps shared unattended-loop facts in one place so autonomous workers do not guess the entrypoint, plan, candidate source, generated docs, or selection policy from scattered prose. Row-specific execution facts stay in Agent Queue and canonical progress rows.

autoloop is intended to execute the building-gormes architecture plan. It selects work from progress.json, uses the generated building-gormes pages as the operator-facing handoff, and passes selected row metadata into worker prompts so the agent loop can develop the full gormes-agent one phase slice at a time. Do not maintain a parallel queue outside this docs tree.

Control Plane

• Entrypoint: scripts/gormes-auto-codexu-orchestrator.sh
• Plan: docs/superpowers/plans/2026-04-24-orchestrator-oiling-release-1-plan.md
• Candidate source: docs/content/building-gormes/architecture_plan/progress.json
• Agent queue: docs/content/building-gormes/autoloop/agent-queue.md
• Progress schema: docs/content/building-gormes/autoloop/progress-schema.md
• Unit tests: scripts/orchestrator/tests/run.sh unit

Candidate Policy

• Skip rows with blocked_by until ready_when is satisfied.
• Skip slice_size=umbrella rows until they are split.
• Default cmd/autoloop runs cap eligible roadmap work at Phase 3 unless MAX_PHASE is explicitly overridden.
• MAX_AGENTS is a safety cap: if fewer metadata-ready rows are available, run fewer workers instead of selecting filler or random work.
• Each worker runs in an isolated git worktree under RUN_ROOT/worktrees and promotion rejects committed paths outside the selected row’s write_scope.
• When git worktrees are available and MAX_AGENTS is greater than 1, cmd/autoloop launches selected workers concurrently, then validates and promotes each branch through the same ledgered safety gates.
• Prefer contract rows with write_scope, test_commands, and done_signal.
• Inject selected progress metadata into the worker prompt instead of asking workers to rescan the whole roadmap.