Skip to content

refactor(user-interface): move literal measurements in the references into config #14214

Closed

Description

@kyle-sexton

Parent

Source: its own interview on 2026-11-08, split from the Emil Kowalski upstream-sync effort.

Depends on

Outcome

A team changes any user-interface taste measurement through one config key, every floor and constant stays stated, and a downstream repository's conventions win.

Demo: Open a reference that held a taste measurement and see it name a config key instead; set that key in a team config, and see a downstream repository's own token win over it.

Problem:

  • Gap: most user-interface measurements are stated inline, so a team cannot change them through config and agents treat them as fixed unless the project has its own token.
  • Who / how many: teams and repositories using the user-interface plugin; count unknown.
  • Frequency, trend, cost: unknown.
  • Evidence: 32 reference and skill files hold about 198 lines with px values, and about 252 more lines hold other units, from rough greps (observed). Agents treating inline values as fixed (inferred).

Goal: A team changes any user-interface taste measurement through one config key, every floor and constant stays stated, and a downstream repository's conventions win.

  • Intent (why, in the user's words): "Everything should be configurable and extensible. We should never be hardcoding specific font sizes or ranges or any specific measurements and approaches."
  • Vision (where this heads): Everything is configurable, one source of truth.
  • When goals conflict, prefer: alignment over throughput

This item goes through the full human-in-the-loop chain with the owner at each gate. The interview is done; explore, research, design, plan and spec remain.

Constraints:

  • Production quality bar. Uniform and consistent, DRY, one source of truth, across the repository, plugins and skills. Highest accuracy and coverage.
  • Fact-based and fact-validated.
  • A downstream repository's conventions win over every layer: its design system, conventions, lint config and layer system.
  • Provenance only in upstream records and changelog fragments.
  • Nothing is added to CI unless it is 100 percent needed; any CI addition comes to the owner first.
  • Mechanism details are settled at planning.

Decisions

Terms:

  • Example: a value shown only to illustrate a technique or a bug.
  • Floor: a minimum or limit backed by a standard or measurement, accessibility or not.
  • Taste: a value chosen because it looks or feels right, with no measured requirement.
  • Constant: a value true by definition, with nothing to configure.
  • Heuristic: an openly unmeasured value.
  • Role key: a key named for what a value is used for. Scale: an ordered set of steps for one kind of value.

Scope:

  • A measurement is any number a team could reasonably choose differently, in any unit or none. Numbers that only count things in prose stay out.
  • Coverage is the plugin's references, skill references, SKILL.md bodies and scripts. Tests, fixtures and evals change only where the move breaks them.
  • Non-numeric approaches stay out; an approach gets a key when a specific rule calls for it.
  • Only this plugin's values move. Explore lists any plugin that repeats a value this plugin teaches, and that list becomes a follow-up ticket.

Keys and homes:

  • One key per role or scale, shared by every mention. A real difference between mentions becomes separate roles.
  • A reference names only the key. Existing key-plus-default text is rewritten; the README Default column stays.
  • Default values live in reference/defaults.yaml. Each floor has one stated home with its source, other prose points there, a code example keeps its number, and a schema minimum may repeat a floor. The defaults test and README are the only other copies.

Defaults:

  • Order: the course record on a conflict, then Emil Kowalski's latest source (his skills repository, posts and AI for UI course), then today's number. Other sources count as today's number with their source kept.
  • Where mentions differ and he is silent, research picks; with no research answer, use the most common number and label it heuristic.
  • A floor holds over any of these. Research covers every key, existing keys included.
  • The owner receives a list of every default whose shipped number changes and every heuristic.
  • A value with no upstream records its source in one links-only record under docs/upstream.
  • 16px stays a floor: body text is backed by USWDS typography, and inputs by the WebKit source constant. A stated minimum with nothing behind it is taste until research finds a source. A taste key bounded by a floor gets a schema minimum.

Which value applies, for every skill:

  • A matching project token, then a key set by a team or person, then css.token_fallback when tokens of that kind exist, and the plugin default only with no tokens of that kind.
  • The key's plugin default is the number the fallback carries, and replaces "use your own values" wherever a key exists. An agent picks a number only where no key exists.
  • Scripts use what the caller passes. A skill that cannot run the resolver reads the shipped defaults file. The glossary's common-usage numbers stay examples.
  • A project value below a floor stands, and the audit reports it.

Settled later: how the audit reports each floor and what a re-pin does (design, returned to the owner if either changes scope); what the one-time check scans and how keys are shaped (planning).

Key interfaces

  • The plugin's defaults file holds new keys, the team schema validates them, and the plugin README lists them, in snake_case, through the existing cascade.
  • The cascade's layers are plugin defaults, userConfig, team and personal.

Done when

  • The full chain has run for this item, with the owner at each gate: interview, /discovery:explore, /discovery:research, design, /planning:plan, and spec.
  • The list classifying every measurement in scope as example, floor, taste or constant is published in this issue, borderline values went to the owner, and the owner reviewed it at the plan gate before any value moved.
  • Every taste value resolves through one role or scale key, and a reference names the key without restating its default.
  • Every default follows the Defaults order, records its source, and research covered every key; the owner received the list of changed defaults and heuristics.
  • Every floor is stated with its source in one home, and the audit reports a project value below a floor.
  • A one-off run on a scratch copy of the with-ds fixture, with a measurement token and a team key for the same role, outputs the token's value; the result is in the pull request and nothing is committed for it.
  • No new test or CI check is added: each new key is in the existing defaults test, a review rule covers new inline taste values and key names, and a one-time build check stops the change if a named key is missing.
  • The README's layer table matches the cascade source, and the setup skill no longer offers a write to the user-global file the cascade does not read.
  • The follow-up ticket for plugins that repeat these values is filed.
  • gh issue view <n> --json labels shows needs-human until the owner has been through the chain for this item.

Out of scope

Activity

  1. added
    needs-humanHuman-in-the-loop required; autonomous sessions must not resolve items carrying this.
    on Nov 8, 2026
  2. added theissue type on Nov 8, 2026
  3. kyle-sexton commented on Nov 9, 2026

    @kyle-sexton
    MemberAuthor

    Classified measurements (issue 14214)

    For the owner's review at the plan gate, before any value moves (AC1, AC2, AC8). Paths are under plugins/user-interface/. Generated from the role map.

    Counts: 1,222 rows in 64 files before excluding prose counts: 313 taste, 585 example, 201 constant, 61 floor, 62 not a measurement (excluded). Of the 313 taste numbers, 105 sit in code blocks. The design record's 316 counted one show-and-hide line as four numbers; here it is one.

    Legend for the list: T taste, E example, F floor, C constant; a trailing c means the number is in a code block; → names the key.

    Key set

    100 roles in 111 leaves. min is a schema minimum. One shipped key value changes: animation.easing.out.

    key type default basis
    animation.blur_max_px int 20 course
    animation.blur_px.soften number 2 course
    animation.delay_ms.group_warm int 300 course
    animation.delay_ms.tooltip int 200 course
    animation.delay_ms.indicator int 150 course
    animation.duration_ms.exit_factor number 0.8 course
    animation.duration_ms.hover int 150 course
    animation.duration_ms.large int 300 course
    animation.duration_ms.medium int 250 course
    animation.duration_ms.press int 160 course
    animation.duration_ms.small int 200 course
    animation.easing.in list 4 0.3, 0, 1, 1 heuristic
    animation.easing.out list 4 0.32, 0.72, 0, 1 (changed) course
    animation.easing.spring_stand_in list 4 0.25, 0.1, 0, 1 course
    animation.gesture.deceleration_rate number 0.998 Emil
    animation.gesture.rubberband_constant number 0.55 Emil
    animation.gesture.slop_px int 10 Emil
    animation.gesture.velocity_threshold number 0.11 Emil
    animation.inspect_playback_rate number 0.1 Emil
    animation.scale.enter number 0.95 course
    animation.scale.enter_small number 0.97 course
    animation.scale.hover_max number 1.02 course
    animation.scale.press number 0.97 Emil
    animation.scale.swap_start number 0.3 course
    animation.skip_frequency int 100 course
    animation.spring.bounce.default number 0 course
    animation.spring.bounce.playful_max number 0.3 course
    animation.spring.duration_s.default number 0.5 course
    animation.spring.duration_s.small number 0.35 course
    animation.spring.response_s list 2 0.3, 0.4 Emil
    animation.stagger_ms.interval int 40 course
    animation.stagger_ms.max_total int 400 course
    animation.stagger_ms.section int 100 course
    animation.stagger_ms.word int 80 course
    animation.travel_px.large int 16 course
    animation.travel_px.medium int 8 course
    animation.travel_px.small int 4 course
    color.border.dark_solid_l number 0.285 course
    color.border.light_alpha number 0.08 course
    color.dark_mode.brand_desaturation_percent list 2 20, 30 course
    color.hover_mix_percent number 15 course
    color.illustration_max_colors int 3 course
    color.overlay_alpha number 0.2 course
    color.ramp.chroma_percent list 2 (ends, peak) 30, 85 course
    color.ramp.endpoints_l list 2 (lightest, darkest) 0.97, 0.22 course
    color.ramp.hue_spread_max_deg int 10 course
    color.subtle_mix_percent number 12 heuristic
    color.triage.light_surface_min_l number 0.6 course
    color.triage.near_black_l list 3 (surface max, text min, mid-tone min) 0.25, 0.75, 0.3 course
    color.triage.near_white_l list 2 (surface min, text max) 0.85, 0.45 course
    css.border_px.hairline number 0.5 course
    css.border_px.standard number 1 course
    css.border_px.strong number 2 independent
    css.concentric_radius.max_gap_px int 24 course
    css.edge_fade.length, .stops_percent string; list 2 2rem; 10, 90 independent
    css.focus_ring.offset_px int 2 course
    css.focus_ring.width string max(2px, 0.08em) course
    css.image_outline.opacity number 0.1 course
    icon.filled_below_px int 12 course
    icon.label_gap_px list 2 6, 8 course
    icon.size_em number 1 independent
    icon.size_px list 12, 16, 20, 24, 48 heuristic
    layout.breakout_width string 80rem heuristic
    layout.content_width string 1200px course
    layout.grid_track_min_width string 16rem heuristic
    layout.media_aspect_ratio string 16 / 9 heuristic
    layout.media_small string 3.5rem heuristic
    layout.panel_max_height string 80dvh heuristic
    layout.sidebar_width list 2 (ideal, wrap share) 20rem, 50% heuristic
    layout.simple_page_columns int 8 course
    layout.terminal_min_columns int 80 independent
    layout.z_index_stray_above int 100 course
    performance.image_max_kb int 300 course
    performance.search_debounce_ms int 300 course
    performance.virtualize_min_items int 50 course
    radius.l string 1.25rem heuristic
    radius.s string 4px course
    spacing.control_padding list 2 (block, inline) 0.75rem, 1.25rem heuristic
    spacing.flow list 3 (paragraph, before heading, after heading) 1lh, 2em, 0.5em course; heading parts heuristic
    spacing.l string 2rem independent
    spacing.m string 1.5rem independent
    spacing.optical_icon_px int 2 course
    spacing.s string 1rem independent
    spacing.section list 2 (fluid, fallback) clamp(3rem, 1rem + 6vw, 8rem), 6rem heuristic
    spacing.xs string 0.5rem course
    states.copy_confirm_ms int 1500 course
    states.toast_reading_wpm list 2 200, 250 course
    states.wait_indicator_ms int 400 course
    touch.check_width_px int 375 course
    touch.fixed_width_hunt_px int 340 course
    touch.target_desktop_px int, min 24 40 course
    typography.fluid_body.min_rem (min 1), .preferred_rem, .preferred_vw, .max_rem number 1, 0.75, 1, 1.75 heuristic
    typography.fluid_scale.narrow_rem, .wide_rem, .size_narrow_rem (min 1), .size_wide_rem, .ratio_narrow, .ratio_wide, .space_m_factor, .space_l_factor number 20, 77.5, 1.125, 1.25, 1.2, 1.25, 1.5, 2 heuristic
    typography.fluid_max_ratio number 2.5 heuristic
    typography.line_height.body list 2 1.5, 1.6 course
    typography.line_height.display number 1.1 course
    typography.measure_ch int 65 course
    typography.small_text_px.caption int 13 course
    typography.small_text_px.control int 14 course
    typography.small_text_px.min int 12 course

    Mentions that are not a direct swap

    248 of the 313 taste numbers equal their key's default, directly or by unit. The other 65 are below: 30 changed, 18 listed, 4 negated, 6 scaled by key, 6 derived, 1 complement.

    Owner answers, plan Q6 and Q7. A duration key is both the value a recipe writes and the role's ceiling, so recipes below a role's upper end move to it. The derived damping rows stay examples and keep their numbers. Plan Q9: the 9:1 pair stays a floor at guidance standing; the 2.5 fluid ratio at skills/write-css/reference/foundations.md lines 234, 235, 296 and 297 is taste under typography.fluid_max_ratio; the 44 finger-pad sentence is removed and the 44 floor stays. A listed number is recorded on the key's row, negated and scaled by key are written as expressions, and complement is rewritten to hold the key's own quantity.

    form where shipped text key default
    changed reference/animation/behaviors.md:28 ~150ms animation.duration_ms.press 160
    changed reference/animation/behaviors.md:28 0.96 animation.scale.press 0.97
    changed reference/animation/behaviors.md:53 150ms animation.duration_ms.medium 250
    changed reference/animation/behaviors.md:53 200ms animation.duration_ms.medium 250
    changed reference/animation/behaviors.md:80 ~125ms animation.duration_ms.small 200
    changed reference/animation/behaviors.md:101 0.96 animation.scale.enter 0.95
    changed reference/animation/behaviors.md:102 200ms animation.duration_ms.large 300
    changed reference/animation/behaviors.md:102 250ms animation.duration_ms.large 300
    changed reference/animation/behaviors.md:134 200ms animation.duration_ms.large 300
    changed reference/animation/behaviors.md:134 250ms animation.duration_ms.large 300
    changed reference/animation/behaviors.md:211 ~250ms animation.duration_ms.large 300
    changed reference/animation/behaviors.md:234 3px animation.blur_px.soften 2
    changed reference/animation/performance.md:218 5px animation.blur_px.soften 2
    changed reference/types/web/icons.md:85 about 1px spacing.optical_icon_px 2
    changed reference/types/web/icons.md:153 0.5em icon.label_gap_px 6, 8
    changed skills/audit/reference/frame-capture.md:112 0.25x animation.inspect_playback_rate 0.1
    changed skills/write-css/reference/interaction.md:267 0.2s animation.duration_ms.medium 250
    changed skills/write-css/reference/layout.md:35 64rem layout.content_width 1200px
    changed skills/write-css/reference/motion.md:30 2px animation.travel_px.small 4
    changed skills/write-css/reference/motion.md:34 200ms animation.duration_ms.medium 250
    changed skills/write-css/reference/motion.md:58 200ms x2 animation.duration_ms.large 300
    changed skills/write-css/reference/motion.md:251 200ms animation.duration_ms.medium 250
    changed skills/write-css/reference/show-and-hide.md:45 0.2s animation.duration_ms.large 300
    changed skills/write-css/reference/show-and-hide.md:51 0.2s animation.duration_ms.medium 250
    changed skills/write-css/reference/show-and-hide.md:174 150ms animation.duration_ms.medium 250
    changed skills/write-css/reference/show-and-hide.md:185 125ms animation.duration_ms.small 200
    changed skills/write-css/reference/show-and-hide.md:198 125ms animation.duration_ms.small 200
    changed skills/write-css/reference/show-and-hide.md:199 125ms animation.duration_ms.small 200
    changed skills/write-css/reference/text-and-media.md:193 0.5em icon.label_gap_px 6, 8
    changed skills/write-css/reference/text-and-media.md:205 0.5em icon.label_gap_px 6, 8
    complement reference/types/web/color.md:135 85% color.hover_mix_percent 15
    derived reference/animation/gestures.md:87 1.0 animation.spring.bounce.default 0
    derived reference/animation/gestures.md:88 0.8 animation.spring.bounce.playful_max 0.3
    derived reference/animation/gestures.md:89 1.0 animation.spring.bounce.default 0
    derived reference/animation/gestures.md:90 0.8 animation.spring.bounce.playful_max 0.3
    derived reference/animation/gestures.md:91 0.8 animation.spring.bounce.playful_max 0.3
    derived reference/animation/gestures.md:92 1.0 animation.spring.bounce.default 0
    listed reference/animation/behaviors.md:24 0.95 animation.scale.press 0.97
    listed reference/animation/behaviors.md:24 0.98 animation.scale.press 0.97
    listed reference/animation/behaviors.md:29 0.95 animation.scale.press 0.97
    listed reference/animation/behaviors.md:102 0.97 animation.scale.enter 0.95
    listed reference/animation/behaviors.md:253 ~300ms animation.spring.duration_s.small 0.35
    listed reference/animation/catalog.md:156 0.9 animation.scale.enter 0.95
    listed reference/animation/catalog.md:156 0.97 animation.scale.enter 0.95
    listed reference/animation/catalog.md:371 30ms animation.stagger_ms.interval 40
    listed reference/animation/catalog.md:371 50ms animation.stagger_ms.interval 40
    listed reference/animation/catalog.md:379 50ms animation.stagger_ms.interval 40
    listed reference/animation/gestures.md:74 0.1 animation.spring.bounce.playful_max 0.3
    listed reference/animation/gestures.md:121 0.99 animation.gesture.deceleration_rate 0.998
    listed reference/types/web/layout.md:93 1px spacing.optical_icon_px 2
    listed reference/types/web/typography.md:127 45-75 typography.measure_ch 65
    listed reference/types/web/typography.md:131 about 75 typography.measure_ch 65
    listed reference/types/web/typography.md:259 75 characters typography.measure_ch 65
    listed reference/types/web/typography/line-behavior.md:9 45-75 typography.measure_ch 65
    listed skills/write-css/reference/show-and-hide.md:88 0.97 animation.scale.enter 0.95
    negated reference/animation/behaviors.md:62 -4px animation.travel_px.small 4
    negated reference/animation/behaviors.md:207 -8px animation.travel_px.medium 8
    negated reference/types/web/shape-and-depth.md:301 -1px css.border_px.standard 1
    negated skills/write-css/reference/motion.md:247 -4px animation.travel_px.small 4
    scaled by key reference/animation/behaviors.md:211 ~150ms animation.duration_ms.exit_factor 0.8
    scaled by key reference/animation/catalog.md:260 20-30% animation.duration_ms.exit_factor 0.8
    scaled by key skills/write-css/reference/show-and-hide.md:35 0.16s animation.duration_ms.exit_factor 0.8
    scaled by key skills/write-css/reference/show-and-hide.md:168 120ms animation.duration_ms.exit_factor 0.8
    scaled by key skills/write-css/reference/show-and-hide.md:169 120ms animation.duration_ms.exit_factor 0.8
    scaled by key skills/write-css/reference/show-and-hide.md:191 100ms animation.duration_ms.exit_factor 0.8

    Heuristics

    • animation.easing.in: 0.3, 0, 1, 1
    • color.subtle_mix_percent: 12
    • icon.size_px: 12, 16, 20, 24, 48
    • layout.breakout_width: 80rem
    • layout.grid_track_min_width: 16rem
    • layout.media_aspect_ratio: 16 / 9
    • layout.media_small: 3.5rem
    • layout.panel_max_height: 80dvh
    • layout.sidebar_width: 20rem, 50%
    • radius.l: 1.25rem
    • spacing.control_padding: 0.75rem, 1.25rem
    • spacing.flow: 1lh, 2em, 0.5em
    • spacing.section: clamp(3rem, 1rem + 6vw, 8rem), 6rem
    • typography.fluid_body.min_rem (min 1), .preferred_rem, .preferred_vw, .max_rem: 1, 0.75, 1, 1.75
    • typography.fluid_scale.narrow_rem, .wide_rem, .size_narrow_rem (min 1), .size_wide_rem, .ratio_narrow, .ratio_wide, .space_m_factor, .space_l_factor: 20, 77.5, 1.125, 1.25, 1.2, 1.25, 1.5, 2
    • typography.fluid_max_ratio: 2.5

    Class doubts and borderline values

    Each line gives the class used and the doubt. Paths here are from the repository root.

    No class was changed here. Each line gives the class used and the doubt.

    Same kind of number, classed differently across drafts:

    • Code recipe literals. The motion and other drafts class write-css recipe literals taste, because those files call them "this skill's defaults". The layout-type draft classes every code block under reference/types/web/ example. So hover 150ms is taste at plugins/user-interface/reference/animation/catalog.md:200,266 and example at plugins/user-interface/reference/types/web/shape-and-depth.md:153 and plugins/user-interface/reference/types/web/typography/details-and-floors.md:28.
    • Focus ring 2px. Taste at plugins/user-interface/skills/write-css/reference/interaction.md:27,28, example at plugins/user-interface/reference/types/web/accessibility.md:79,80. WCAG 2.2 SC 2.4.13 (Level AAA) requires the indicator to be "at least as large as the area of a 2 CSS pixel thick perimeter" (Understanding 2.4.13), so 2px may be a floor at AAA. Neither research run covered it.
    • 1px lines. Example at plugins/user-interface/reference/types/web/color.md:29,215,218,221,226,234 and plugins/user-interface/skills/write-css/reference/spacing-and-shape.md:154; taste at plugins/user-interface/reference/types/web/shape-and-depth.md:122,126,203,228.

    Other doubts, from the four drafts' Borderline sections:

    • plugins/user-interface/reference/animation/behaviors.md:42,43,126,176,192-195,222,223,242-245: example; plugins/user-interface/reference/animation/behaviors.md:13 says "keep the values" and plugins/user-interface/reference/animation/catalog.md:16-18 says "never a template to copy", and one needs rewording either way.
    • plugins/user-interface/reference/animation/behaviors.md:253: taste; the line says "such as", which reads as example.
    • plugins/user-interface/reference/animation/catalog.md:289 (200ms): example; line gives a reason, which reads as taste.
    • plugins/user-interface/reference/animation/catalog.md:34, plugins/user-interface/reference/types/web/states.md:135,137,154, plugins/user-interface/skills/audit/reference/launch-scope.md:385 (400ms): taste; a floor if a responsiveness source backs it.
    • plugins/user-interface/reference/animation/gestures.md:120,121,135: taste; constants if the WWDC source fixes them.
    • plugins/user-interface/reference/animation/catalog.md:563, plugins/user-interface/skills/audit/reference/frame-capture.md:112: taste; review procedure, which reads as example.
    • plugins/user-interface/skills/write-css/reference/interaction.md:135, plugins/user-interface/reference/types/touch-web.md:149,170,171 (24px): example; the owner ruled 24 the AA floor.
    • plugins/user-interface/reference/types/touch-web.md:149 (44px finger pad): floor; X2 found no source stating it.
    • plugins/user-interface/reference/types/web/shape-and-depth.md:131-144,170 (elevation alphas): example; reads as taste.
    • plugins/user-interface/reference/types/web/shape-and-depth.md:297 (10% image outline): taste; the file says "not up for theming".
    • plugins/user-interface/reference/types/web/typography/details-and-floors.md:24-26 (underline), plugins/user-interface/reference/types/web/typography/scale-and-rhythm.md:96,102 (tracking), plugins/user-interface/reference/types/web/icons.md:39-43 (stroke), plugins/user-interface/reference/types/web/accessibility.md:205 (200ms exit delay): example; reads as taste.
    • plugins/user-interface/reference/types/web/layout-stability.md:149,150 (font weights): constant; the sentence says "adjustable globally".
    • plugins/user-interface/reference/types/web/layout.md:112 (8), plugins/user-interface/reference/types/web/icons.md:216 (about 3), plugins/user-interface/reference/types/web/component-api.md:87,320: counts in prose under one reading; the first two are classed taste, the last not-a-measurement.
    • plugins/user-interface/reference/types/web/states.md:251 (200-250 wpm): taste; measured if a source is cited.
    • plugins/user-interface/reference/types/terminal.md:104 (80): taste; a convention, which reads as constant.
    • plugins/user-interface/reference/types/web/color.md:135, plugins/user-interface/skills/write-css/reference/foundations.md:157,158 (mix amounts), plugins/user-interface/reference/types/web/color.md:215,218 (border values), plugins/user-interface/reference/types/web/color/building-scales.md:18,19,25 (ramp): taste; each could be example.
    • plugins/user-interface/reference/types/web/color/building-scales.md:134 (~10 degrees): taste; a floor if a perceptual measurement backs it.
    • plugins/user-interface/reference/types/web/color.md:88-127, plugins/user-interface/reference/types/web/color/contrast.md:97-103 (triage): taste; plugins/user-interface/reference/types/web/color/contrast.md:102-104 says they do not replace the calculation, so no key is the other reading.
    • plugins/user-interface/reference/types/web/color.md:177 (9:1): floor; 3:1 times 3:1, a constant under the other reading. W3C technique C40 is sufficient guidance, not a success criterion.
    • plugins/user-interface/reference/types/web/color/contrast.md:23 (24px, 18.5px): constant conversions; the px form of a floor under the other reading.
    • plugins/user-interface/reference/types/web/color.md:57, plugins/user-interface/reference/types/web/color/building-scales.md:54, plugins/user-interface/reference/types/web/color/gamut-and-p3.md:17-21,58: constant; sample lightnesses read as example.
    • plugins/user-interface/reference/design-system-doc.md:220,230 (16, 14, 12px): example; the line says not values to impose, against the owner's rulings on those numbers.
    • plugins/user-interface/skills/audit/reference/launch-scope.md:118: example; the pattern encodes the 16px floor and an unstated z-index threshold.
    • plugins/user-interface/skills/audit/reference/launch-scope.md:375 (100+/day): taste; a count in prose under the other reading.
    • plugins/user-interface/skills/write-css/reference/foundations.md:234,235,296,297 (2.5): floor; taste until research backs the derivation (B5 does not).
    • plugins/user-interface/skills/write-css/reference/layout.md:168,170,173, plugins/user-interface/skills/write-css/reference/scroll-and-viewport.md:210,220 (4rem), plugins/user-interface/skills/write-css/reference/show-and-hide.md:299,304 (-3rem), plugins/user-interface/skills/write-css/reference/spacing-and-shape.md:154,155: example; reads as taste.
    • plugins/user-interface/skills/write-css/reference/text-and-media.md:80,87,88,152,153,161,162,210: taste; per-component literals or a constant under the other reading.

    Lines with a key-worthy number and no kept row, so they need rows: plugins/user-interface/reference/animation/behaviors.md:116 and plugins/user-interface/reference/animation/catalog.md:160.

    Classified list

    Added after the merge check: skills/write-css/vendor/check-css.mjs 19: 300 T → animation.duration_ms.large; 20: 500 T, retired because no key holds it; reference/animation/behaviors.md 116 and reference/animation/catalog.md 160 also take keys.

    README.md

    • 89: 0.8 T → animation.duration_ms.exit_factor
    • 92: 0.11 T → animation.gesture.velocity_threshold

    reference/animation/behaviors.md

    • 24: 0.95 T → animation.scale.press; 0.98 T → animation.scale.press
    • 28: ~150ms T → animation.duration_ms.press; 0.96 T → animation.scale.press
    • 29: 0.95 T → animation.scale.press
    • 42: duration-150 Ec
    • 43: 0.96 Ec
    • 52: 0.95 T → animation.scale.enter
    • 53: 0.95 T → animation.scale.enter; 150ms T → animation.duration_ms.medium; 200ms T → animation.duration_ms.medium
    • 62: -4px T → animation.travel_px.small; 0 C
    • 66: 400ms E
    • 68: 400ms E
    • 69: 150ms E
    • 71: ~65ms E
    • 79: 0.97 T → animation.scale.enter_small; 1 C
    • 80: 0.97 T → animation.scale.enter_small; ~125ms T → animation.duration_ms.small
    • 83: ~200ms T → animation.delay_ms.tooltip
    • 84: ~300ms T → animation.delay_ms.group_warm
    • 101: 0.96 T → animation.scale.enter
    • 102: 0.95 T → animation.scale.enter; 0.97 T → animation.scale.enter; 200ms T → animation.duration_ms.large; 250ms T → animation.duration_ms.large
    • 125: 100% Cc
    • 126: 300ms Ec; cubic-bezier(0.32, 0.72, 0, 1) Ec
    • 134: 16px T → animation.travel_px.large; 0 C; 200ms T → animation.duration_ms.large; 250ms T → animation.duration_ms.large
    • 163: ~100ms T → animation.stagger_ms.section
    • 164: 8px T → animation.travel_px.medium; 0 C
    • 165: 2px T → animation.blur_px.soften; ~80ms T → animation.stagger_ms.word
    • 174: 0.09 Ec
    • 176: opacity: 0 Cc; 2px Ec; y: 8 Ec
    • 177: opacity: 1 Cc; 0px Cc; y: 0 Cc
    • 191: opacity: 0 Cc
    • 192: 0 Cc; 8px Ec
    • 193: 2px Ec
    • 194: 350ms Ec
    • 195: 0 Cc; 90ms Ec
    • 198: opacity: 1 Cc; 0 0 Cc
    • 207: -8px T → animation.travel_px.medium
    • 211: ~150ms T → animation.duration_ms.exit_factor; ~250ms T → animation.duration_ms.large; ~300ms T → animation.duration_ms.large
    • 216: -100% C
    • 222: opacity: 0 Cc; y: -8 Ec; 2px Ec
    • 223: 0.14 Ec; [0.3, 0, 1, 1] Ec
    • 232: 0.3 T → animation.scale.swap_start; 1 C; 0.8 E; 0.9 E
    • 233: 0 C; 1 C
    • 234: 3px T → animation.blur_px.soften; 0px C
    • 235: 0.35 T → animation.spring.duration_s.small; 0 T → animation.spring.bounce.default
    • 242: 0.3 Ec; opacity: 0 Cc; 3px Ec
    • 243: scale: 1 Cc; opacity: 1 Cc; 0px Cc
    • 244: 0.3 Ec; opacity: 0 Cc; 3px Ec
    • 245: 0.35 Ec; 0 Ec
    • 253: cubic-bezier(0.25, 0.1, 0, 1) T → animation.easing.spring_stand_in; ~300ms T → animation.spring.duration_s.small
    • 344: 1:1 C
    • 348: ~0.11 T → animation.gesture.velocity_threshold
    • 358: 2px T → animation.blur_px.soften; 20px T → animation.blur_max_px
    • 359: 20px T → animation.blur_max_px

    reference/animation/catalog.md

    • 11: 200ms E; 500ms E
    • 34: 400ms T → states.wait_indicator_ms
    • 58: 300ms x2 T → animation.duration_ms.large
    • 72: 300ms E; 0 E
    • 101: scale-105 E
    • 154: scale(0) E
    • 155: 0.95 T → animation.scale.enter; 0.97 T → animation.scale.enter_small; opacity: 0 C; scale(1) C
    • 156: opacity: 1 C; 0.9 T → animation.scale.enter; 0.97 T → animation.scale.enter
    • 171: 300ms E; 150ms E
    • 176: 0 x3 E
    • 177: 100vh E; 100% E
    • 200: 150ms T → animation.duration_ms.hover
    • 255: 300ms T → animation.duration_ms.large
    • 256: 300ms T → animation.duration_ms.large
    • 257: 300ms T → animation.duration_ms.large
    • 260: 20-30% T → animation.duration_ms.exit_factor; 250ms E; 180ms E
    • 264: 500ms E
    • 266: 150ms T → animation.duration_ms.hover; 400ms E
    • 270: 180ms E
    • 275: duration-500 E; duration: 0.5 E; 0.6s E
    • 283: 0.4s E
    • 284: scale(0) E; 0.2s E
    • 285: 0.95 E
    • 288: 0.95 E; scale(0) E
    • 289: 200ms E
    • 339: 100% Cc; 240ms Ec
    • 343: 240ms Ec
    • 371: 30ms T → animation.stagger_ms.interval; 50ms T → animation.stagger_ms.interval; 150ms E
    • 372: ~400ms T → animation.stagger_ms.max_total
    • 379: 50ms T → animation.stagger_ms.interval
    • 476: -0.4s E
    • 491: opacity: 0 Cc; y: 20 Ec; opacity: 1 Cc; y: 0 Cc
    • 535: 1-2% T → animation.scale.hover_max
    • 537: ~1.02 T → animation.scale.hover_max
    • 563: 10% T → animation.inspect_playback_rate
    • 576: 0.95 T → animation.scale.enter
    • 589: 300ms T → animation.duration_ms.large
    • 590: 300ms T → animation.duration_ms.large

    reference/animation/gestures.md

    • 68: duration: 0.5 Ec; bounce: 0.2 Ec
    • 74: 0.1 T → animation.spring.bounce.playful_max; 0.3 T → animation.spring.bounce.playful_max
    • 75: duration: 0.5 T → animation.spring.duration_s.default; bounce: 0 T → animation.spring.bounce.default; bounce: 0.2 E
    • 80: 1.0 x2 C
    • 87: 1.0 T → animation.spring.bounce.default; 0.3 T → animation.spring.response_s; 0.4 T → animation.spring.response_s
    • 88: 0.8 T → animation.spring.bounce.playful_max; 0.3 T → animation.spring.response_s; 0.4 T → animation.spring.response_s
    • 89: 1.0 T → animation.spring.bounce.default; 0.4 T → animation.spring.response_s
    • 90: 0.8 T → animation.spring.bounce.playful_max; 0.4 T → animation.spring.response_s
    • 91: 0.8 T → animation.spring.bounce.playful_max; 0.3 T → animation.spring.response_s
    • 92: 1.0 T → animation.spring.bounce.default; 0.3 T → animation.spring.response_s
    • 120: ~0.998 T → animation.gesture.deceleration_rate
    • 121: 0.99 T → animation.gesture.deceleration_rate
    • 135: ~0.55 T → animation.gesture.rubberband_constant
    • 156: ~10px T → animation.gesture.slop_px
    • 158: ~10px T → animation.gesture.slop_px
    • 159: 1:1 C

    reference/animation/performance.md

    • 31: 60 x2 C; 16.7 ms C; 1000 C; 120 C; 8.3 ms C
    • 69: 12px E
    • 75: 0fr C; 1fr C
    • 94: 0.3s E
    • 97: 0.3s x2 E
    • 105: 120ms Ec
    • 111: 120ms Ec
    • 119: duration-100 Ec
    • 122: duration-100 Ec
    • 218: ~20px T → animation.blur_max_px; 2px T → animation.blur_px.soften; 5px T → animation.blur_px.soften
    • 220: 20px T → animation.blur_max_px
    • 226: blur-3xl E
    • 284: ~1px E

    reference/concerns.json

    • 603: 100vh E

    reference/design-system-doc.md

    • 44: 0.637 Ec; 0.208 Ec; 25.331 Ec
    • 220: 16px E; 14px E; 12px E
    • 230: 16px E; 14px E; 12px E

    reference/types/mods.md

    • 44: 80% E

    reference/types/terminal.md

    • 104: 80 T → layout.terminal_min_columns

    reference/types/touch-web.md

    • 58: 100dvh C; 100svh C
    • 59: 16px F
    • 61: 44px F
    • 102: opacity-100 C; opacity: 0 C; opacity: 1 C
    • 129: 0ms E
    • 149: 44px F; 24px (twice) E
    • 151: 44x44px F; 40x40px T → touch.target_desktop_px
    • 158: 44px F
    • 167: 44px F; size-6 E; h-8 E; w-8 E
    • 170: 44px F; 24px E
    • 171: 24px E
    • 188: 16px F
    • 189: 16px F
    • 190: maximum-scale=1 E
    • 193: 16px F
    • 194: 16px F
    • 205: 1rem E
    • 206: 16px F
    • 208: 16px F
    • 212: 16px F
    • 237: 100dvh C
    • 238: 100dvh C
    • 260: 375px T → touch.check_width_px
    • 263: 375px T → touch.check_width_px
    • 267: maximum-scale=1 E
    • 282: maximum-scale=1 E
    • 284: 100vh C
    • 285: 100vh C
    • 297: 100vh C
    • 299: 100vh C; 100dvh C
    • 306: 0px C
    • 390: 100vw C
    • 395: 100vw C; about 340px T → touch.fixed_width_hunt_px
    • 398: 375px T → touch.check_width_px

    reference/types/web.md

    • 53: initial-scale=1 Cc
    • 58: 100dvh C
    • 98: 0fr C; 1fr C
    • 99: min-height: 0 C

    reference/types/web/accessibility.md

    • 24: 16px F
    • 79: 2px Ec
    • 80: 2px Ec
    • 177: opacity: 0 C; translateX(-100%) C
    • 181: opacity: 0 C
    • 205: 0s C; 200ms E
    • 315: -9999px Ec
    • 318: 16px Ec
    • 319: 16px Ec
    • 453: 100% Ec

    reference/types/web/color.md

    • 29: 1px E
    • 49: 0.586 Ec; 0.222 Ec; 17.585 Ec
    • 50: 0.398 Ec; 0.066 Ec; 227.392 Ec; 0.9 Ec; 90% Ec
    • 55: 0 C; 1 C; 0.5 E
    • 57: 0 C; 0.4 C
    • 60: ~330 C; 0.5 E; 0 E
    • 74: 0.5 E; 0.1 E; 200 E; 0.5 E
    • 88: 0.6 T → color.triage.light_surface_min_l
    • 89: 0.6 T → color.triage.light_surface_min_l
    • 93: 4.5:1 F; 3:1 F
    • 109: 0.19 E
    • 120: 50% E; 50% E
    • 125: 0.6 T → color.triage.light_surface_min_l
    • 126: 0.85 T → color.triage.near_white_l; 0.45 T → color.triage.near_white_l
    • 127: 0.25 T → color.triage.near_black_l; 0.75 T → color.triage.near_black_l
    • 129: 4.5:1 F; 3:1 F; 18pt F; 14pt F
    • 130: 7:1 F; 4.5:1 F
    • 135: 85% T → color.hover_mix_percent
    • 152: 0.4 E
    • 173: 3:1 F
    • 175: 3:1 F
    • 177: 9:1 F; 3:1 F
    • 184: 3:1 F
    • 215: 1px E; 0 C; 0 C; 0.08 T → color.border.light_alpha; #e0e0e0 E
    • 218: 1px E; 0.285 T → color.border.dark_solid_l; 0 C
    • 219: 1 E; 0 E; 0.1 E
    • 221: 1px E
    • 226: 1px E
    • 234: 1px E
    • 238: 20% T → color.dark_mode.brand_desaturation_percent; 30% T → color.dark_mode.brand_desaturation_percent

    reference/types/web/color/building-scales.md

    • 18: 0.97 T → color.ramp.endpoints_l
    • 19: 0.22 T → color.ramp.endpoints_l
    • 25: ~30% T → color.ramp.chroma_percent; ~85% T → color.ramp.chroma_percent
    • 39: 0.97 Ec; 0.007 Ec; 330 Ec
    • 40: 0.895 Ec; 0.042 Ec; 330 Ec
    • 41: 0.82 Ec; 0.103 Ec; 330 Ec
    • 42: 0.745 Ec; 0.189 Ec; 330 Ec
    • 43: 0.67 Ec; 0.251 Ec; 330 Ec
    • 44: 0.595 Ec; 0.231 Ec; 330 Ec
    • 45: 0.52 Ec; 0.195 Ec; 330 Ec
    • 46: 0.445 Ec; 0.151 Ec; 330 Ec
    • 47: 0.37 Ec; 0.105 Ec; 330 Ec
    • 48: 0.295 Ec; 0.063 Ec; 330 Ec
    • 49: 0.22 Ec; 0.03 Ec; 330 Ec
    • 54: 0.67 C
    • 73: 0.65 Ec; 70% Ec
    • 74: 0.65 Ec; 0.08 Ec; 185 Ec; 0.115 Ec
    • 75: 0.65 Ec; 0.096 Ec; 75 Ec; 0.137 Ec
    • 76: 0.65 Ec; 0.155 Ec; 300 Ec; 0.221 Ec
    • 119: 240 E; 65% E; 25% E; 272.6 E; 240 E; 65% E; 55% E; 274.3 E
    • 120: 240 E; 65% E; 88% E; 285.2 E; ~13 E
    • 123: 55 E; 100% E; 50% E; 255 E; 100% E; 50% E
    • 134: ~10 T → color.ramp.hue_spread_max_deg

    reference/types/web/color/contrast.md

    • 18: 4.5:1 F; 3:1 F
    • 22: 4.5:1 F; 7:1 F
    • 23: 18pt F; 14pt F; 1pt C; 1.333px C; 24px C; 18.5px C; 3:1 F
    • 24: 4.5:1 F
    • 25: 3:1 F
    • 28: 4.5:1 F
    • 49: 4.5:1 F
    • 51: 3:1 F
    • 52: 4.5:1 F
    • 81: 0.93 Ec; 0.03 Ec; 300 Ec
    • 82: 0.72 Ec; 0.14 Ec; 300 Ec
    • 85: 0.42 Ec; 0.14 Ec; 300 Ec
    • 97: 0.6 T → color.triage.light_surface_min_l
    • 99: 0.85 T → color.triage.near_white_l; 0.45 T → color.triage.near_white_l
    • 100: 0.25 T → color.triage.near_black_l; 0.75 T → color.triage.near_black_l
    • 103: 0.3 T → color.triage.near_black_l; 0.6 T → color.triage.light_surface_min_l

    reference/types/web/color/converting-colors.md

    • 40: 0.586 Ec; 0.222 Ec; 17.585 Ec
    • 41: 0.398 Ec; 0.066 Ec; 227.392 Ec
    • 42: 0.962 Ec; 0.058 Ec; 95.617 Ec
    • 50: 1px Ec; 255 Ec; 255 Ec; 255 Ec; 0.12 Ec
    • 51: 268 Ec; 60% Ec; 45% Ec
    • 54: 0.627 Ec; 0.17 Ec; 149.214 Ec
    • 55: 1px Ec; 1 Ec; 0 Ec; 0.12 Ec
    • 56: 0.468 Ec; 0.202 Ec; 299.662 Ec
    • 64: 1 E; 0 E; 0.12 E
    • 67: 1 E; 0 E; 0 E; 0.12 E

    reference/types/web/color/gamut-and-p3.md

    • 17: 0.5 C; 285 C; 0.29 C
    • 18: 25 C; 0.20 C; 195 C; 0.09 C; 3x C
    • 20: 0.7 C; 330 C
    • 21: 0.31 C; 0.9 C; 130 C; 0.24 C
    • 32: 0.6 Ec; 0.31 Ec; 20 Ec
    • 35: 0.6 Ec; 0.241 Ec; 20 Ec
    • 48: 0.66 Ec; 0.2 Ec; 330 Ec
    • 53: 0.66 Ec; 0.32 Ec; 330 Ec
    • 58: 0.30 C; 0.33 C
    • 59: 0.32 E
    • 75: 0.66 Ec; 0.2 Ec; 330 Ec
    • 80: 0.66 Ec; 0.32 Ec; 330 Ec

    reference/types/web/color/tailwind.md

    • 25: 0.97 Ec; 0.007 Ec; 330 Ec
    • 26: 0.895 Ec; 0.042 Ec; 330 Ec
    • 27: 0.82 Ec; 0.103 Ec; 330 Ec
    • 28: 0.745 Ec; 0.189 Ec; 330 Ec
    • 29: 0.67 Ec; 0.251 Ec; 330 Ec
    • 30: 0.595 Ec; 0.231 Ec; 330 Ec
    • 31: 0.52 Ec; 0.195 Ec; 330 Ec
    • 32: 0.445 Ec; 0.151 Ec; 330 Ec
    • 33: 0.37 Ec; 0.105 Ec; 330 Ec
    • 34: 0.295 Ec; 0.063 Ec; 330 Ec
    • 35: 0.22 Ec; 0.03 Ec; 330 Ec
    • 44: 75% E

    reference/types/web/component-api.md

    • 110: 4 Ec
    • 111: 16 Ec
    • 112: 8 Ec
    • 113: 14 Ec
    • 114: 500 Ec

    reference/types/web/forms.md

    • 23: 16px F
    • 135: 12px Ec
    • 136: 50% Ec
    • 137: -50% Ec
    • 141: 40px Ec
    • 411: 8 characters E
    • 431: 16px E
    • 442: 8px Ec

    reference/types/web/generic-defaults.md

    • 223: rounded-2xl E
    • 227: rounded-2xl E
    • 294: 99.9% E

    reference/types/web/icons.md

    • 30: 12px T → icon.size_px; 16px T → icon.size_px; 20px T → icon.size_px; 24px T → icon.size_px; 48px T → icon.size_px
    • 39: 12px T → icon.size_px; 1.25px E; 2.5 E; 1.25 E
    • 40: 16px T → icon.size_px; 1.5px E; 2.25 E; 1.5 E
    • 41: 20px T → icon.size_px; 1.6 E
    • 42: 24px T → icon.size_px; 2px E; 2 E; 1.75 E
    • 43: 48px T → icon.size_px; 3px E; 1.5 E
    • 48: 24-unit E; 16px E; stroke-width="2" E; 1.33px E
    • 50: 1px E; 12px E; 48px E
    • 51: 12px E; 16px E; 48px E
    • 59: 16px E; 2px E; 24-unit E
    • 60: 48px E
    • 64: 24px E; 16px E
    • 74: about 12px T → icon.filled_below_px; 1px E
    • 76: 1px E; 12px T → icon.filled_below_px
    • 85: about 1px T → spacing.optical_icon_px
    • 95: 16px E; 48px (twice) E
    • 98: 48px E; 16px E
    • 100: 48px E
    • 126: 16px C
    • 128: 16px C
    • 151: 6-8px T → icon.label_gap_px
    • 153: 0.5em T → icon.label_gap_px; 8px E; 16px E
    • 156: 6px T → icon.label_gap_px
    • 169: 2px E; 1px E
    • 211: 3x E
    • 216: about 3 T → color.illustration_max_colors

    reference/types/web/layout-stability.md

    • 51: 48px Ec
    • 142: 600 Ec
    • 145: 500 Ec
    • 149: 400 C; 500 C
    • 150: 600 C; 700 C
    • 231: min-width: 0 C
    • 243: min-width: 0 C

    reference/types/web/layout.md

    • 90: 2px T → spacing.optical_icon_px; pl-4 E; pr-3.5 E
    • 91: 16px E; 14px E
    • 92: 2px (twice) T → spacing.optical_icon_px
    • 93: 1px T → spacing.optical_icon_px
    • 96: 2px T → spacing.optical_icon_px
    • 101: about 1200px T → layout.content_width
    • 112: 12 E; 8 T → layout.simple_page_columns
    • 124: 80px E; 667px E
    • 125: 667px E
    • 141: 9999 E
    • 145: 9999 E
    • 173: 100 T → layout.z_index_stray_above; z-[9999] E; z-50 E
    • 177: 9999 E

    reference/types/web/marketing-pages.md

    • 49: 1:1 C
    • 72: 1:1 C
    • 82: opacity: 0 C
    • 91: 1:1 C
    • 94: opacity: 0 C
    • 221: 375px T → touch.check_width_px
    • 227: 375px T → touch.check_width_px

    reference/types/web/performance.md

    • 44: 600 Ec; 400 Ec
    • 82: 4000px E; 64px E
    • 86: ~300KB T → performance.image_max_kb
    • 103: ~300KB T → performance.image_max_kb
    • 123: 400px Ec
    • 148: ~50 T → performance.virtualize_min_items
    • 172: ~50 T → performance.virtualize_min_items
    • 309: ~300ms T → performance.search_debounce_ms
    • 383: 16ms C

    reference/types/web/shape-and-depth.md

    • 26: 24px T → css.concentric_radius.max_gap_px
    • 42: 16px Ec
    • 43: 6px Ec
    • 46: 10px Ec
    • 52: 16px Ec
    • 58: rounded-3xl Ec; p-3 Ec; 24px Ec; 12px Ec
    • 59: 24 Ec; 12px Ec
    • 65: 248px E; 20px E; 8px E
    • 66: 20px E
    • 67: 8px E
    • 76: 12px E; 20px E; 0px E; 8px E
    • 77: 8px E
    • 85: 16px E; 4px E
    • 89: 16 Ec; 0 Ec; 4 Ec; 24 Ec
    • 122: 1px T → css.border_px.standard
    • 126: 1px T → css.border_px.standard
    • 131: 1px Ec; 0.05 Ec
    • 132: 1px Ec; 3px Ec; 0.05 Ec
    • 133: 4px Ec; 10px Ec; -4px Ec; 0.05 Ec
    • 135: 1px Ec; 0.07 Ec
    • 136: 1px Ec; 3px Ec; 0.07 Ec
    • 137: 4px Ec; 10px Ec; -4px Ec; 0.08 Ec
    • 143: 1px Ec; 0.09 Ec
    • 144: 1px Ec; 0.14 Ec
    • 153: 150ms Ec
    • 169: 1px Ec
    • 170: 1px Ec; 0.07 Ec
    • 203: 0.5px T → css.border_px.hairline; 1px T → css.border_px.standard
    • 208: 1px Ec
    • 211: 0.5px Ec
    • 228: 1px T → css.border_px.standard
    • 245: 80% Ec
    • 260: 1px T → css.border_px.standard; 10% T → css.image_outline.opacity
    • 261: 10% T → css.image_outline.opacity
    • 265: 1px T → css.border_px.standard
    • 273: 1px Ec; 0.1 Ec
    • 274: -1px Ec
    • 278: 0.1 Ec
    • 287: outline-1 Ec; -outline-offset-1 Ec; /10 (twice) Ec
    • 297: 10% (twice) T → css.image_outline.opacity
    • 301: -1px T → css.border_px.standard
    • 316: 10% T → css.image_outline.opacity; 1px T → css.border_px.standard

    reference/types/web/states.md

    • 135: 400ms T → states.wait_indicator_ms
    • 137: 400ms T → states.wait_indicator_ms
    • 144: 80ms E
    • 145: about 150ms T → animation.delay_ms.indicator
    • 154: 400ms T → states.wait_indicator_ms
    • 216: about 1.5s T → states.copy_confirm_ms
    • 251: 200-250 T → states.toast_reading_wpm
    • 252: 2s E

    reference/types/web/theming.md

    • 113: 0.985 Ec; 0 Ec
    • 114: 0.97 Ec; 0 Ec
    • 115: 0.205 Ec; 0 Ec
    • 119: 0.205 Ec; 0 Ec
    • 120: 0.239 Ec; 0 Ec
    • 121: 0.985 Ec; 0 Ec
    • 289: 0 Ec; 0 Ec; 0 Ec; 100px Ec

    reference/types/web/typography.md

    • 68: 620 (twice) E
    • 109: about 1.1 T → typography.line_height.display
    • 110: 1.5-1.6 T → typography.line_height.body
    • 111: 24px E
    • 115: 1.5-1.6 T → typography.line_height.body
    • 127: 45-75 T → typography.measure_ch; about 65 T → typography.measure_ch; 65ch T → typography.measure_ch
    • 131: about 75 T → typography.measure_ch
    • 222: 16px (twice) F
    • 225: 14px T → typography.small_text_px.control; 13px T → typography.small_text_px.caption; 12px T → typography.small_text_px.min
    • 230: 16px F; 12px T → typography.small_text_px.min
    • 259: 75 characters T → typography.measure_ch; 65ch T → typography.measure_ch
    • 263: 16px F

    reference/types/web/typography/details-and-floors.md

    • 24: 40% Ec
    • 25: 0.08em Ec
    • 26: 0.16em Ec
    • 28: 150ms Ec
    • 135: 16px F
    • 137: 14px T → typography.small_text_px.control; 13px T → typography.small_text_px.caption; 12px T → typography.small_text_px.min

    reference/types/web/typography/font-capabilities.md

    • 10: 473 (twice) E
    • 58: 620 E
    • 65: 620 Ec

    reference/types/web/typography/line-behavior.md

    • 9: 45-75 T → typography.measure_ch
    • 13: 65ch T → typography.measure_ch
    • 132: 12px Ec
    • 138: 12px Ec

    reference/types/web/typography/scale-and-rhythm.md

    • 27: 16px E; 1.2 E; 1.25 E
    • 32: 0.833rem Ec
    • 33: 1rem Ec
    • 34: 1.2rem Ec
    • 35: 1.44rem Ec
    • 36: 1.728rem Ec
    • 37: 2.074rem Ec
    • 54: 1.5-1.6 T → typography.line_height.body
    • 55: about 1.1 T → typography.line_height.display
    • 58: 1.5 E; 24px E
    • 59: 24px E
    • 63: 12px E; 1x T → spacing.flow
    • 96: -0.015em Ec
    • 102: 0.06em Ec
    • 111: 0.02em E

    reference/types/web/typography/tailwind.md

    • 33: 65ch T → typography.measure_ch
    • 48: 1-1000 C
    • 72: 65ch T → typography.measure_ch
    • 109: 1px E

    reference/types/web/typography/typefaces-and-formats.md

    • 66: 11px E; 32px E

    scripts/focus-path.mjs

    • 84: 0 C; 1 C

    skills/audit/reference/frame-capture.md

    • 82: 500ms Ec
    • 83: 250ms Ec
    • 86: 500ms E
    • 87: 92% E; 328ms E; 168ms E
    • 91: 500ms Ec
    • 92: 200ms Ec
    • 95: 160ms E; 328ms E; 168ms E
    • 112: 0.25x T → animation.inspect_playback_rate

    skills/audit/reference/launch-scope.md

    • 78: 300ms T → animation.duration_ms.large
    • 111: scale(0) Ec
    • 116: 100vh Ec
    • 118: 1[0-5]px Ec; z-index: 9 Ec
    • 281: 100vh E
    • 363: 4.5:1 F
    • 365: 16px F; 100vh E; maximum-scale=1 E
    • 375: scale(0) E; 100+/day T → animation.skip_frequency
    • 385: 400ms T → states.wait_indicator_ms
    • 409: 100vh E; 100dvh E
    • 410: 300ms E; 150ms E

    skills/audit/reference/motion.md

    • 92: opacity: 0 C

    skills/audit/SKILL.md

    • 67: 300ms E
    • 160: 500ms E; 250ms E
    • 161: 0.32 E; 0.72 E; 0 E; 1 E

    skills/design/reference/order-of-work.md

    • 94: 100vh E

    skills/glossary/reference/analytics.md

    • 41: 0 C; 10 C

    skills/glossary/reference/color.md

    • 89: 20 E; 30 E

    skills/glossary/reference/copywriting.md

    • 64: 1,000 E; 1000 E; 3.5k E; 3,500 E; $1.00 E; $1 E

    skills/glossary/reference/design-tools.md

    • 54: 2x E; 3x E
    • 57: 2x E; 3x E

    skills/glossary/reference/easing-and-springs.md

    • 113: 1.0 x2 C

    skills/glossary/reference/icons.md

    • 26: 16px E
    • 92: 6px E; 8px E

    skills/glossary/reference/interaction.md

    • 42: 300ms E

    skills/glossary/reference/layout.md

    • 70: 12 columns E; 8 columns E

    skills/glossary/reference/motion.md

    • 131: 0% E; 50% E; 100% E

    skills/glossary/reference/rendering-performance.md

    • 10: 60fps E

    skills/glossary/reference/typography.md

    • 121: 16px E
    • 159: 65 characters E

    skills/glossary/SKILL.md

    • 49: 0.02em E

    skills/write-css/reference/foundations.md

    • 24: min-width: 0 C
    • 31: min-width: 0 Cc
    • 42: 100% Cc
    • 48: 100svh Cc
    • 55: 100% Cc
    • 59: 16px Fc; 1rem Cc
    • 76: min-width: 0 C
    • 80: maximum-scale=1 E
    • 82: 16px F; 1rem C
    • 84: 16px F
    • 100: 100dvh C
    • 124: 1.5rem Tc → spacing.m
    • 125: 2rem Tc → spacing.l
    • 126: 4px Ec
    • 132: 1rem Ec
    • 133: 1rem Ec
    • 157: 15% Tc → color.hover_mix_percent
    • 158: 12% Tc → color.subtle_mix_percent
    • 167: 98% E; 0 E
    • 222: 1rem Tc → typography.fluid_body; 0.75rem Tc → typography.fluid_body; 1vw Tc → typography.fluid_body; 1.75rem Tc → typography.fluid_body
    • 223: 3rem Tc → spacing.section; 1rem Tc → spacing.section; 6vw Tc → spacing.section; 8rem Tc → spacing.section
    • 229: 1rem E; 1vw E; 1.75rem E
    • 230: 16px E; 1600px E
    • 234: 2.5 F
    • 235: 500% C; 2.5 F
    • 253: 77.5 Tc → typography.fluid_scale
    • 254: 1.125 Tc → typography.fluid_scale
    • 255: 1.25 Tc → typography.fluid_scale
    • 256: 1.2 Tc → typography.fluid_scale
    • 257: 1.25 Tc → typography.fluid_scale
    • 259: 0rem Cc; 100vw Cc; 1rem Cc
    • 260: 1rem Cc
    • 266: 2 Cc
    • 267: 3 Cc
    • 268: 4 Cc
    • 271: 1.5 Tc → typography.fluid_scale
    • 290: 20rem E; 77.5rem E
    • 296: 2.5 F
    • 297: 2.5 F
    • 298: 1.31 E
    • 301: 100vw C

    skills/write-css/reference/interaction.md

    • 27: 2px Tc → css.focus_ring.width; 0.08em Tc → css.focus_ring.width
    • 28: 2px Tc → css.focus_ring.offset_px
    • 87: 0.97 Tc → animation.scale.press
    • 90: 160ms Tc → animation.duration_ms.press
    • 101: 44px F
    • 106: 44px F
    • 114: 0px Cc; 100% Cc; 44px Fc
    • 122: 44px Fc
    • 123: 44px Fc
    • 135: inset-2.5 E; 24px E; 44px F
    • 267: 0.2s Tc → animation.duration_ms.medium

    skills/write-css/reference/layout.md

    • 34: 1.5rem Tc → spacing.m
    • 35: 64rem Tc → layout.content_width
    • 36: 80rem Tc → layout.breakout_width
    • 40: 1fr Cc
    • 42: 100% Cc; 2 Cc
    • 44: 1fr Cc
    • 79: 1rem Tc → spacing.s
    • 80: 100% Cc; 16rem Tc → layout.grid_track_min_width; 1fr Cc
    • 99: 1.5rem Tc → spacing.m
    • 100: 100% Cc; 16rem Tc → layout.grid_track_min_width; 1fr Cc
    • 107: 0.5rem Tc → spacing.xs
    • 132: 1rem Tc → spacing.s
    • 136: 20rem Tc → layout.sidebar_width
    • 143: 50% Tc → layout.sidebar_width
    • 168: 1.25rem Ec; 1rem Ec; 2cqi Ec; 2rem Ec
    • 170: 30rem Ec
    • 173: 12rem Ec; 1fr Cc
    • 206: 1 / 1 Cc

    skills/write-css/reference/motion.md

    • 30: 2px Tc → animation.travel_px.small
    • 34: 200ms Tc → animation.duration_ms.medium
    • 41: 0.01ms E
    • 58: 200ms x2 Tc → animation.duration_ms.large
    • 59: 300ms x2 Tc → animation.duration_ms.large
    • 149: 90deg Ec
    • 154: 0.25 Ec; 0.75 Ec
    • 162: 0.25s Tc → animation.duration_ms.medium
    • 172: 40% E
    • 198: z-index: -1 Cc
    • 207: opacity: 0 Cc
    • 211: opacity: 0 Cc
    • 212: opacity: 1 Cc
    • 217: 0.25s Tc → animation.duration_ms.medium
    • 247: -4px Tc → animation.travel_px.small
    • 251: 200ms Tc → animation.duration_ms.medium
    • 318: 2px Tc → css.border_px.strong
    • 325: 0.25s Tc → animation.duration_ms.medium
    • 326: 0.25s Tc → animation.duration_ms.medium

    skills/write-css/reference/scroll-and-viewport.md

    • 31: 1rem Tc → spacing.s
    • 34: 1.5rem Tc → spacing.m
    • 35: 1.5rem Tc → spacing.m
    • 61: 1 Cc; -1 Cc
    • 104: 80dvh Tc → layout.panel_max_height
    • 129: min-height: 0 C
    • 160: 0px Cc
    • 166: 0px Cc
    • 170: 0px Cc; 2rem Tc → css.edge_fade
    • 171: 10% Tc → css.edge_fade; 90% Tc → css.edge_fade; 2rem Tc → css.edge_fade
    • 172: 2rem Tc → css.edge_fade; 0px Cc
    • 183: 100% Cc
    • 210: 4rem Ec
    • 220: 4rem Ec
    • 282: 0px Cc
    • 284: 0px Cc
    • 286: 1rem Tc → spacing.s; 0px Cc
    • 289: 0px Cc
    • 290: 0px Cc
    • 292: 0px Cc
    • 297: 0px C
    • 298: 0px C
    • 307: 100vh E
    • 317: 100dvh Cc
    • 320: 100svh Cc
    • 325: 100vh E
    • 327: 100vh E
    • 387: 100% C; 100vw E
    • 401: 8px T → spacing.xs; 4px T → radius.s; 0.2 T → color.overlay_alpha
    • 403: 0.2 T → color.overlay_alpha
    • 408: 8px Tc → spacing.xs
    • 409: 8px Tc → spacing.xs
    • 412: 0.2 Tc → color.overlay_alpha
    • 413: 4px Tc → radius.s
    • 421: 0.2 T → color.overlay_alpha
    • 439: 1rem Tc → spacing.s
    • 440: 100% Cc; 1rem Tc → spacing.s

    skills/write-css/reference/show-and-hide.md

    • 32: opacity: 0 Cc
    • 35: 0.16s Tc → animation.duration_ms.exit_factor
    • 40: cubic-bezier(0.3, 0, 1, 1) Tc → animation.easing.in
    • 44: opacity: 1 Cc
    • 45: 0.2s Tc → animation.duration_ms.large
    • 50: opacity: 1 Cc
    • 51: 0.2s Tc → animation.duration_ms.medium
    • 57: opacity: 0 Cc
    • 63: 0 Cc; 0.5rem Tc → animation.travel_px.medium
    • 73: 0 Cc; 0.5rem Tc → animation.travel_px.medium
    • 81: scale(0) E; 0.95 T → animation.scale.enter; opacity: 0 C
    • 88: 0.95 T → animation.scale.enter; 0.97 T → animation.scale.enter
    • 89: opacity: 0 C; scale(1) C
    • 95: opacity: 0 C
    • 122: 0.5rem Tc → spacing.xs
    • 159: opacity: 0 Cc
    • 162: opacity: 1 Cc
    • 166: 0.95 Tc → animation.scale.enter
    • 168: 120ms Tc → animation.duration_ms.exit_factor
    • 169: 120ms Tc → animation.duration_ms.exit_factor
    • 173: scale(1) Cc
    • 174: 150ms Tc → animation.duration_ms.medium
    • 185: 125ms Tc → animation.duration_ms.small
    • 189: opacity: 0 Cc
    • 191: 100ms Tc → animation.duration_ms.exit_factor
    • 193: 0ms Cc
    • 198: 125ms Tc → animation.duration_ms.small
    • 199: 125ms Tc → animation.duration_ms.small
    • 203: 0.97 Tc → animation.scale.enter_small
    • 271: 0.25s Tc → animation.duration_ms.medium
    • 272: 0.25s Tc → animation.duration_ms.medium
    • 299: 0 Cc; -3rem Ec; 100% Cc
    • 304: 0 Cc; -3rem x2 Ec
    • 311: 0.25s Tc → animation.duration_ms.medium
    • 312: 0.25s Tc → animation.duration_ms.medium

    skills/write-css/reference/spacing-and-shape.md

    • 26: 6rem Tc → spacing.section
    • 28: 2rem Ec
    • 31: 2rem Ec
    • 32: 3rem Ec
    • 34: 1px Ec
    • 67: 1rem Tc → spacing.s
    • 71: 1em Tc → spacing.flow
    • 73: 2em Tc → spacing.flow
    • 74: 0.5em Tc → spacing.flow
    • 107: 0.5rem Tc → spacing.xs
    • 114: 1rem Tc → spacing.s
    • 122: 1rem Tc → spacing.s
    • 123: 100svh Cc
    • 132: 100% C
    • 153: 1.25rem Tc → radius.l
    • 154: 1px Ec
    • 155: 0.5rem Ec
    • 156: 0.08 Tc → color.border.light_alpha
    • 162: 0px Cc
    • 172: 0px C

    skills/write-css/reference/text-and-media.md

    • 51: min-width: 0 C
    • 78: 100% Cc
    • 80: 16 Tc → layout.media_aspect_ratio; 9 Tc → layout.media_aspect_ratio
    • 87: 3.5rem Tc → layout.media_small
    • 88: 3.5rem Tc → layout.media_small
    • 89: 50% Cc
    • 91: 1px Tc → css.border_px.standard
    • 92: -1px Cc
    • 111: 100% C
    • 152: 0.75rem Tc → spacing.control_padding
    • 153: 1.25rem Tc → spacing.control_padding
    • 160: 0.5rem Tc → spacing.xs
    • 161: 0.75rem Tc → spacing.control_padding
    • 162: 1.25rem Tc → spacing.control_padding
    • 172: 0.75rem E
    • 173: 48px E; 35px E
    • 175: 16px E; 1.5 E
    • 176: 25px E; 11px E
    • 193: 0.5em Tc → icon.label_gap_px
    • 205: 0.5em Tc → icon.label_gap_px
    • 210: 1em Tc → icon.size_em
    • 217: 16px E; 5px E; 7px E
    • 218: 32px E

    skills/write-css/scripts/review.mjs

    • 92: 1 C; 0 C

    skills/write-css/vendor/check-css.mjs

    • 61: 1000 C; 1 C
  4. kyle-sexton commented on Nov 9, 2026

    @kyle-sexton
    MemberAuthor

    Post-blocker rescan for #14311 (main at b0a0df2, against the design scan's base 8a00f58)

    #14212 (#14383) and #14213 (#14524) are closed, so #14311 is unblocked. Since the design scan, PRs #14319, #14322, #14383 and #14524 changed 20 files under plugins/user-interface.

    New or rewritten numbers: none outside config. Every number they added is already a key with a default in reference/defaults.yaml:

    Key Default Added by
    animation.gesture.distance_threshold 0.4 #14319
    typography.long_form_body_px 18 (floor 16, enforced by the config check) #14322
    animation.cleanup_order ordered list, no number #14383
    touch.both_axes_activation tap-to-activate, no number #14524

    The prose that mentions them (README, behaviors.md, typography.md section 6, touch-web.md section 6, scroll-and-viewport.md) names the key beside the value. They are four of the 100 roles already counted (D5, D11), so the count does not change.

    Line drift: row positions in the classified list now differ for rows below the inserted text in behaviors.md, catalog.md, gestures.md, touch-web.md, typography.md and scroll-and-viewport.md. A rerun flipped the code/prose flag on 5 rows for that reason only, with no value change. The #14311 build finds each row by its value, not its line number.

    Basis: git diff -U0 8a00f58a3c b0a0df2227 -- plugins/user-interface (added lines that contain a digit), and a rerun of the local classified-list scan.

    Plan Q10 still needs the owner's go-ahead on this delta before the build starts.

  5. kyle-sexton commented on Nov 10, 2026

    @kyle-sexton
    MemberAuthor

    All eight child issues (#14311-#14318) are closed with merged PRs. Closed by the owner's decision in session.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs-humanHuman-in-the-loop required; autonomous sessions must not resolve items carrying this.

    Type

    Fields

    No fields configured for Task.

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions