§0register

Decisions

This site follows its own method. These are the 16 rules of this website, not general advice. Each rule names the check in the repository that enforces it. Where nothing checks a rule, the cell says not enforced (gap). A script fails the build when a cell is empty.

The footer of every page counts how many of these are enforced. That count comes from the checks, not from this page.

What the footer line means

Item Meaning
commit The version of the code that the page comes from.
site rules enforced How many of the 16 rules of this website have a check that runs at each build.
raw valuesA color, size or font written directly in the code, not taken from a token. Colors, sizes or fonts written directly in the code instead of taken from a tokenA named design value, for example a color or a spacing step, kept as data. DTCG 2025.10 gives the file format.. The target is 0.
unknown claims Numbers on the site that are not in the claims registry with a source. The target is 0.
contrast Brand and mode combinations where all text meets the WCAG contrast of 4.5:1. The site has four.

12 of 16 name a check · 4 gaps

IdRuleWhyRejectedEnforced by
D-01Components take colour, space, radius and size from tokens onlyBrand is a parameter. One raw value breaks the switchPer-brand component variantscheck:raw-values
D-02Every figure on the site is a Claim referenced by id, with a base and a sourceNo number without its baseFigures typed into prosecheck:claims
D-03Text contrast is at least 4.5:1 for every text and background token pair in all four permutationsOne combination of the modifier options. This site has four.Both brands must pass, or the switch proves nothingChecking the main brand onlycheck:contrast
D-04Every decisionA written choice of the team, with an id, a reason and the check that enforces it. On this site, a row of the register. has "Enforced byThe field of a decision that names the check that proves it, or says "not enforced (gap)"." or the literal "not enforced (gap)"An empty cell hides a gapAn optional columncheck:decisions
D-05Tokens are DTCGThe Design Tokens Community Group and its file format for design tokens, version 2025.10. A Final Community Group Report, not a W3C standard. 2025.10 files with one resolverThe part of a token set that selects the values for a context, for example a brand or a mode. and two modifiersA named choice in the resolver with its options. This site has two modifiers: brand and mode., brand and modeThe repository is the source of truth; the design tool is a viewTokens edited in the design toolcheck:tokens (tz check, tz lint)
D-06No cookies and no third-party requests; fonts are self-hostedPrivacy without a cookie barWeb fonts from a CDN; analytics with cookiescheck:third-party
D-07Every content page has a Markdown twin at the same address plus .mdA person and an agentAn AI program that writes and changes code, for example Claude Code or Cursor. On this site, "agent" means a coding agent. read the same factsA separate agent APIcheck:twins
D-08Generated files start with a marker that names the script and are never edited by handA hand edit is overwritten and hides driftA difference between the design system and what was built.Committed hand-tuned outputcheck:generated (CI regenerates and diffs)
D-09No broken internal linkA dead link on the talk page costs the audienceChecking links by hand before launchcheck:links
D-10A "Today against demo" row older than 90 days is marked staleA dated claim rotsUndated rowscheck:stale
D-112026 work is named only in the neutral wording of the naming registerConfidentiality agreed with the ownerClient names in text, files or commitscheck:blocklist (list kept outside the repository)
D-12Site copy follows the voice mechanics: no em dash, no exclamation mark, no "we", no contractionsOne person speaking, without the generated-text tellsReview by eye onlycheck:voice
D-13Status uses lightness, glyph and word, never hue aloneColour alone fails some readersRed and green status by huenot enforced (gap)
D-14Brand and mode come from the address, then the system preference; the choice is never storedNothing to consent toA cookie or local storagenot enforced (gap)
D-15A card's accent rule sits on top, never on the leftAvoid the look of generated sitesLeft-border calloutsnot enforced (gap)
D-16On a phone every table scrolls inside its box, the first column stays fixed and a hatched edge shows there is moreThe content is tables; stacking breaks the comparison across columnsStacked cards per row; shrinking text to fitnot enforced (gap)
§1use it

Copy the shape

The register is also served as JSON at /decisions.json. The columns are the ones I used on three projects: Rule, Why, Rejected, Enforced by. The pattern behind it: Enforced by.