Skip to content

Work / Tic Tac Toe / Wiki / Decisions

designs-are-the-spec

Decisionverified 2026-09-22

The designs are the spec, though drawn after shipping

Decision

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.ts and src/constants/styles.ts are the exception — those files are compiled and shipped, and the drawing is a drawing of them.