Build journal / Decisions and lessons
Notes
Engineering notes: things that broke, why the obvious defence failed, and what changed. Written from work that actually shipped.
-
Recorded repair ·
The contrast gate was checking a color I don't ship
A palette override entered the wrong token map. The fix made the contrast check evaluate each intended state separately.
-
Recorded repair ·
Every gate was green and the animations were gone
Visible content did not prove an animation existed. A build fix and computed-style checks closed that gap.
-
Public repair checkpoint ·
When --write and --check disagree, the formatter is the bug
A formatter changed embedded lesson code. Public commits show how I stopped the rewrite and repaired the examples with AI assistance.