bytelyst-devops-tools/agent-queue/docs/GIGAFACTORY
saravanakumardb1 9f24a7fdd0 docs(gigafactory): add error-handling & cleanup section + v3 review fixes
Adds §5.5 (lease-release-on-failure, branch/worktree GC, same-repo worktree
clobber) with target invariants, plus a §12 checklist block. v3 review:
unify targetFactoryId, reconcile §5.3 with complete-on-claim, align §6 token
scoping with per-factory subscriptions, M0 wording.

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

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-05-31 22:45:21 -07:00
..
FLEET_DISPATCH_REDESIGN.md docs(gigafactory): add error-handling & cleanup section + v3 review fixes 2026-05-31 22:45:21 -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.