@erclx/canon 5.62.0 → 5.63.0

package/governance/ledger/ui/design-taste.md

@@ -1,19 +0,0 @@
----
-title: Design taste rule ledger
-description: Sources for governance/rules/ui/design-taste.md, one row per bullet
----
-
-# Design taste rule ledger
-
-The rule is a pointer to the `design-taste` skill, which carries its own sources, so both rows are house choices naming the bug the pointer prevents.
-
-## Authority
-
-| Bullet                     | Source                                                                                                                                                                     | Read       |
-| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
-| Load the skill             | House choice: a style edit made without the layer order or the coherence locks reaches for a model's defaults, and a second copy of them in the rule drifts from the skill | 2026-10-18 |
-| Report an unresolved skill | House choice: the rule ships with the CLI and the skill with the plugin, so a project holding governance alone would otherwise proceed silently without it                 | 2026-10-18 |
-
-## Declined
-
-The rewrite kept both bullets unchanged.

package/governance/ledger/ui/interface-casing.md

@@ -1,47 +0,0 @@
----
-title: Interface casing rule ledger
-description: Sources for governance/rules/ui/interface-casing.md, one row per bullet
----
-
-# Interface casing rule ledger
-
-The field is content design, and the authority is the GOV.UK style guide, which sets sentence case for every heading and title. The label count and the scope bullets are canon's own.
-
-## 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 |
-
-## Declined
-
-Every bullet the rewrite removed or reshaped, grouped by why.
-
-### 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.
-
-### Merged or reworded
-
-- 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.

package/governance/ledger/ui/link-behavior.md

@@ -1,29 +0,0 @@
----
-title: Link behavior rule ledger
-description: Sources for governance/rules/ui/link-behavior.md, one row per bullet
----
-
-# Link behavior rule ledger
-
-The field is interaction design, and the authority is the Nielsen Norman Group's research on new windows and tabs.
-
-## 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.
-
-### 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/rules/ui/copy.md

@@ -1,28 +0,0 @@
----
-description: Enforce UI copy and text standards for rendered strings in components
-paths:
-  - '**/*.tsx'
-  - '**/*.jsx'
-  - '**/*.astro'
-  - '**/*.html'
----
-
-# UI copy standards
-
-## Punctuation
-
-- Write no em dash (`—`) or semicolon in rendered copy. Use a comma or a period, or restructure the sentence.
-- Add no trailing punctuation to a button label or a short action string.
-
-## Button copy
-
-- Label a button with the verb of the action it performs, such as `Save` or `Delete`, never with filler such as `Click to delete`.
-
-## Error messages
-
-- Tell the person how to fix the error, such as `Enter an email address` over `Email is invalid`.
-- Keep an error message to one short sentence in plain language, with no technical jargon or error codes.
-
-## Placeholder text
-
-- Never use placeholder text as a label, a hint, or an example. Put a format example such as `name@example.com` in hint text under the label.

package/governance/rules/ui/design-taste.md

@@ -1,18 +0,0 @@
----
-description: Route edits that decide how a surface looks to the design-taste skill for the layer ordering, the coherence locks, and the defaults a model reaches for
-paths:
-  - '**/*.tsx'
-  - '**/*.jsx'
-  - '**/*.astro'
-  - '**/*.html'
-  - '**/*.css'
-  - '**/*.scss'
-  - 'canon/DESIGN.md'
----
-
-# Design taste standards
-
-## Authority
-
-- Load the `canon:design-taste` skill for which design decision settles first, what must stay constant across a surface, and the defaults to reach past. It is the single source for all three.
-- Report it rather than proceeding silently when the skill does not resolve. It ships with the plugin and this rule ships with the CLI, so a project that installed governance alone does not have it.

package/governance/rules/ui/interface-casing.md

@@ -1,29 +0,0 @@
----
-description: Enforce casing for interface text in markup, MDX, and content modules, where copy lives in a content folder
-paths:
-  - '**/*.tsx'
-  - '**/*.jsx'
-  - '**/*.astro'
-  - '**/*.html'
-  - '**/*.mdx'
-  - '**/content/**/*.ts'
----
-
-# Interface casing standards
-
-## Sentence case
-
-- Use sentence case for rendered headings, labels, nav items, tab titles, and dialog titles, since title case on every heading reads as a template default.
-- Keep the original casing of a proper noun or product name, such as `GitHub`, `macOS`, or `TypeScript`.
-
-## Uppercase labels
-
-- Keep small uppercase labels above headings to `ceil(sections / 3)`, the first screen counting as one. Delete the extra labels, since position already names a section.
-
-## Where it applies
-
-- Apply the same casing to interface copy kept outside the globs, such as a locale file, which this rule never fires on.
-
-## Overriding
-
-- Depart from sentence case only where the case needs it, such as an acronym, a brand mark, or a set-in-caps identity the design chose on purpose.

package/governance/rules/ui/link-behavior.md

@@ -1,19 +0,0 @@
----
-description: Enforce the same-tab default for an outbound link and for a mail link
-paths:
-  - '**/*.tsx'
-  - '**/*.jsx'
-  - '**/*.astro'
-  - '**/*.html'
----
-
-# Link behavior standards
-
-## Default target
-
-- Open a link in the same tab. Reserve `target="_blank"` for a page the person must consult while finishing a task in the current one.
-- Never add `target="_blank"` as a default for every external link.
-
-## mailto: links
-
-- Open a `mailto:` link in the same tab. It hands off to the mail client rather than replacing the page, so a new tab leaves an empty tab behind.