Auto Warz¶
Design documents, technical architecture, and the open items register for a factory automation, space exploration and RTS game built in Godot 4.
Internal use only. Not for distribution.
Start here¶
| Document | Read it when |
|---|---|
| Canonical Design Facts | Always, before any design question. One page of load-bearing decisions. Where any document disagrees with it, it wins and the other document is wrong. |
| Open items | Picking up work. The only place open work lives — if it isn't there, it doesn't exist. |
| Master GDD | Getting the overall shape |
| Data Dictionary | Checking what a term means, and which words are deprecated |
Precedence¶
- Canonical Design Facts — the design source of truth
AGENTS.mdin the repo root — what the code actually does today- Everything else — the detail behind both
Where Canonical Design Facts and AGENTS.md disagree, that is a real
divergence between code and design, not an error to paper over. The live ones
are listed in AGENTS.md under Known Code/Design Divergences.
How this site works¶
Git is the source of truth. This site renders the docs/ folder and never
authors it. Every page has an edit link that opens the file on GitHub.
The register pages are generated from the same markdown the vault uses, so the site can never show a different set of open items than the repo does.
Dark only, deliberately
The Auto Warz palette is dark-native. Accent Orange is 2.2:1 on white and Emissive Cyan 1.9:1, both far below WCAG AA. A light scheme would mean inventing colours outside the nine locked in Canonical Design Facts section 6.
Current position¶
M2.3 (Pipe System) is the last milestone formally marked complete, on
13 March 2026. The roadmap records nothing after that and is several months
behind — treat its "current milestone" as wrong. AGENTS.md carries the
accurate picture, read from the code.