← Corpus / augment-it / exploration
Design Language Audit — July 2026
The hand-counted baseline audit that measured the state of augment-it's CSS before the design system shipped. Superseded as the counting mechanism by design-drift.mjs.
- Path
- explorations/Design-Language-Audit-2026-07.md
- Tags
- Audit · Design-System · Historical
Design Language Audit — July 2026
Status: Superseded
This document is superseded as the counting mechanism. The drift script
(scripts/design-drift.mjs) is now the source of truth. Where the script and
this document disagree, the script is right. Every disagreement was in the
direction this document’s own lede predicted: understated.
This document remains in the record as the baseline measurement — the state of the product before Phases 0 and 1 landed. It is the “before” column in the verification table in the Phase 1 handoff.
The July 2026 baseline
Measured by hand against the full codebase on 2026-07-16, before any token work began.
What was measured
- 74 stylesheets across 16 remotes plus the shell
- 432 font-size declarations (35 distinct sizes)
- 158 button rule-sets across 13 recipes
- 34 badge treatments
- 6 spinner implementations with 4 different @keyframes names
- 30 box-shadow declarations (47% hardcoded, none mode-reactive)
- 25 z-index values spanning 0→200 with no scheme
- 99 unnamespaced selectors leaking across remote boundaries
- 33 dead fallback colours (fallbacks for tokens defined since May)
- 43
--color-bgdeclarations painting nothing on the live deploy - 10
outline: nonesites - 123 native
title=attributes (7 accessible) - 11 product-wide accessibility defects
Key findings that shaped Phases 0 and 1
-
The ramps lied.
--color__graphite-700was darker than-900on three of six greyscale ramps. Step numbers did not track luminance. This became gate A19, resolved in Phase 1. -
Five light-mode contrast failures.
--color-text-mutedat 4.37–4.49:1 fell below 4.5:1 against two surfaces. This was gate R11, resolved in Phase 1. -
Four phantom warn dialects. 22 declarations had independently invented
--color-warning-*,--color-warn, and other variants for one concept. -
Three competing focus treatments. Zero custom
:focus-visiblerings across the product. -
Federation was a documentation convention. F1 forbade members from declaring tokens, but every member imported
theme.cssindependently — the same race condition at runtime.
What the audit missed
- The Tier 1 consumption violations (F1a) — three files reading
var(--font__mono)directly. The audit grepped--color__only. - The two script bugs (CRLF and argv indexing) that would later produce confidently wrong output.
- The CRLF frontmatter parse failure that silently emptied the member registry.
These are recorded in the Phase 1 handoff (§4) — they were found by the drift script that this audit’s findings made necessary.