# 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`](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`](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`](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. |

## Related docs in the other repo

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.
