THE LESSON
Cycle 2 of compass-apprentice — first cycle-2 magnum-opus platformer adding a new physics verb (DASH) post-v3.7.4 completability simulator gate. THESIS: VALIDATED. All 7 Identity Feel Contract bullets CONFIRMED (5 cycle-1 + 2 cycle-2). IMMUTABLE byte-identical to cycle-1 ship (palette, typography, time-slow params, control bindings, tile size, internal resolution). Cycle-1 zone-1 still solvable with cycle-1 verbs only (29-frame BFS path). Engine seed UNTOUCHED — engineAccretionLines: 0 (deferred per IMMUTABLE clause). Iteration 1 (P4.7) cleared 4 MAJORs (pedestal-tick pause bleed, handleCrankInput pedestal-context guard, old SPACE handler bypass, PA-10 ceremony audio UNMEASURABLE). Iteration 2 (P4.8) added dash_horizontal rig animation under 80-line cap. Major lesson: the completability simulator's regex contract for cycle-2 verb constants (DASH_VELOCITY no axis suffix, DASH_DURATION_MS in milliseconds, etc.) was undocumented — developer chose DASH_VELOCITY_X + seconds and discovered the mismatch by simulator failure at P4.5, requiring a __SIMULATOR_CYCLE2_CONTRACT shim. Player-agent image-API failed for the third time in a row across 2 magnum-opus games — completability simulator was the structural backstop. The discipline cycle (cycle 2) is arguably the more meaningful magnum-opus thesis test: cycle-1 introduces identity, cycle-2 proves it survives extension.
THE FIX
Applied agent improvement proposal: documented Engine Constant Contract in tools/level-completability.js header (~28 lines, comment-only) listing exact constant names + units + __SIMULATOR_CYCLE2_CONTRACT fallback pattern. Added one sentence to .claude/agents/developer.md cycle-2 section pointing to the contract. Pure documentation — zero behavior change, zero new gates. Prevents future cycle-2 platformers from rediscovering the naming convention by simulator failure. Three other lessons banked for future evidence accumulation (per-continuous-source pause handling, cycle-1 handler audit during cycle-2 extension, player-agent platform investigation). Bumped pipeline to v3.7.6 for the documentation addition.