| name | src-game-skill |
| description | Work on battle integration, bots, input, garage dressing, progression, replays, and studio state. |
claude-of-tanks / src/game
Purpose
Own game-level orchestration between pure simulation, presentation, input, bots,
and persisted player choices.
Mental model & key files
state.js composes legacy solo entities and the fixed battle step; ai.js owns
bot decisions and is injected into the headless multiplayer authority;
input.js normalizes devices; profile.js persists real local match history;
killcam.js and studio.js own separate presentation timelines.
Patterns to follow / invariants
Keep authoritative rules deterministic and Node-runnable. Inject world, bus,
RNG, and presentation dependencies. Multiplayer work must move visual creation
out of authority rather than importing more UI into state.js.
Common tasks → first action
Trace callers in src/main.js, run the nearest selftest, and preserve existing
event payloads. Bot changes require both focused AI tests and battle probes.
Gotchas
state.js currently mixes headless and visual responsibilities; deepen the
simulation seam incrementally. Entity IDs historically equal spec IDs and must
not remain so in multiplayer.
