Work / Tic Tac Toe / Wiki / Decisions
2026-09-19-designs-backfilled-after-shipping
Decisioncanonicalverified 2026-09-22
DECISION.2026-09-19.DESIGNS-BACKFILLED-AFTER-SHIPPINGDecision
The wireframes for this app were drawn from the shipped source, after release — and from 2026-09-19 onward the wireframe is nonetheless the spec.
Why
The house rule in ~/git/products/CLAUDE.md is that a screen with no HTML file
does not ship. This app shipped to Play and the App Store without any. Rather
than leave the set missing, it was backfilled by reading src/.
This is the one case in ~/git/products where the designs follow the code. It
is recorded rather than quietly fixed, because an undocumented exception is how
a rule stops being a rule.
Impact
- Where a wireframe and the app now disagree, the wireframe wins: fix the screen, or change the wireframe first and say so.
- Values mirrored from
src/constants/theme.tsandsrc/constants/styles.tsare the exception — those files are compiled and shipped, and the drawing is a drawing of them.
Status
Active.
Sources
- .context/designs/mobile/index.html
Every project of mine is written down like this.
Read the résumé