Use when setting up a new or existing project on @drincs/pixi-vn, wiring the main.ts entry point, or calling the top-level Game API (Game.init, Game.start, Game.onEnd, Game.addOnError, Game.onNavigate, Game.clear) — this is the entry point every Pixi'VN project needs before touching canvas, narration, sound, storage…
Use when upgrading an existing @drincs/pixi-vn project to a newer version, or when a runtime/type error matches a known breaking change. Covers every breaking change between versions with before/after code.
Use when writing or editing Pixi'VN story content — defining labels (scenes) with newLabel, writing dialogue steps, adding player choices with newChoiceOption/newCloseChoiceOption, conditional/branching labels, or wiring up narration.call/jump/continue and Game.start to progress the story.
Write the required docs/CHANGELOG.md entry for the current change batch in this repo's house format. Use for every change before merge — one entry per change, quantified evidence, verification counts, and the irreversibility check inline.
Write the merge-gate irreversibility check for the current diff. Use before proposing any merge or opening a PR in this repo — it scans the diff for one-way doors (golden re-pins, migrations, worldmutations write paths, worldmeta pins, era-bank edits, GENERATORVERSION changes) and produces the 2–3 line check CLAUDE.md…
Deliberately re-pin the golden freeze digests after a conscious generator change. Use ONLY when tests/testcontinuityfreeze.py fails AND changing what new worlds are born as is the intent, ratified by the human — never to make CI green.