@erclx/canon 5.62.0 → 5.64.0

package/governance/ledger/skills/design-taste/tells.md

@@ -0,0 +1,103 @@
+---
+title: Machine tells ledger
+description: Sources for claude/skills/design-taste/references/tells.md, one row per bullet
+---
+
+# Machine tells ledger
+
+The field is what language models draw when nothing states a direction, which no design authority studies. Nearly every row is therefore a catalog observation from a community prompt skill, recording model output and never cited as an authority. The few authority rows quote MDN, Practical Typography, or Wikipedia.
+
+The main catalog is Taste-Skill's v2 experimental skill, which its author moved to the classics repository on 2026-10-19. Each count in the countable limits is a House choice even where a catalog states the same number, since the toolkit adopted it so the tell can be counted.
+
+## Where current AI design clusters
+
+| Bullet                  | Source                                                                                                                                                                                                                                                                   | Read       |
+| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
+| The warm paper page     | Catalog observation, [frontend-design](https://github.com/anthropics/skills/blob/main/skills/frontend-design/SKILL.md): "a warm cream background (near #F4F1EA) with a high-contrast serif display and a terracotta or warm-clay accent"                                 | 2026-10-24 |
+| Black with one accent   | Catalog observation, [frontend-design](https://github.com/anthropics/skills/blob/main/skills/frontend-design/SKILL.md): "a near-black background with a single bright acid-green or vermilion accent"                                                                    | 2026-10-24 |
+| The newspaper imitation | Catalog observation, [frontend-design](https://github.com/anthropics/skills/blob/main/skills/frontend-design/SKILL.md): "a broadsheet-style layout with hairline rules, zero border-radius, and dense newspaper-like columns"                                            | 2026-10-24 |
+| The card kit            | Catalog observation, [frontend-design](https://github.com/anthropics/skills/blob/main/skills/frontend-design/SKILL.md): "content chopped into identical rounded cards", under "the same soft grey shadow", with "gradient washes as decoration"                          | 2026-10-24 |
+| Template chrome         | Catalog observation, [frontend-design](https://github.com/anthropics/skills/blob/main/skills/frontend-design/SKILL.md): "a tracked-out ALL-CAPS eyebrow label above every heading", "meta strings joined with middle dots", and "a monospace face for small data labels" | 2026-10-24 |
+
+## Composition
+
+| Bullet                     | Source                                                                                                                                                                                                                                                                 | Read       |
+| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| The three equal cards      | Catalog observation, [Redesign skill](https://github.com/nxpatterns/claude-taste-skill/blob/main/skills/redesign-skill/SKILL.md): "Three equal card columns as feature row. This is the most generic AI layout."                                                       | 2026-10-24 |
+| One section shape repeated | Catalog observation, [Taste-Skill tells](https://github.com/leonxlnx/taste-skill/blob/main/skills/taste-skill/references/tells.md): "Every section the same layout family" is a structural tell, reached past with "Different composition per section"                 | 2026-10-24 |
+| The centered hero          | Catalog observation, [Taste-Skill tells](https://github.com/leonxlnx/taste-skill/blob/main/skills/taste-skill/references/tells.md): "Centred headline, subtitle, two buttons, screenshot below"                                                                        | 2026-10-24 |
+| Decoration as structure    | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "NO crosshair / hairline grid lines as decoration", kept "only when they organize real content"            | 2026-10-24 |
+| The corner floater         | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "a small explainer paragraph floating with no clear alignment to anything else. That floater is the Tell." | 2026-10-24 |
+
+## Content and labels
+
+| Bullet                     | Source                                                                                                                                                                                                                                                                               | Read       |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
+| Enumerated eyebrows        | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): generic step labels are banned, since "The actual step content is the label"                                             | 2026-10-24 |
+| Poetic section labels      | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "Field notes" and "On our desks" style labels read "as performative-craftsman. Use plain functional labels"              | 2026-10-24 |
+| Atmospheric strips         | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "NO weather / locale strips" and "NO version footers on marketing pages"                                                 | 2026-10-24 |
+| Scroll cues                | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "Scroll cues are banned." Readers "know what scroll is."                                                                 | 2026-10-24 |
+| Decorative status dots     | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): a dot is "Only acceptable when conveying real semantic state" and "limited to one per page section"                      | 2026-10-24 |
+| Filler verbs               | Catalog observation, [Redesign skill](https://github.com/nxpatterns/claude-taste-skill/blob/main/skills/redesign-skill/SKILL.md): "Never use 'Elevate', 'Seamless', 'Unleash', 'Next-Gen'", and "Write plain, specific language."                                                    | 2026-10-24 |
+| Placeholder as placeholder | Catalog observation, [Redesign skill](https://github.com/nxpatterns/claude-taste-skill/blob/main/skills/redesign-skill/SKILL.md): "Generic names like 'John Doe'" and "Placeholder company names like 'Acme Corp'"                                                                   | 2026-10-24 |
+| Invented precision         | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "Fake-precise numbers are flagged", passing only when they "Come from real data" or "Are explicitly labeled as mock"     | 2026-10-24 |
+| The fake screenshot        | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "NO div-based fake product UI in the hero", which it ranks first among the tells                                         | 2026-10-24 |
+| Copy nobody re-read        | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "re-read every visible string on the page", since "AI-generated cute copy is worse than boring copy"                     | 2026-10-24 |
+| What the re-read rewrites  | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): the re-read flags a string that is "Grammatically broken", "Has unclear referents", or carries "cute-but-wrong wordplay" | 2026-10-24 |
+
+## Surface and palette
+
+| Bullet                       | Source                                                                                                                                                                                                                                                                                                                                                   | Read       |
+| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| Glow as depth                | Catalog observation, [Impeccable craft floor](https://github.com/pbakaus/impeccable/blob/main/skill/reference/craft-floor.md): "shadows carry an offset and a soft blur. A zero-offset colored halo is decoration."                                                                                                                                      | 2026-10-24 |
+| Pure black and pure white    | Catalog observation, [Redesign skill](https://github.com/nxpatterns/claude-taste-skill/blob/main/skills/redesign-skill/SKILL.md), for the black half: a pure black background is a tell, to "Replace with off-black, dark charcoal, or tinted dark". The white half is a House choice: a full-brightness ground glares beside every tinted neutral on it | 2026-10-24 |
+| Saturation everywhere        | Catalog observation, [Redesign skill](https://github.com/nxpatterns/claude-taste-skill/blob/main/skills/redesign-skill/SKILL.md): "Oversaturated accent colors. Keep saturation below 80%."                                                                                                                                                              | 2026-10-24 |
+| The gradient as a substitute | Catalog observation, [Taste-Skill tells](https://github.com/leonxlnx/taste-skill/blob/main/skills/taste-skill/references/tells.md): "Gradient-filled headline text" and a "Glowing or gradient" button are banned, reached past with "Solid ink" and a "Flat button"                                                                                     | 2026-10-24 |
+| Uniform radius and elevation | Catalog observation, [Taste-Skill tells](https://github.com/leonxlnx/taste-skill/blob/main/skills/taste-skill/references/tells.md): "One medium border radius (12–16px) on everything" and a "Soft grey drop shadow under every card"                                                                                                                    | 2026-10-24 |
+
+## Platform surfaces
+
+| Bullet                       | Source                                                                                                                                                                | Read       |
+| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| An unstyled platform control | [color-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/color-scheme): it adapts "The default colors of form controls"                   | 2026-10-24 |
+| No checkerboard              | [Wikipedia, Transparency](https://en.wikipedia.org/wiki/Transparency_%28graphic%29): an editor "shows transparency by a special pattern, e.g. a checkerboard pattern" | 2026-10-24 |
+
+## Typography
+
+| Bullet                       | Source                                                                                                                                                                                                                                         | Read       |
+| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| Scale as the only hierarchy  | [Practical Typography, Headings](https://practicaltypography.com/headings.html): "It's fine to make the point size bigger, but just a little."                                                                                                 | 2026-10-24 |
+| One family doing every job   | Catalog observation, [Redesign skill](https://github.com/nxpatterns/claude-taste-skill/blob/main/skills/redesign-skill/SKILL.md): "Browser default fonts or Inter everywhere", reached past by pairing "a serif header with a sans-serif body" | 2026-10-24 |
+| Unbounded measure            | [Practical Typography, Line length](https://practicaltypography.com/line-length.html): "Aim for an average line length of 45–90 characters, including spaces."                                                                                 | 2026-10-24 |
+| Caps and tracking as texture | Catalog observation, [Taste-Skill tells](https://github.com/leonxlnx/taste-skill/blob/main/skills/taste-skill/references/tells.md): "Tiny uppercase letter-spaced captions scattered around the viewport"                                      | 2026-10-24 |
+
+## Motion
+
+| Bullet                             | Source                                                                                                                                                                                                                                                              | Read       |
+| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| Motion nobody can justify          | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "Before adding any animation, ask: 'what does this animation communicate?'"                             | 2026-10-24 |
+| The permanent loop                 | Catalog observation, [Taste-Skill tells](https://github.com/leonxlnx/taste-skill/blob/main/skills/taste-skill/references/tells.md): "infinite loops that mean nothing" are a motion tell                                                                            | 2026-10-24 |
+| Motion on arrival                  | Catalog observation, [frontend-design](https://github.com/anthropics/skills/blob/main/skills/frontend-design/SKILL.md): "fade-and-slide-up entrances on each section and hover transitions on every card are the generic default and read as AI-generated"          | 2026-10-24 |
+| Motion claimed but absent          | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "Motion claimed, motion shown." A static page claiming motion "is broken"                               | 2026-10-24 |
+| Motion that ignores the preference | [prefers-reduced-motion](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-reduced-motion): it detects a setting "to minimize the amount of non-essential motion", the source the `ui-craft` motion ledger records for the rule this bullet points at | 2026-10-24 |
+
+## The countable limits
+
+| Bullet                 | Source                                                                                                                                                                                                                                                                                                                  | Read       |
+| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| A layout family once   | House choice: a repeated shape becomes a count a reviewer can check. The catalog states the cap, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "A landing page with 8 sections must use at least 4 different layout families." | 2026-10-24 |
+| Two consecutive splits | House choice: a third alternation is where the pattern reads as filler. The catalog states the cap, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "Max 2 sections in a row with this image+text-split pattern."                | 2026-10-24 |
+| One label per three    | House choice, recorded in the `ui-craft` copy ledger. The catalog states the cap, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "Maximum 1 eyebrow per 3 sections."                                                            | 2026-10-24 |
+| One marquee            | House choice: a second sliding strip is where the device reads as filler. The catalog states the cap, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "Two or more marquees on the same page reads as lazy filler."              | 2026-10-24 |
+| Cells equal items      | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "A bento grid has EXACTLY as many cells as you have content for."                                                                                           | 2026-10-24 |
+| Over five items        | House choice: a long run becomes a count a reviewer can check. The catalog states the cap, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "If you have > 5 items, reach for one of these instead"                               | 2026-10-24 |
+
+## The first screen
+
+| Bullet                       | Source                                                                                                                                                                                                                                                                                   | Read       |
+| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| It fits                      | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "Hero MUST fit in the initial viewport", with "CTAs visible without scroll"                                                  | 2026-10-24 |
+| At most four text elements   | House choice: a label, a headline, a supporting line, and the actions, so a fifth is countable. The catalog states the cap, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "max 4 text elements" | 2026-10-24 |
+| Everything else moves down   | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): the tagline, trust strip, pricing teaser, feature list, and avatar row "move to dedicated sections directly below the hero"  | 2026-10-24 |
+| Scale planned with the asset | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "A 4-line hero headline is always a font-size error, never a copy-length error."                                             | 2026-10-24 |
+| Logos go under it            | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): the logo wall "belongs UNDER the hero, never inside it"                                                                      | 2026-10-24 |

package/governance/ledger/{ui → skills/ui-craft}/a11y.md

@@ -1,9 +1,9 @@
 ---
-title: Accessibility rule ledger
-description: Sources for governance/rules/ui/a11y.md, one row per bullet
+title: Accessibility reference ledger
+description: Sources for claude/skills/ui-craft/references/a11y.md, one row per bullet
 ---
 
-# Accessibility rule ledger
+# Accessibility reference ledger
 
 The field is web accessibility, and the authority is the W3C, through WCAG 2.2 and its Understanding documents, the WAI tutorials, and the ARIA notes. The keyboard and focus half of the old rule moved to `keyboard.md`, whose ledger records those bullets.
 

package/governance/ledger/{ui/surface-capture.md → skills/ui-craft/capture.md}

@@ -1,9 +1,9 @@
 ---
-title: Surface capture rule ledger
-description: Sources for governance/rules/ui/surface-capture.md, one row per bullet
+title: Surface capture reference ledger
+description: Sources for claude/skills/ui-craft/references/capture.md, one row per bullet
 ---
 
-# Surface capture rule ledger
+# Surface capture reference ledger
 
 The rule states canon's own evidence procedure for a rendered change, so most rows are house choices naming the bug the bullet prevents. The 320 floor rests on WCAG 2.2, and each explanation the old rule carried moved into a row here.
 

package/governance/ledger/{ui/ux-controls.md → skills/ui-craft/controls.md}

@@ -1,9 +1,9 @@
 ---
-title: UX controls rule ledger
-description: Sources for governance/rules/ui/ux-controls.md, one row per bullet
+title: UX controls reference ledger
+description: Sources for claude/skills/ui-craft/references/controls.md, one row per bullet
 ---
 
-# UX controls rule ledger
+# UX controls reference ledger
 
 The field is interaction design, and the authorities are the Nielsen Norman Group, WCAG 2.2, Primer, Cloudscape, MDN, and web.dev. These bullets were split from `ux-completeness.md`.
 
@@ -16,11 +16,16 @@ The field is interaction design, and the authorities are the Nielsen Norman Grou
 
 ## Element states
 
+| Bullet                        | Source                                                                                                                                                                                                                                                                                             | Read       |
+| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| Distinct interaction states   | [Visibility of system status](https://www.nngroup.com/articles/visibility-system-status/): "Did the system actually catch that button press", and an element with no pressed or hover response leaves the person unable to tell                                                                    | 2026-10-18 |
+| Say why a control is disabled | [Cloudscape, Disabled and read-only states](https://cloudscape.design/patterns/general/disabled-and-read-only-states/): "Use disabled reasons where adequate context is not provided through disabled button or label text", and `aria-disabled="true"` is used "so that it will remain focusable" | 2026-10-23 |
+| Declare `color-scheme`        | [MDN, color-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/color-scheme): the user agent adapts "The default colors of scrollbars and other interaction UI" and "The default colors of form controls", and the page opts in by declaring it on the `:root` element  | 2026-10-23 |
+| No intermediate flash         | [Cumulative Layout Shift](https://web.dev/articles/cls): "Unexpected layout shifts can disrupt the user experience", caused by content "dynamically added to the page before existing content"                                                                                                     | 2026-10-18 |
+
+## Hover and focus effects
+
 | Bullet                                 | Source                                                                                                                                                                                                                                                                                                                                                                                      | Read                 |
 | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
-| Distinct interaction states            | [Visibility of system status](https://www.nngroup.com/articles/visibility-system-status/): "Did the system actually catch that button press", and an element with no pressed or hover response leaves the person unable to tell                                                                                                                                                             | 2026-10-18           |
-| Say why a control is disabled          | [Cloudscape, Disabled and read-only states](https://cloudscape.design/patterns/general/disabled-and-read-only-states/): "Use disabled reasons where adequate context is not provided through disabled button or label text", and `aria-disabled="true"` is used "so that it will remain focusable"                                                                                          | 2026-10-23           |
-| Declare `color-scheme`                 | [MDN, color-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/color-scheme): the user agent adapts "The default colors of scrollbars and other interaction UI" and "The default colors of form controls", and the page opts in by declaring it on the `:root` element                                                                                           | 2026-10-23           |
 | Hover and focus content                | [Understanding Content on Hover or Focus](https://www.w3.org/WAI/WCAG22/Understanding/content-on-hover-or-focus.html): additional content is "Dismissible" without moving hover or focus, "Hoverable" so the pointer can move over it, and "Persistent" until "the hover or focus trigger is removed, the user dismisses it, or its information is no longer valid"                         | 2026-10-23, WCAG 2.2 |
 | No change of context on focus or input | [Understanding On Focus](https://www.w3.org/WAI/WCAG22/Understanding/on-focus.html): "When any user interface component receives focus, it does not initiate a change of context". [Understanding On Input](https://www.w3.org/WAI/WCAG22/Understanding/on-input.html): changing a setting does not cause one "unless the user has been advised of the behavior before using the component" | 2026-10-23, WCAG 2.2 |
-| No intermediate flash                  | [Cumulative Layout Shift](https://web.dev/articles/cls): "Unexpected layout shifts can disrupt the user experience", caused by content "dynamically added to the page before existing content"                                                                                                                                                                                              | 2026-10-18           |

package/governance/ledger/skills/ui-craft/copy.md

@@ -0,0 +1,102 @@
+---
+title: UI copy reference ledger
+description: Sources for claude/skills/ui-craft/references/copy.md, one row per bullet
+---
+
+# UI copy reference ledger
+
+The reference joins three rules, and its sections keep their order, so each source below covers a run of them.
+
+Content design governs the first four sections, where the authority for researched interface copy is the GOV.UK Design System and its style guide.
+
+The four casing sections rest on the GOV.UK style guide, which sets sentence case for every heading and title, and canon set the label count and the scope bullets itself. The two link sections are interaction design, sourced from the Nielsen Norman Group's research on new windows and tabs.
+
+## Punctuation
+
+| Bullet                        | Source                                                                                                                                                                  | Read       |
+| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| No em dash or semicolon       | House choice: both read as generated copy in an interface, and a comma, a period, or a split sentence carries the same meaning in a shorter line                        | 2026-10-18 |
+| No trailing label punctuation | [Button](https://design-system.service.gov.uk/components/button/): every example label, such as "Start now", "Sign in", and "Continue", carries no trailing punctuation | 2026-10-18 |
+
+## Button copy
+
+| Bullet            | Source                                                                                                                                     | Read       |
+| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
+| The action's verb | [Button](https://design-system.service.gov.uk/components/button/): "Write button text in sentence case, describing the action it performs" | 2026-10-18 |
+
+## Error messages
+
+| Bullet            | Source                                                                                                                                                                                                                                            | Read       |
+| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| Say how to fix it | [Error message](https://design-system.service.gov.uk/components/error-message/): "Describe what has happened and tell them how to fix it", and "'Enter your first name' is clearer, more direct and natural than 'First name must have an entry'" | 2026-10-18 |
+| Short and plain   | [Error message](https://design-system.service.gov.uk/components/error-message/): "The message must be in plain English, use positive language and get to the point", with no "technical jargon like 'form post error'"                            | 2026-10-18 |
+
+## Placeholder text
+
+| Bullet                         | Source                                                                                                                                                                                                                                           | Read       |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
+| No placeholder, a hint instead | [Text input](https://design-system.service.gov.uk/components/text-input/): "Do not use placeholder text in place of a label, or for hints or examples", since "it vanishes when the user starts typing" and "not all screen readers read it out" | 2026-10-18 |
+
+## Sentence case
+
+| Bullet                   | Source                                                                                                                                                      | Read       |
+| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| Sentence case            | [A to Z of GOV.UK style](https://www.gov.uk/guidance/style-guide/a-to-z-of-gov-uk-style): "Always use sentence case, even in page titles and service names" | 2026-10-18 |
+| Proper nouns keep casing | [A to Z of GOV.UK style](https://www.gov.uk/guidance/style-guide/a-to-z-of-gov-uk-style): "The exceptions to this are proper nouns"                         | 2026-10-18 |
+
+## Uppercase labels
+
+| Bullet      | Source                                                                                                                                                       | Read       |
+| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
+| Label count | House choice: an uppercase eyebrow over every section is the template tell `design-taste` reaches past, and the count makes the cap checkable against a page | 2026-10-18 |
+
+## Where it applies
+
+| Bullet                 | Source                                                                                                           | Read       |
+| ---------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------- |
+| Copy outside the globs | House choice: a locale file holds the same rendered strings, so title case there ships with no rule firing on it | 2026-10-18 |
+
+## Overriding
+
+| Bullet              | Source                                                                                                                                        | Read       |
+| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| Depart where needed | House choice: an acronym or brand mark lowered to sentence case misnames it, the same reason GOV.UK keeps "proper nouns" as its one exception | 2026-10-18 |
+
+## Default target
+
+| Bullet                      | Source                                                                                                                                                                                                                                                                                           | Read       |
+| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
+| Same tab, new tab by task   | [Opening links in new browser windows and tabs](https://www.nngroup.com/articles/new-browser-windows-and-tabs/): "There is generally one good reason to open a page in a new window, and that is that the user will need to refer to that content in order to complete a task in another window" | 2026-10-18 |
+| No blanket external new tab | [Opening links in new browser windows and tabs](https://www.nngroup.com/articles/new-browser-windows-and-tabs/): "New windows or tabs prevent the use of the Back button" and "can cause disorientation"                                                                                         | 2026-10-18 |
+
+## mailto: links
+
+| Bullet             | Source                                                                                                                                       | Read       |
+| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| `mailto:` same tab | House choice: the link opens the mail client and leaves the page in place, so `target="_blank"` only adds an empty tab the person must close | 2026-10-18 |
+
+## Declined
+
+Every bullet the rewrite removed or reshaped, grouped by why.
+
+### Contradicted by the source
+
+- Replaced "show format examples over instructions in placeholder text" with the hint text bullet, since GOV.UK says not to use a placeholder "for hints or examples".
+- Cut "reserve instructions for labels or helper text", which the new placeholder bullet now carries.
+
+### Merged or reworded
+
+- Merged the imperative verb and padded phrasing bullets. The `Save` over `Save changes` example went, since GOV.UK adds words "to better describe the action".
+- Merged "keep messages short and actionable" and "one sentence maximum" into the plain language bullet.
+- Reworded the error example to `Enter an email address`, the instruction form GOV.UK prefers over a description.
+- Folded "treat title case on every heading as a template tell" into the sentence case bullet as its reason.
+- Shortened the uppercase label bullet under 200 characters, keeping the `ceil(sections / 3)` count and the delete remedy.
+- Reworded the scope bullet from a statement of what the rule covers to the directive a session can act on.
+
+### Cut without a check
+
+- Cut "treat the count as a judgment, since a glob cannot check it", which tells a session nothing it can verify against a line.
+
+### Rewritten to what the source says
+
+- Reworded the new tab exception from "a destination that would discard in-progress work" to a page the person must consult while finishing a task, the one reason NN/g names.

package/governance/ledger/{ui → skills/ui-craft}/forms.md

@@ -1,9 +1,9 @@
 ---
-title: Forms rule ledger
-description: Sources for governance/rules/ui/forms.md, one row per bullet
+title: Forms reference ledger
+description: Sources for claude/skills/ui-craft/references/forms.md, one row per bullet
 ---
 
-# Forms rule ledger
+# Forms reference ledger
 
 The field is form design inside interaction design, and the authority for researched form patterns is the GOV.UK Design System, with WCAG 2.2 for the two authentication criteria. NN/g was read beside it and disagrees on validation timing, recorded under `## Declined`.
 

package/governance/ledger/{ui → skills/ui-craft}/keyboard.md

@@ -1,9 +1,9 @@
 ---
-title: Keyboard rule ledger
-description: Sources for governance/rules/ui/keyboard.md, one row per bullet
+title: Keyboard reference ledger
+description: Sources for claude/skills/ui-craft/references/keyboard.md, one row per bullet
 ---
 
-# Keyboard rule ledger
+# Keyboard reference ledger
 
 The field is web accessibility, and the authorities are the W3C, through WCAG 2.2 and the ARIA Authoring Practices Guide, MDN for CSS behavior, and the platform guidelines from Apple and Android for native targets. Every bullet here was split from `a11y.md`.
 

package/governance/ledger/{ui → skills/ui-craft}/motion.md

@@ -1,9 +1,9 @@
 ---
-title: Motion rule ledger
-description: Sources for governance/rules/ui/motion.md, one row per bullet
+title: Motion reference ledger
+description: Sources for claude/skills/ui-craft/references/motion.md, one row per bullet
 ---
 
-# Motion rule ledger
+# Motion reference ledger
 
 The field is web accessibility, and the authorities are the W3C, through WCAG 2.2 and the ARIA Authoring Practices Guide, and MDN for the media feature.
 

package/governance/ledger/{ui → skills/ui-craft}/pointer.md

@@ -1,9 +1,9 @@
 ---
-title: Pointer rule ledger
-description: Sources for governance/rules/ui/pointer.md, one row per bullet
+title: Pointer reference ledger
+description: Sources for claude/skills/ui-craft/references/pointer.md, one row per bullet
 ---
 
-# Pointer rule ledger
+# Pointer reference ledger
 
 The field is web accessibility, and the authorities are the W3C, through WCAG 2.2 and the ARIA Authoring Practices Guide, MDN for popover behavior, and the platform guidelines from Apple and Android for native targets. These bullets were split from `keyboard.md`.
 

package/governance/ledger/{ui/ux-completeness.md → skills/ui-craft/states.md}

@@ -1,9 +1,9 @@
 ---
-title: UX completeness rule ledger
-description: Sources for governance/rules/ui/ux-completeness.md, one row per bullet
+title: UX completeness reference ledger
+description: Sources for claude/skills/ui-craft/references/states.md, one row per bullet
 ---
 
-# UX completeness rule ledger
+# UX completeness reference ledger
 
 The field is interaction design, and the authorities are the Nielsen Norman Group's research articles, WCAG 2.2 for timing, MDN for the `title` attribute and CSS truncation, and web.dev for layout shift.
 

package/governance/ledger/ui/craft.md

@@ -0,0 +1,19 @@
+---
+title: UI craft rule ledger
+description: Sources for governance/rules/ui/craft.md, one row per bullet
+---
+
+# UI craft rule ledger
+
+The rule is a pointer to the `ui-craft` and `design-taste` skills, which carry their own sources, so both rows are house choices naming the bug the pointer prevents.
+
+## Authority
+
+| Bullet                     | Source                                                                                                                                                                                      | Read       |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| Load the skills            | House choice: a rendered edit made without the behavior floor or the layer order reaches for a model's defaults, and a second copy of either in the rule drifts from the skill that owns it | 2026-10-24 |
+| Report an unresolved skill | House choice: the rule ships with the CLI and the skills with the plugin, so a project holding governance alone would otherwise proceed silently without them                               | 2026-10-18 |
+
+## Declined
+
+The fold kept both bullets and widened the first to name `ui-craft` beside `design-taste`, since the practice rules it replaced now live in that skill.

package/governance/renames.toml

@@ -3,9 +3,11 @@
 # so `canon gov sync` replaces a held old file with the rule under its new name
 # rather than only deleting it.
 #
-# An entry declares one-to-one identity and nothing else. A fold of several
-# rules into one, or a split of one into several, is a retirement plus an
-# addition and takes no entry here. Add the entry in the same change as the
+# An entry declares one-to-one identity, or a fold onto a pointer rule that
+# now routes to the skill carrying the folded rules, so a target holding any
+# of them lands on the pointer rather than losing the practice with nothing in
+# its place. Any other fold of several rules into one, or a split of one into
+# several, is a retirement plus an addition and takes no entry here. Add the entry in the same change as the
 # rename or renumber. Prune an entry only once its target rule is retired and
 # the retire path covers it, since a chain ending on a rule nothing ships
 # resolves to nothing and a sync deletes the held file instead. Otherwise leave
@@ -73,3 +75,15 @@
 "460-design-taste" = "design-taste"
 "465-interface-casing" = "interface-casing"
 "470-motion" = "motion"
+"design-taste" = "craft"
+"a11y" = "craft"
+"keyboard" = "craft"
+"pointer" = "craft"
+"forms" = "craft"
+"motion" = "craft"
+"ux-controls" = "craft"
+"ux-completeness" = "craft"
+"surface-capture" = "craft"
+"copy" = "craft"
+"interface-casing" = "craft"
+"link-behavior" = "craft"

package/governance/rules/lib/test-scope.md

@@ -20,5 +20,5 @@ paths:
 
 - Answer a question about the running page with a script against the dev server rather than with the suite.
 - Do not enable `fullyParallel` in the Playwright config.
-- Follow `.claude/rules/canon/ui/surface-capture.md` for capture scope.
+- Follow the `canon:ui-craft` skill's capture reference for capture scope, reporting it when the skill does not resolve.
 - Follow `.claude/rules/canon/lib/e2e-reliability.md` for waits and guards.

package/governance/rules/ui/craft.md

@@ -0,0 +1,22 @@
+---
+description: Route edits to a rendered surface to the ui-craft skill for how it behaves and to the design-taste skill for how it looks
+paths:
+  - '**/*.tsx'
+  - '**/*.jsx'
+  - '**/*.vue'
+  - '**/*.svelte'
+  - '**/*.astro'
+  - '**/*.html'
+  - '**/*.mdx'
+  - '**/*.css'
+  - '**/*.scss'
+  - '**/content/**/*.ts'
+  - 'canon/DESIGN.md'
+---
+
+# UI craft standards
+
+## Authority
+
+- Load the `canon:ui-craft` skill for how a surface behaves and the `canon:design-taste` skill for how it looks. Each is the single source for its half.
+- Report it rather than proceeding silently when either skill does not resolve. Both ship with the plugin and this rule ships with the CLI, so governance alone carries neither.

package/governance/splits.toml

@@ -11,5 +11,3 @@
 # entry only once its key or partner is retired, which the live-rule check in
 # `src/gov/splits.test.ts` forces.
 [split]
-keyboard = ["pointer"]
-ux-completeness = ["ux-controls"]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@erclx/canon",
   "type": "module",
-  "version": "5.62.0",
+  "version": "5.64.0",
   "description": "Runs your agent's work and keeps its code good, on one setup for every repo.",
   "license": "MIT",
   "bin": {

package/src/audits/catalog.ts

@@ -2,7 +2,6 @@ import type { SkillsAuditRefusal } from '@/claude/skills-audit'
 import type { RankRefusal } from '@/claude/skills-rank'
 import type { ReachRefusal } from '@/claude/skills-reach'
 import type { ContextAuditRefusal } from '@/context/audit'
-import type { SweepVerdict } from '@/context/classify/patterns'
 import type { AuditRefusal } from '@/deps/audit'
 import type { RuleAuditRefusal } from '@/gov/audit'
 import type { RestatedRefusal } from '@/gov/restated'
@@ -161,45 +160,6 @@ function requirementsCounts(
   return { requirementsOverWords: record.words > record.wordCap ? 1 : 0 }
 }
 
-/**
- * The retained key for each verdict the sweep can return. A record rather than
- * a list, so the compiler fails here when the classifier gains a verdict,
- * instead of that verdict's sections dropping out of the tally.
- */
-const PLACEMENT_KEYS: Record<SweepVerdict, string> = {
-  KEEP: 'keep',
-  REWRITE: 'rewrite',
-  MOVE: 'move',
-}
-
-function isPlacementVerdict(value: unknown): value is SweepVerdict {
-  return typeof value === 'string' && Object.hasOwn(PLACEMENT_KEYS, value)
-}
-
-/**
- * Tallies the sweep's findings by verdict, with a zero for a verdict nothing
- * returned, so a baseline reads the same three keys on every run.
- *
- * `KEEP` is retained beside the two that ask for a change. It moves when a
- * section is added or split, which is what tells a falling `rewrite` count
- * from a corpus that shrank.
- */
-function placementCounts(record: unknown): Record<string, number> | undefined {
-  const findings = asObject(record)?.findings
-  if (!Array.isArray(findings)) return undefined
-
-  const counts: Record<string, number> = Object.fromEntries(
-    Object.values(PLACEMENT_KEYS).map((key) => [key, 0]),
-  )
-  for (const finding of findings) {
-    const verdict = asObject(finding)?.verdict
-    if (!isPlacementVerdict(verdict)) return undefined
-    counts[PLACEMENT_KEYS[verdict]] += 1
-  }
-
-  return counts
-}
-
 function contextCounts(record: unknown): Record<string, number> | undefined {
   const root = asObject(record)
   if (root === undefined) return undefined
@@ -526,18 +486,6 @@ export const AUDITS: readonly AuditSpec[] = [
     absentReasons: ['no-folders'] satisfies ContextAuditRefusal[],
     counts: contextCounts,
   },
-  {
-    id: 'placement',
-    label: 'Context placement',
-    // Pinned to the regex layer rather than the resolved classifier setting.
-    // A count that moves with whichever model a machine runs is not
-    // comparable across clones, and the model layer turns a sub-second read
-    // into a multi-minute one. `document-health` is where the model reads.
-    argv: ['context', 'classify', 'sweep', '--backend', 'off', '--json'],
-    gatingExits: [],
-    corpus: 'tracked',
-    counts: placementCounts,
-  },
   {
     id: 'markdown',
     label: 'Markdown corpus',

package/src/claude/cases/misc.ts

@@ -17,6 +17,11 @@ export const MISC_CASES: readonly SkillCase[] = [
       'Which layer of this landing page should I settle first, and what has to stay constant across it?',
     expect: 'design-taste',
   },
+  {
+    prompt:
+      'This settings form needs validation and an empty state, so what does it owe for keyboard users and error messages before I build it?',
+    expect: 'ui-craft',
+  },
   {
     prompt:
       'This project has no logo yet. Draft one and give me a social card to go with it.',