bytelyst-devops-tools/agent-queue/docs/GIGAFACTORY
saravanakumardb1 2993994273 docs(gigafactory): reconcile overview + roadmap to current reality
- System overview: mark Phase 4 in-progress (M0 RU gate shipped), add
  fleet_queue_state container + GET /fleet/queue-state, document the heartbeat
  cadence vs 90s stale gotcha, the tracker-web caps=build form bug, the missing
  deregister API, and the ended=-race fix; drop the now-false "roadmap §0 stale"
  and "boxes 384/386 unticked" claims (both reconciled); link the redesign doc.
- Roadmap: §0 Phase 4 -> in progress (M0); align the Phase-2 §8 spec endpoint
  sketches to the as-built API (/fleet/factories/enroll, /factories/heartbeat,
  /fleet/claim) + note the heartbeat cadence and the M0 gate.

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

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-06-01 00:02:45 -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): reconcile overview + roadmap to current reality 2026-06-01 00:02:45 -07:00
GIGAFACTORY_SYSTEM_OVERVIEW.md docs(gigafactory): reconcile overview + roadmap to current reality 2026-06-01 00:02:45 -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.