@erclx/canon 5.79.0 → 5.80.0

package/claude/skills/search-craft/REQUIREMENT.md

@@ -9,14 +9,14 @@ description: Why a session needs a thinking step before an outside search, deriv
 
 A session reaching outside the project runs one generic `WebSearch` and takes what ranks highest. Open results skew to third-party pages, two summaries of the same query can disagree on a fact, and an advocacy source can lean the answer. Scoped to authorities the session names itself, the same query returns primary sources.
 
-Access is a second gap a session cannot derive. Some sites refuse a fetch, a feed that answered once stops answering, and a free route to others does not exist. `plan-groundwork` and `write-doc` require an outside source and give no route to one.
+Access is a second gap a session cannot derive. Some sites refuse a fetch and others have no free route, while `plan-groundwork` and `write-doc` require an outside source and give no route to one. A quote drafted from recall is a third, since it runs no search and reads as exact while its wording or attribution is wrong.
 
 ## Must
 
 - Name the field before a query is written, and derive its authorities from the kind of body the field trusts
-- Run the query scoped to those authorities and open beside it, prefer the scoped result on a conflict, and say the two disagreed
-- Check a scoped result's domain before citing it, since the filter is not strict
+- Run the query scoped to those authorities and open beside it, prefer the scoped result on a conflict and say so, and check a scoped result's domain before citing it
 - Prefer a public API over a fetched page where one exists, and keep an access note grown from failures a session hit, dated by the commit that adds each line
+- Quote a source only from a page or ledger row read in the session, with a quoting trigger in the description that reaches a session running no search
 - Stop for the operator before a paid or logged-in route, and close with the practice skill's excuses, red flags, checklist, and the sources adopted and declined with the reason for each
 
 ## Must not

package/claude/skills/search-craft/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: search-craft
-description: Carries the thinking step a session takes before it searches outside the project, naming the field, deriving who that field treats as authoritative, and running a search scoped to those sources beside an open one, plus a dated note on which sites refuse access. Use before any outside search for evidence, papers, documentation, statistics, or opinion, when a procedure loads it at its sourcing step, or when asked "find me the strongest evidence on X", "where should I look for this", "what does the research say", "find papers on", "look up the docs for", or "what are people saying about". Do NOT use to format a citation, which belongs to the surface writing it, to source a Claude Code subject, which is a direct fetch of Anthropic's docs index, or to generate an image, which is not search.
+description: Carries the thinking step a session takes before it searches outside the project, naming the field, deriving who that field treats as authoritative, and running a search scoped to those sources beside an open one, plus a dated note on which sites refuse access and the rule that a quote comes from a page read rather than recall. Use before any outside search for evidence, papers, documentation, statistics, or opinion, before quoting a source on any surface, when a procedure loads it at its sourcing step, or when asked "find me the strongest evidence on X", "where should I look for this", "what does the research say", "find papers on", "look up the docs for", or "what are people saying about". Do NOT use to format a citation, which belongs to the surface writing it, to source a Claude Code subject, which is a direct fetch of Anthropic's docs index, or to generate an image, which is not search.
 metadata:
   family: build
 ---
@@ -42,6 +42,10 @@ This skill carries the step before the search. Work out where the field's author
 - Prefer a source's public API over a fetched and summarized HTML page where one exists. An API returns the dates, authors, and identifiers a citation needs, which a summary can drop.
 - Reach the API with a plain request when it needs no key, rather than writing a wrapper for one search.
 
+## Quote what was read
+
+- Quote a source only from a page or a ledger row read in this session, never from recall, since a remembered quote reads as exact while its wording or attribution has drifted.
+
 ## Access note
 
 Each line is a claim measured once, and the commit that adds it carries the date. Sites change their blocking without notice, so re-check a line before relying on it. Add a line only for a failure a session actually hit.
@@ -65,6 +69,7 @@ Read `${CLAUDE_SKILL_DIR}/references/adopted.md` only when extending this guidan
 - You are about to write a query and have not named the field.
 - Every source you are about to cite came from one open search.
 - You named an authority because it is a site you remember, not because it is the kind of body the field trusts.
+- You are about to quote a source you have not opened in this session.
 
 ### Results and access
 
@@ -82,6 +87,12 @@ These flags fire after the search has run.
 - Every cited source's domain was checked, and a fact the summaries disagreed on was confirmed on the page itself.
 - No paid, logged-in, or scraped route was taken without the operator's answer.
 
+### Quotes
+
+A quote carries its own check, since it can reach a surface with no search run.
+
+- Every quote was copied from a page or a ledger row read in this session.
+
 ## What this delegates
 
 - The form a citation takes: the surface writing it, such as the standard the procedure writes to

package/claude/skills/target-scaffold/REQUIREMENT.md

@@ -0,0 +1,31 @@
+---
+name: target-scaffold
+description: Why an empty folder gets its own skill rather than a branch inside target-setup
+---
+
+# Scaffold requirement
+
+## Gap
+
+A developer in an empty folder has no skill to run. `target-setup` detects a stack from files that are not there yet, so it falls back to `base` and installs tooling onto nothing.
+
+The tested non-interactive starters sit in the stack manifests. A session left to improvise picks a scaffolder from memory, answers its prompts wrong, or writes into the wrong folder.
+
+## Must
+
+- Offer only the stacks the catalog reports as carrying a starter, read at runtime rather than hardcoded
+- Start the project through the CLI verb alone, so the starter that runs is the one `canon tooling verify` tests
+- Write nothing into a folder that already holds files, and route that folder to `target-setup`
+- Leave the project name to the person, refusing rather than renaming when a package manager would reject it
+- Hand the started project to `target-setup` with nothing resolved ahead of its own detection
+
+## Must not
+
+- Run a scaffolder command directly, which drifts from the manifest the verb reads
+- Pick a stack for a caller who named none
+- Depend on the author typing its name, since `target-setup` routes an empty folder here
+
+## Out of scope
+
+- Installing tooling, governance, and indexes on the started project, which `target-setup` owns
+- Shipping a starter template of its own, since the toolkit ships no application code

package/claude/skills/target-scaffold/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: target-scaffold
+description: Starts a new project on the toolkit from an empty folder. Asks for the stack and the project name, runs the stack's starter through `canon tooling scaffold`, then hands off to `target-setup`. Use when asked to "start a new project", "scaffold a project here", "start a new astro project here", "create a vite app from scratch", or "set up this empty folder". Assumes the `canon` CLI is on PATH. Do NOT use on a folder that already holds files, which is `target-setup`, or to change the stack of an existing project.
+metadata:
+  family: setup
+---
+
+# Scaffold
+
+Starts a project in an empty folder and hands it to `target-setup`. The CLI owns the starter command, the empty-folder test, and the name check, while this skill picks the arguments, runs the verb, and routes on its record. It runs no scaffolder itself. Nor does it name a stack.
+
+## Steps
+
+1. Resolve the target. The current folder is the default, and its folder name becomes the project name. When the request names a different project name, the target is a new subfolder of that name.
+2. Run `ls -A` on the target, where a subfolder that does not exist yet counts as empty. When it lists anything but `.git`, stop and route to `/canon:target-setup`, since the folder is already a project.
+3. Run `canon tooling list --json` and offer only the stacks whose `scaffold` is `true`. A stack without a starter is a layer synced onto a project.
+4. Resolve the stack. Take one the request named, or ask through the structured question surface with one option per offered stack.
+   - With no person present and no stack named, stop and list the offered names rather than picking one
+5. Preview the stack, the target, the project name, and the command, then run it:
+
+```bash
+canon tooling scaffold <stack> <target> --json
+```
+
+## Route on the record
+
+Branch on the record's `ok` and `reason` rather than on the exit, which a shell function wrapping `canon` can flatten to zero.
+
+| Record                                 | Route                                                                                                        |
+| -------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| `ok: true`                             | Report the `files` it moved, then hand off below                                                             |
+| `bad-name`                             | Offer the record's `suggested` name as a subfolder target, and rerun only once the person accepts or renames |
+| `not-empty`                            | Route to `/canon:target-setup`, since something landed in the folder after step 2                            |
+| `scaffold-failed` or `no-output`       | Report the `message` and the `scratch` folder the verb kept, and stop. Nothing reached the target.           |
+| `no-scaffold`, `no-manifest`, or other | Report the `message` and stop, since the catalog read in step 3 and the verb disagree                        |
+
+Never rename the folder or retry with a name the person did not choose, since the folder name becomes the package name.
+
+## Hand off
+
+Invoke `canon:target-setup` with the target as the working folder. Its detect phase now finds the starter's files and resolves the stack from them, so pass it nothing this skill resolved.
+
+- The hand-off is the last step. Install, governance, verify, and indexes all belong to `target-setup`.
+- Report the stack, the target, the files the verb moved, and that setup ran, in that order.

package/claude/skills/target-setup/SKILL.md

@@ -55,7 +55,11 @@ else. Do not pause for a separate confirmation beyond the extras question.
 
 ## Declined states
 
-Three states reach this skill that the chain does not serve. Name the destination for each, so the refusal routes rather than ends.
+Four states reach this skill that the chain does not serve. Name the destination for each, so the refusal routes rather than ends.
+
+### An empty folder
+
+Stop before `detect` when the target holds nothing but `.git`, and hand off to `target-scaffold`. Detection reads a stack from files a project carries, so an empty folder resolves to `base` and installs tooling onto no project. That skill starts the project and hands it back here.
 
 ### An existing project
 

package/claude/skills/ui-checklist/SKILL.md

@@ -33,12 +33,16 @@ The evidence comment already heads the list with `## What to look at`, so the fi
 - [ ] <route>[, <width>]: <verb> <target> → <expected visual result>
 ```
 
+### The parts of a box
+
 Write each box so a session driving the running app can run it without guessing, with one rule for each part:
 
 - **Route.** A path or the control that reaches it. A box naming none is driven from the address the driver opens.
   - Write "from the page the app opens on" for a state reached by a sequence.
 - **Width.** Only when the change can differ by width, such as layout, spacing, or anything responsive. Copy, color, or a state rendering the same everywhere leaves it off.
-- **Verb.** An action a driver performs, such as "scroll to", "click", "resize to", or "tab to". Never "read" or "look at", which name no action.
+- **Verb.** An action a driver performs, such as "scroll to", "click", "resize to", "tab to", "wheel", "press", or "tap". Never "read" or "look at", which name no action.
+  - A changed surface that scrolls, snaps, or tracks the scroll takes "wheel" or "press" with the key, never "scroll to", which a scripted scroll passes on a page the wheel cannot move.
+  - A touch or hover behavior takes "tap" or "hover" at a phone width. A change that moves nothing takes no wheel box.
 - **Taste.** End the line with `(taste)` when the result is a judgment of look or feel. A driver reports such a box as needing a person's eyes rather than passing it.
 - **Setup.** State inline the setup the page does not open in and the fixture state it needs. End with `(local only)` when a hosted preview cannot reach it, such as a stopped service.
 - **Fixture.** End with `(needs fixture)` when the drive fixture lacks the state. The builder adds it, or with no `canon/config/app-drive.toml` writes the setup inline and drops the marker.

package/claude/skills/ui-craft/SKILL.md

@@ -15,15 +15,15 @@ Load this before building rather than after, since a missing state or a trapped
 
 Read every reference on the always row for any rendered change, then each row the change matches.
 
-| The change                                                         | Read                                  |
-| ------------------------------------------------------------------ | ------------------------------------- |
-| Any rendered change                                                | `a11y.md`, `keyboard.md`, `states.md` |
-| A click, press, drag, gesture, or popover dismissal                | `pointer.md`                          |
-| A form, a field, validation, or a sign-in step                     | `forms.md`                            |
-| An animation, transition, autoplay, or carousel                    | `motion.md`                           |
-| A destructive action, an edit cancel, or a hover or disabled state | `controls.md`                         |
-| A rendered string, heading, label, or link                         | `copy.md`                             |
-| A rendered surface has changed and is about to be handed over      | `capture.md`                          |
+| The change                                                                                           | Read                                  |
+| ---------------------------------------------------------------------------------------------------- | ------------------------------------- |
+| Any rendered change                                                                                  | `a11y.md`, `keyboard.md`, `states.md` |
+| A click, press, drag, gesture, or popover dismissal                                                  | `pointer.md`                          |
+| A form, a field, validation, or a sign-in step                                                       | `forms.md`                            |
+| An animation, transition, autoplay, carousel, or scroll-driven or dragged motion                     | `motion.md`                           |
+| A destructive action, an edit cancel, a hover or disabled state, or chrome that looks like a control | `controls.md`                         |
+| A rendered string, heading, label, or link                                                           | `copy.md`                             |
+| A rendered surface has changed and is about to be handed over, or a change scrolls or snaps          | `capture.md`                          |
 
 Each name sits under `${CLAUDE_SKILL_DIR}/references/`. A row's reference is read whole, since its sections name the cases a change reaches without saying so.
 

package/claude/skills/ui-craft/references/adopted.md

@@ -12,11 +12,13 @@ Every bullet in a reference has its own source row in a ledger outside the plugi
 Each field below names the source its references cite, and a house choice covers a threshold or a scope no source states.
 
 - **Web accessibility.** The W3C's [WCAG 2.2](https://www.w3.org/TR/WCAG22/) and the [ARIA Authoring Practices Guide](https://www.w3.org/WAI/ARIA/apg/) back the accessibility, keyboard, pointer, and motion references.
-- **CSS behavior.** [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS) and the CSS specifications back the focus ring, `color-scheme`, and overflow bullets.
+- **CSS behavior.** [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS) and the CSS specifications back the focus ring, `color-scheme`, overflow, cursor, and hover query bullets.
 - **Native targets.** Apple's and Android's platform guidelines back the native touch target figures in `pointer.md`.
 - **Forms and copy.** The [GOV.UK Design System](https://design-system.service.gov.uk/) and its style guide back `forms.md` and the copy and casing sections of `copy.md`.
+- **Interaction design.** [Ben Shneiderman](https://www.cs.umd.edu/~ben/)'s direct manipulation paper and the motion system of [Material Components](https://github.com/material-components/material-components-android) back the reader-paced section of `motion.md`.
+- **Web performance.** Google's [web.dev](https://web.dev/) guidance on layout shift backs the held-size bullet in `motion.md`.
 - **Usability research.** The [Nielsen Norman Group](https://www.nngroup.com/articles/) backs most of `states.md`, part of `controls.md`, and the link sections of `copy.md`.
-- **Capture.** `capture.md` is a house procedure, with its reflow width taken from the WCAG reflow criterion `a11y.md` cites.
+- **Capture.** `capture.md` is a house procedure, with its reflow width taken from the WCAG reflow criterion `a11y.md` cites. Its keyboard pass for a change that moves rests on WCAG 2.1.1 Keyboard.
 
 ## Where the rows sit
 

package/claude/skills/ui-craft/references/capture.md

@@ -35,6 +35,14 @@ Only a change with no visible result in any reachable state is exempt, such as a
 - Capture a state case at one width, driving states a first render cannot reach, such as an open menu.
 - Add a surface's case with the surface, and remove it with the surface.
 
+## What a moving change owes
+
+- Verify a change that scrolls, snaps, or tracks the scroll with the input a person uses, at each width it is captured at. A scripted `scrollIntoView` only brings a target into view.
+- Send the wheel in 100 px notches at two paces, spaced and in a burst, since a snap or scroll-linked page can stall at one pace and move at the other.
+- Move the same surface with the keyboard, through the arrow keys and Page Down, since a surface the wheel moves and the keys cannot fails keyboard operation.
+- Sample the motion at fixed steps across its range, reading the position after each notch or key, never only where it ends.
+- Drive a touch or hover behavior in a touch session, since a resized desktop window keeps hover on and cannot fail a hover query.
+
 ## Sharing a capture
 
 - Write a capture into a folder named `evidence`, which the pull request comment collects from.

package/claude/skills/ui-craft/references/controls.md

@@ -12,7 +12,13 @@
 - Say why a control is disabled, in text beside it or a tooltip, and keep it focusable through `aria-disabled` when the reason matters.
 - Declare `color-scheme` on `:root` to match each theme, so scrollbars and form controls follow the theme instead of staying light.
 
+## Signifiers
+
+- Give nothing a control's look, such as a button fill or a tab underline, unless it acts, since the look promises a response.
+- Keep the default cursor on decorative chrome, such as a mock tab bar, a status pill, or an address bar.
+
 ## Hover and focus effects
 
 - Keep content shown on hover or focus dismissible without moving the pointer, hoverable, and visible until the trigger leaves or the person dismisses it (WCAG 1.4.13).
 - Change no context, such as navigating, submitting, or moving focus, when a control gains focus or changes value, unless the person was told first (WCAG 3.2.1, 3.2.2).
+- Put hover styles behind `@media (hover: hover)`, since a touch screen keeps the last tapped element in hover.

package/claude/skills/ui-craft/references/motion.md

@@ -6,6 +6,12 @@
 - Halt an auto-advancing carousel or ticker while it holds keyboard focus or pointer hover.
 - Never flash content more than three times in any one second (WCAG 2.3.1).
 
+## Motion the reader drives
+
+- When the reader sets the pace, as with a scroll, a drag, or a swipe, move by the input rather than a timer, so stopping halfway leaves the motion halfway and reversing the input reverses it.
+- Never blend two texts mid-transition. Swap them at a threshold so every moment shows one readable state, with no blank frame between them.
+- Keep a component's outer size fixed while it animates, or swaps instantly under reduced motion, letting its contents give and take room inside it, so the page around it never moves.
+
 ## Reduced motion
 
 - Honor `prefers-reduced-motion: reduce` for every animation and transition that conveys no state. Remove it or replace it with an instant change.

package/claude/skills/ui-film/references/take-craft.md

@@ -83,6 +83,8 @@ Two rules hold once a beat is filmed.
 - Use a `move` to a point only for a target the page reveals on hover, and follow it with the click
 - Read each target off the served page before writing it. The verb refuses `target-missing` rather than filming a guess, and a refusal costs a reload.
 
+Both forms reach inside an open shadow root, such as a web component banner. A document-tree match wins over one inside a root, unless a `text=` match contains the root's match, where the inner one wins. A selector cannot span a shadow boundary, and a target inside a closed root or a frame refuses as missing.
+
 ## The pointer
 
 - Draw no pointer in the page. The edit draws one from the log at a constant size, and two pointers on one frame leave the viewer guessing which one acted.

package/docs/agents/output-shape.md

@@ -46,7 +46,7 @@ Discover names at runtime rather than hardcoding them.
 
 | Command                           | Returns                                                          |
 | --------------------------------- | ---------------------------------------------------------------- |
-| `canon tooling list --json`       | Stacks, extends chain, dep and script counts                     |
+| `canon tooling list --json`       | Stacks, extends chain, dep and script counts, scaffold flag      |
 | `canon gov list --json`           | Governance stacks, rule sets, evidence, and unreferenced rules   |
 | `canon gov detect --json`         | Opt-in rules a target's dependencies and paths propose           |
 | `canon claude seeds list --json`  | Seed doc sources with content                                    |
@@ -75,6 +75,7 @@ canon tooling sync astro /path/to/project --write
 canon tooling inject base /path/to/project --configs --seeds
 canon tooling prune-gitignore base /path/to/project
 canon tooling verify vite-react
+canon tooling scaffold astro /path/to/empty-folder --json
 canon audits run --json
 canon secrets scan --json
 canon deps audit --json

package/docs/target/projects.md

@@ -36,8 +36,8 @@ To develop against a checkout, run `claude --plugin-dir <toolkit>/claude`.
 
 ## Scaffold
 
-1. Run the framework's own scaffold if the project needs one, such as `bun init` or `npm create vite`
-2. Invoke `canon:target-setup` in Claude Code. It detects the stack, previews the chain with the opt-in rules `canon gov detect` proposes, and runs it on your confirmation.
+1. In an empty folder, invoke `canon:target-scaffold`. It asks for the stack, runs the stack's starter, and hands off to `canon:target-setup`.
+2. Otherwise invoke `canon:target-setup` in Claude Code. It detects the stack, previews the chain with the opt-in rules `canon gov detect` proposes, and runs it on your confirmation.
 
 The chain runs these phases:
 

package/docs/workflow/skill-map.md

@@ -10,10 +10,11 @@ Groups run in the order a project meets them. Every name `canon claude skills li
 
 ## Set up a project
 
-| Skill                | When to use                                   |
-| -------------------- | --------------------------------------------- |
-| `canon:target-setup` | On a fresh scaffold, to run the install chain |
-| `canon:deploy-app`   | When a project is ready to publish            |
+| Skill                   | When to use                                       |
+| ----------------------- | ------------------------------------------------- |
+| `canon:target-scaffold` | In an empty folder, to start a project on a stack |
+| `canon:target-setup`    | On a fresh scaffold, to run the install chain     |
+| `canon:deploy-app`      | When a project is ready to publish                |
 
 ## Decide what to build
 
@@ -26,6 +27,7 @@ Groups run in the order a project meets them. Every name `canon claude skills li
 | `canon:plan-groundwork`    | The state is unmeasured and approaches compete     |
 | `canon:decision-escalate`  | Open decisions turn on your preference             |
 | `canon:proposal-critique`  | A proposal needs questioning before it is built    |
+| `canon:design-references`  | A design round has no real site to look at         |
 | `canon:design-pick`        | The call is taste, wanting candidates side by side |
 | `canon:task-board`         | A decided item needs a file on the board           |
 | `canon:plan-feature`       | The approach is settled and needs a plan           |
@@ -44,7 +46,7 @@ Groups run in the order a project meets them. Every name `canon claude skills li
 | `canon:deprecation-migration` | Deleting or replacing code something may call      |
 | `canon:code-craft`            | Before writing a function, class, or module        |
 | `canon:review-craft`          | Reviewing a change                                 |
-| `canon:search-craft`          | Before searching outside the project               |
+| `canon:search-craft`          | Before searching outside or quoting a source       |
 | `canon:systematic-debugging`  | A test fails or a bug surfaces                     |
 | `canon:design-taste`          | Drafting or judging an interface                   |
 | `canon:ui-craft`              | Building or judging a component's behavior         |

package/docs/workflow/visual-design-workflow.md

@@ -75,10 +75,14 @@ A close posts as `## UI review closed`. The reviewers lift the draft mark on the
 
 Most projects author design in the loop above and need nothing more. Start with `canon:design-pick`, which drafts candidates as frames on a [Frameboard](https://www.npmjs.com/package/frameboard) board and takes your pick, then record the pick with `canon:design-record`. `canon:design-identity` drafts a logo mark and social card the same way.
 
+- Run `canon:design-references` first when a round has nothing real to look at, with a site address or bare to capture the project's list and then a default one.
+- It fills a `references` page on the same board with section shots at each width, a filmed scroll, and a few hovers, each frame naming its source.
+
 A pick round drafts on `.canon/board/` unless the project names another board in `canon/config/design.toml`.
 
 - Set `board` when your design sync reads another Frameboard board, so the picked frame lands without a redraw.
 - Leave `project` unset to keep rounds in their own `picks` project on that board.
+- Set `references` to an array of site addresses to replace the default list `canon:design-references` captures when you name no site.
 
 A graphical tool earns its place when design is the product, a designer owns it, and it changes more often than code. Then the tool is the source of truth, and `canon/DESIGN.md` carries a top note naming the upstream project.
 

package/governance/ledger/skills/design-references/SKILL.md

@@ -0,0 +1,38 @@
+---
+title: Design references skill ledger
+description: Sources for claude/skills/design-references/SKILL.md, being the copy-structure rule, the DESIGN.md collection and its license, and the capture and film decisions behind the steps
+---
+
+# Design references skill ledger
+
+The field is design practice and content licensing. A reference library's own terms carry where copying stops, and the community DESIGN.md collection's license carries what a run may fetch and read. The capture and film steps rest on measurements a groundwork track took against four live sites, so their rows are house choices naming the failure each prevents.
+
+The skill is not a practice skill, so this ledger cites the rules a reader would contest rather than every bullet. Steps that call a verb route to it and take no row.
+
+## What a draft may take
+
+| Bullet                                | Source                                                                                                                                                                   | Read       |
+| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
+| Take layout, rhythm, and shape        | [Mobbin MCP](https://mobbin.com/mcp): "Do not copy protected designs, branding, text, or assets verbatim."                                                               | 2026-11-08 |
+| Never another product's text or marks | [Mobbin MCP](https://mobbin.com/mcp): the same line, read as the boundary a reference library sets for a draft drawn from it                                             | 2026-11-08 |
+| Never a value named as a value        | House choice: a draft taking another site's colors, sizes, and fonts ships that site's brand, and a value written into a caption is copied by the next arm that reads it | 2026-11-08 |
+| Name the source on every frame        | House choice: a frame with no source on a board of designs reads as a design, so a later round lands a reference in the record as though the project drew it             | 2026-11-08 |
+
+## Name what the shots show
+
+| Bullet                        | Source                                                                                                                                                                                                                                                                         | Read       |
+| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
+| The community collection      | [VoltAgent awesome-design-md, License](https://github.com/VoltAgent/awesome-design-md/blob/fcc70284932276d085f01ef9f83edde90b1258cb/README.md#license): MIT, and "The extracted design tokens represent publicly visible CSS values."                                          | 2026-11-08 |
+| Vocabulary alone, no value    | [VoltAgent awesome-design-md, License](https://github.com/VoltAgent/awesome-design-md/blob/fcc70284932276d085f01ef9f83edde90b1258cb/README.md#license): "We do not claim ownership of any site's visual identity." The tokens stay the site's brand, so a run reads names only | 2026-11-08 |
+| Pinned commit, bumped by hand | House choice: a moving head changes the vocabulary between two runs of one site, so two references pages read in different words. The pin is the head on the read date                                                                                                         | 2026-11-08 |
+| An absent file never stops it | House choice: the collection covers about eighty sites, so most sites an operator names have no file, and a run stopping there captures nothing                                                                                                                                | 2026-11-08 |
+
+## Capture and film
+
+| Bullet                                  | Source                                                                                                                                                                            | Read       |
+| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| One shot per section                    | House choice: a full-page image of a long site cannot be scanned, and sections cut where a designer would name them came back on Notion, Vercel, and Linear in a groundwork spike | 2026-11-08 |
+| Film a scroll rather than trust a still | House choice: a still at one scroll position painted Notion's scroll-linked logo strip over its hero in a groundwork spike, and a filmed scroll showed it where a visitor sees it | 2026-11-08 |
+| Hovers at desktop alone                 | House choice: a phone has no hover, and a mobile session reported `(hover: hover)` false in a groundwork spike                                                                    | 2026-11-08 |
+| One hover per take                      | House choice: a take refuses whole on one missing target, so a hover picked from a snapshot that misses would otherwise cost every film beside it                                 | 2026-11-08 |
+| No browser script of its own            | House choice: a fix to how a page is shot lands once in `canon capture` or `canon take` rather than in every session's script                                                     | 2026-11-08 |

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

@@ -5,35 +5,39 @@ description: Sources for claude/skills/design-taste/SKILL.md, one row per bullet
 
 # Design taste skill ledger
 
-The field is visual design judgment. Jesse James Garrett's planes carry the layer order, the Nielsen Norman Group carries redesign strategy and tone, and Josh Comeau carries shadow lighting. The ten defaults are catalog observations, as in the `tells.md` ledger, recording model output and never cited as an authority. `## What this delegates` routes, so it takes no table.
+The field is visual design judgment. Garrett's planes carry the layer order, NN/g carries redesign, tone, and control consistency, Apple carries motion, and Comeau carries shadow lighting. The ten defaults are catalog observations, as in the `tells.md` ledger, recording model output and never cited as an authority. `## What this delegates` routes, so it takes no table.
 
-No outside authority takes a side on the four grey-box rules, three layer rules, the focus ring lock, or the greenfield mode. Each of those nine rows is a house choice naming the failure it prevents.
+No outside authority takes a side on the four grey-box rules, four layer rules, the focus ring lock, or the greenfield mode. Each of those ten rows is a house choice naming the failure it prevents. The row leading story and content cites Garrett for the order and names its in-round half as a house choice.
 
 ## The defaults you are reaching past
 
-| Bullet                       | Source                                                                                                                                                                                                                                         | Read       |
-| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
-| 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 |
-| 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 |
-| The violet-to-blue accent    | Catalog observation, [Taste-Skill tells](https://github.com/leonxlnx/taste-skill/blob/main/skills/taste-skill/references/tells.md): "Violet / indigo gradients on hero, buttons and glows" are banned, reached past with "flat colour"         | 2026-10-24 |
-| Numbered labels              | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "Step 1 / Step 2 / Step 3" is banned, since "The actual step content is the label" | 2026-10-24 |
-| The scroll cue               | 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."                                                          | 2026-10-24 |
-| A dot before every item      | 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"                      | 2026-10-24 |
-| A glow for elevation         | 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 |
-| A screenshot built of shapes | 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"                                         | 2026-10-24 |
-| Placeholder that announces   | Catalog observation, [Redesign skill](https://github.com/nxpatterns/claude-taste-skill/blob/main/skills/redesign-skill/SKILL.md): "Placeholder company names like "Acme Corp"", replaced with "contextual, believable brand names"             | 2026-10-24 |
-| Warm verbs over meaning      | Catalog observation, [Redesign skill](https://github.com/nxpatterns/claude-taste-skill/blob/main/skills/redesign-skill/SKILL.md): "Never use "Elevate", "Seamless", "Unleash"", and "Write plain, specific language"                           | 2026-10-24 |
+| Bullet                       | Source                                                                                                                                                                                                                                                                                                          | Read       |
+| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| 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 |
+| 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 |
+| The violet-to-blue accent    | Catalog observation, [Taste-Skill tells](https://github.com/leonxlnx/taste-skill/blob/main/skills/taste-skill/references/tells.md): "Violet / indigo gradients on hero, buttons and glows" are banned, reached past with "flat colour"                                                                          | 2026-10-24 |
+| Numbered labels              | Catalog observation, [Taste-Skill v2 experimental](https://github.com/Leonxlnx/taste-skill-classics/blob/main/skills/taste-skill-v2-experimental/SKILL.md): "Step 1 / Step 2 / Step 3" is banned, since "The actual step content is the label"                                                                  | 2026-10-24 |
+| The scroll cue               | 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."                                                                                                                           | 2026-10-24 |
+| A dot before every item      | 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"                                                                                       | 2026-10-24 |
+| A glow for elevation         | 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 |
+| A screenshot built of shapes | 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"                                                                                                          | 2026-10-24 |
+| Placeholder that announces   | Catalog observation, [Redesign skill](https://github.com/nxpatterns/claude-taste-skill/blob/main/skills/redesign-skill/SKILL.md): "Placeholder company names like "Acme Corp"", replaced with "contextual, believable brand names", and "Lorem Ipsum. Never use placeholder latin text. Write real draft copy." | 2026-10-24 |
+| Warm verbs over meaning      | Catalog observation, [Redesign skill](https://github.com/nxpatterns/claude-taste-skill/blob/main/skills/redesign-skill/SKILL.md): "Never use "Elevate", "Seamless", "Unleash"", and "Write plain, specific language"                                                                                            | 2026-10-24 |
 
 ## The layers, and the order they settle
 
-| Bullet                                 | Source                                                                                                                                                                                                                         | Read       |
-| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
-| A higher layer over a broken lower one | [Garrett, The Elements of User Experience, ch. 2](http://www.jjg.net/elements/pdf/elements_ch02.pdf): "the choices available to us on each plane are constrained by the decisions we make about issues on the planes below it" | 2026-10-24 |
-| A lower layer through a finished one   | House choice: a finished palette, type, and imagery hide a weak composition or layout, so the round judges the wrong layer and passes it                                                                                       | 2026-10-24 |
-| A round varies one layer               | House choice: a round varying several layers yields a pick that cannot say which difference decided it, so the next round repeats the question                                                                                 | 2026-10-24 |
-| Never settle a higher layer first      | [Garrett, The Elements of User Experience, ch. 2](http://www.jjg.net/elements/pdf/elements_ch02.pdf): "Each plane is dependent on the planes below it."                                                                        | 2026-10-24 |
-| Real copy before the composition sets  | House choice: a composition settled against stand-in copy breaks once real copy of another length and tone runs through it                                                                                                     | 2026-10-24 |
-| Check the layers below the complaint   | [Garrett, The Elements of User Experience, ch. 2](http://www.jjg.net/elements/pdf/elements_ch02.pdf): "When the choices we make don't align with those above and below, projects often derail"                                 | 2026-10-24 |
+| Bullet                                 | Source                                                                                                                                                                                                                                                                                                                                  | Read       |
+| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| A higher layer over a broken lower one | [Garrett, The Elements of User Experience, ch. 2](http://www.jjg.net/elements/pdf/elements_ch02.pdf): "the choices available to us on each plane are constrained by the decisions we make about issues on the planes below it"                                                                                                          | 2026-10-24 |
+| A lower layer through a finished one   | House choice: a finished palette, type, and imagery hide a weak composition or layout, so the round judges the wrong layer and passes it                                                                                                                                                                                                | 2026-10-24 |
+| A round varies one layer               | House choice: a round varying several layers yields a pick that cannot say which difference decided it, so the next round repeats the question                                                                                                                                                                                          | 2026-10-24 |
+| Never settle a higher layer first      | [Garrett, The Elements of User Experience, ch. 2](http://www.jjg.net/elements/pdf/elements_ch02.pdf): "Each plane is dependent on the planes below it."                                                                                                                                                                                 | 2026-10-24 |
+| Story and content lead, in words       | [Garrett, The Elements of User Experience, ch. 2](http://www.jjg.net/elements/pdf/elements_ch02.pdf): "decisions on the strategy plane will have a sort of "ripple effect" all the way up the chain." Settling them inside the requested round is a house choice, since words drawn as arms give a pick no visual difference to compare | 2026-11-08 |
+| Check the layers below the complaint   | [Garrett, The Elements of User Experience, ch. 2](http://www.jjg.net/elements/pdf/elements_ch02.pdf): "When the choices we make don't align with those above and below, projects often derail"                                                                                                                                          | 2026-10-24 |
+| The story settles once per page        | [Garrett, The Elements of User Experience, ch. 2](http://www.jjg.net/elements/pdf/elements_ch02.pdf): strategy covers "what the people running the site want to get out of it but what the users want to get out of the site as well"                                                                                                   | 2026-11-08 |
+| An arc only where the kind requires it | House choice: an arc demanded of an application surface orders tools as an argument nobody reads, while a marketing page with none orders its claims by template                                                                                                                                                                        | 2026-11-08 |
+| Sort a fact by deleting its section    | House choice: a page-wide fact written into each card drifts between sections, so the voice reads differently in the seventh section than in the first                                                                                                                                                                                  | 2026-11-08 |
+| One content card per section           | [Garrett, The Elements of User Experience, ch. 2](http://www.jjg.net/elements/pdf/elements_ch02.pdf): "scope takes the form of content requirements: a description of the various content elements that will be required."                                                                                                              | 2026-11-08 |
 
 ## Grey-box when judging layers 1 to 4
 
@@ -46,14 +50,16 @@ No outside authority takes a side on the four grey-box rules, three layer rules,
 
 ## Lock what must not vary across a surface
 
-| Bullet                | Source                                                                                                                                                                                                                                           | Read       |
-| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
-| One accent            | Catalog observation, [Redesign skill](https://github.com/nxpatterns/claude-taste-skill/blob/main/skills/redesign-skill/SKILL.md): "More than one accent color. Pick one. Remove the rest."                                                       | 2026-10-24 |
-| One radius system     | 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" is reached past with "Square or fully round, chosen once" | 2026-10-24 |
-| One theme             | Catalog observation, [Redesign skill](https://github.com/nxpatterns/claude-taste-skill/blob/main/skills/redesign-skill/SKILL.md): "A single dark-background section breaking an otherwise light page looks like a copy-paste accident."          | 2026-10-24 |
-| One copy register     | [NN/g, The Four Dimensions of Tone of Voice](https://www.nngroup.com/articles/tone-of-voice-dimensions/): "Keep your brand personality consistent", the part that backs one register per composition                                             | 2026-10-24 |
-| One light source      | [Comeau, Designing Beautiful Shadows in CSS](https://www.joshwcomeau.com/css/designing-shadows/): "we should decide on a single light source for all elements on the page", and black shadow "also desaturates it quite a bit"                   | 2026-10-24 |
-| One focus ring weight | House choice: a focus ring varying by component reads as several products on one surface. The `ui-craft` skill owns the visibility floor                                                                                                         | 2026-10-24 |
+| Bullet                    | Source                                                                                                                                                                                                                                                                                                     | Read       |
+| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| One accent                | Catalog observation, [Redesign skill](https://github.com/nxpatterns/claude-taste-skill/blob/main/skills/redesign-skill/SKILL.md): "More than one accent color. Pick one. Remove the rest."                                                                                                                 | 2026-10-24 |
+| One radius system         | 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" is reached past with "Square or fully round, chosen once"                                                           | 2026-10-24 |
+| One theme                 | Catalog observation, [Redesign skill](https://github.com/nxpatterns/claude-taste-skill/blob/main/skills/redesign-skill/SKILL.md): "A single dark-background section breaking an otherwise light page looks like a copy-paste accident."                                                                    | 2026-10-24 |
+| One copy register         | [NN/g, The Four Dimensions of Tone of Voice](https://www.nngroup.com/articles/tone-of-voice-dimensions/): "Keep your brand personality consistent", the part that backs one register per composition                                                                                                       | 2026-10-24 |
+| One light source          | [Comeau, Designing Beautiful Shadows in CSS](https://www.joshwcomeau.com/css/designing-shadows/): "we should decide on a single light source for all elements on the page", and black shadow "also desaturates it quite a bit"                                                                             | 2026-10-24 |
+| One focus ring weight     | House choice: a focus ring varying by component reads as several products on one surface. The `ui-craft` skill owns the visibility floor                                                                                                                                                                   | 2026-10-24 |
+| One control style per job | [NN/g, Consistency and Standards](https://www.nngroup.com/articles/consistency-and-standards/): "they should use the same patterns everywhere inside the system"                                                                                                                                           | 2026-11-08 |
+| One motion model per kind | [Apple HIG, Motion](https://developer.apple.com/design/human-interface-guidelines/motion): "Many system components automatically include motion, letting you offer familiar and consistent experiences throughout your app or game." The three model names are a house choice, since the source names none | 2026-11-08 |
 
 ## Working on something that already exists
 

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

@@ -15,6 +15,7 @@ Impeccable's three mode references sort a surface by what the visitor came to do
 | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
 | Optimizes for comprehension    | Catalog observation, [Impeccable persuade mode](https://github.com/pbakaus/impeccable/blob/main/skill/reference/mode-persuade.md): "the opening must make the offer intelligible and desirable, expose a clear action"                                                          | 2026-10-24 |
 | Composition carries the weight | House choice: a palette round run against a flat composition changes nothing a stranger notices, since section order is what they judge first                                                                                                                                   | 2026-10-24 |
+| The story carries an arc       | House choice: a page with no stated arc orders its sections by template, so a stranger meets the proof before the claim it backs                                                                                                                                                | 2026-11-08 |
 | Vary the section shape         | 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 |
 | Low density                    | Catalog observation, [Redesign skill](https://github.com/nxpatterns/claude-taste-skill/blob/main/skills/redesign-skill/SKILL.md): "Dense layouts work for data dashboards, not for marketing pages."                                                                            | 2026-10-24 |
 | Every claim names a real thing | Catalog observation, [Impeccable persuade mode](https://github.com/pbakaus/impeccable/blob/main/skill/reference/mode-persuade.md): the opening must "demonstrate something only this product can prove"                                                                         | 2026-10-24 |