| name | src-audio-skill |
| description | Work on event-driven spatial audio, radio voices, engines, weapons, ambience, and mix state. |
claude-of-tanks / src/audio
Purpose
Translate canonical game-bus events and listener state into responsive spatial
audio without owning gameplay decisions.
Mental model & key files
audio.js owns Web Audio routing and synthesized/decoded effects;
voices.js owns crew-line scheduling and priority.
Patterns to follow / invariants
Initialize only after user gesture, subscribe through the injected bus, cap
voices/loops, and stop stale sounds on phase or entity teardown.
Common tasks → first action
Trace the originating bus event, verify payload semantics, then test scheduler
timing and live pause/phase behavior. Use audioTiming.selftest.mjs for pure
contracts, tools/audio-spatial-killcam-probe.mjs for listener/distance PCM,
and tools/audio-probe.mjs for the canonical event and bus matrix.
Gotchas
Camera direction and occupied-tank position form a hybrid listener. Network
events may arrive late or duplicated, so presentation must key/dedupe them.
Scope is an interior/headset perspective, never a mute. Keep the occupied
engine regardless of distance, rank capped remote engines by proximity, and
tear all world loops down when leaving battle.
