§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
| Id | Rule | Why | Rejected | Enforced by |
|---|---|---|---|---|
| D-01 | Components take colour, space, radius and size from tokens only | Brand is a parameter. One raw value breaks the switch | Per-brand component variants | check:raw-values |
| D-02 | Every figure on the site is a Claim referenced by id, with a base and a source | No number without its base | Figures typed into prose | check:claims |
| D-03 | Text 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 nothing | Checking the main brand only | check:contrast |
| D-04 | Every 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 gap | An optional column | check:decisions |
| D-05 | Tokens 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 mode | The repository is the source of truth; the design tool is a view | Tokens edited in the design tool | check:tokens (tz check, tz lint) |
| D-06 | No cookies and no third-party requests; fonts are self-hosted | Privacy without a cookie bar | Web fonts from a CDN; analytics with cookies | check:third-party |
| D-07 | Every content page has a Markdown twin at the same address plus .md | A 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 facts | A separate agent API | check:twins |
| D-08 | Generated files start with a marker that names the script and are never edited by hand | A hand edit is overwritten and hides driftA difference between the design system and what was built. | Committed hand-tuned output | check:generated (CI regenerates and diffs) |
| D-09 | No broken internal link | A dead link on the talk page costs the audience | Checking links by hand before launch | check:links |
| D-10 | A "Today against demo" row older than 90 days is marked stale | A dated claim rots | Undated rows | check:stale |
| D-11 | 2026 work is named only in the neutral wording of the naming register | Confidentiality agreed with the owner | Client names in text, files or commits | check:blocklist (list kept outside the repository) |
| D-12 | Site copy follows the voice mechanics: no em dash, no exclamation mark, no "we", no contractions | One person speaking, without the generated-text tells | Review by eye only | check:voice |
| D-13 | Status uses lightness, glyph and word, never hue alone | Colour alone fails some readers | Red and green status by hue | not enforced (gap) |
| D-14 | Brand and mode come from the address, then the system preference; the choice is never stored | Nothing to consent to | A cookie or local storage | not enforced (gap) |
| D-15 | A card's accent rule sits on top, never on the left | Avoid the look of generated sites | Left-border callouts | not enforced (gap) |
| D-16 | On a phone every table scrolls inside its box, the first column stays fixed and a hatched edge shows there is more | The content is tables; stacking breaks the comparison across columns | Stacked cards per row; shrinking text to fit | not 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.