bytelyst-devops-tools/agent-queue/docs/GIGAFACTORY
saravanakumardb1 41d8067724 feat(agent-queue): M0 RU gate — skip the claim when the queue is unchanged
Adds AQ_FLEET_GATE (default OFF): the run loop point-reads the cheap per-product
queue version (GET /fleet/queue-state) and SKIPS the expensive /fleet/claim while
the version is unchanged and it is not mid-drain, with a periodic safety backstop
and fail-open-on-read-error so work is never stranded. Keeps POLL_SECONDS for
local job responsiveness rather than raising it globally. selftest 39b covers the
gate decisions; reconciles the M0 section of the dispatch redesign doc.

Generated with [Devin](https://cli.devin.ai/docs)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-05-31 23:19:01 -07:00
..
FLEET_DISPATCH_REDESIGN.md feat(agent-queue): M0 RU gate — skip the claim when the queue is unchanged 2026-05-31 23:19:01 -07:00
GIGAFACTORY_ROADMAP.md docs(gigafactory): uppercase GIGAFACTORY folder + add index README 2026-05-30 21:21:31 -07:00
GIGAFACTORY_SYSTEM_OVERVIEW.md docs(gigafactory): uppercase GIGAFACTORY folder + add index README 2026-05-30 21:21:31 -07:00
README.md docs(gigafactory): add Phase-4 fleet dispatch redesign (broker + on-demand) 2026-05-31 22:24:55 -07:00

Gigafactory — Agent-Queue Docs

Source-of-truth specs and the system overview for Agent Gigafactory, the fleet-coordination layer that turns the single-host agent-queue runner into a multi-host factory of autonomous coding agents.

Contents

Doc What it is
GIGAFACTORY_ROADMAP.md The canonical source-of-truth spec: architecture, the evolved job manifest, scoring formula, lifecycle/retry, enrollment, and the phased checklists (§1§17). Job specs in ../jobs/ point here.
GIGAFACTORY_SYSTEM_OVERVIEW.md A narrative overview of how the pieces fit together end-to-end, with a code-map of the relevant files across both repos.
FLEET_DISPATCH_REDESIGN.md Phase-4 design proposal (no code): broker-backed (Azure Service Bus) dispatch + on-demand factories that fixes the product-as-queue routing smell and the idle-poll Cosmos RU cost. Phased migration starting with a zero-infra RU quick win.

The platform-service backend and the tracker-web UI live in learning_ai_common_plat. Its Gigafactory docs (roadmap-completion audit, remaining-task checklist, Phase-3 progress, and the fleet control-plane guide) are under docs/GIGAFACTORY/ there.