Orienting overview of the gkz deterministic simulation kernel — what it is, its determinism contract, the mental model (a LIBRARY you drive by writing Zig + a measure-and-iterate loop), and when to reach for it. Read this first before authoring or driving a gkz sim.
How to AUTHOR a gkz simulation in Zig — define a Registry + components, write systems (SimCtx + Query), emit events, declare specs (invariants + metrics), build a seed→World, and the determinism rules you must respect. Use when writing or editing the simulation core of a gkz game. Anchored on examples/roguelike/src/game.zig.
How to DRIVE and MEASURE a gkz sim in Zig — the author's loop: step + observe, snapshot/replay, fork to A/B a tweak, sweep a metric across seeds, VOPR a defect into a minimal repro, and read provenance. Use when running/measuring/iterating on a gkz game (write a Zig harness or test; there is no CLI). Anchored on examples/roguelike/src/main.zig.