Context capsules
Small, task-scoped pointers into docs/design/ and the code. Read the capsule that matches your
task instead of paying the full design-doc token cost up front.
Capsules are pointers, not copies. docs/design/*.md are the source of truth by contract area. If
a capsule and a design doc disagree, the design doc wins. Update the relevant design doc first,
then refresh the capsule’s section list if structure changed.
| Task | Capsule |
|---|---|
| Simulation, tick, services, AI, self-play harness | server-sim.md |
| Plain-language server architecture walkthrough | ../design/server-architecture-walkthrough.md |
| Rendering, input, HUD, client modules, teardown | client-ui.md |
| Wire messages, snapshot shape, fog filtering | protocol.md |
| Costs, supply, sight, unit/building stats | balance.md |
| Node integration tests, regression, client smoke | testing.md |
| Hardening limits, server bind, build/run pipeline | deployment.md |
| Server wiki route and generated stats reference | deployment.md |
Match history persistence and /api/matches | match-history.md |
| Multi-phase or phased implementation planning | planning.md |
Read the relevant design doc only when changing cross-file contracts (protocol ⇄ client,
Game API, balance mirror, fog rules). Otherwise, the capsule + the code is enough.
For new unit work, start with docs/new-unit-checklist.md, then read the task-specific capsules it references as each phase begins.
For any multi-phase or phased implementation plan, read planning.md before writing the plan.
For optional source-to-doc navigation, use the advisory routing map at ../doc-map.json. It points common source areas to likely relevant capsules and design docs, but it does not claim exclusive ownership or require a docs change for every mapped source change.