@erclx/canon 5.68.0 → 5.69.0

package/docs/target/projects.md

@@ -56,7 +56,7 @@ Keep the `## Scripts` table in `canon/context/development/local-loop.md` current
 Before the first feature session:
 
 1. Fill `canon/REQUIREMENTS.md` with the problem, goals, and non-goals. The seed's 600-word cap gates under `canon context audit`.
-2. For a UI project, write `canon/DESIGN.md` from the seed and name the stylesheet in its lead, or work the direction out with `canon:pick-by-eye`
+2. For a UI project, write `canon/DESIGN.md` from the seed and name the stylesheet in its lead, or work the direction out with `canon:design-pick`
 3. Optionally invoke `canon:draw-figure` for an architecture view. The Mermaid CLI downloads on first use.
 4. Start the feature loop in [AI workflow](../workflow/ai-workflow.md)
 

package/docs/target/sync.md

@@ -48,7 +48,7 @@ Add `--json` for a machine-readable report and `--exit-code` to fail CI when a t
 - Tooling dependencies: a dependency on a later major than the stack pins reads as `ahead`, and sync leaves it
 - Index regeneration: `canon indexes regen`
 
-After `canon gov sync` applies, it lists each rule it copied with its globs and how many project files match. A `ui/` rule adds a pointer to `/canon:ux-audit`. `--json` writes `{ "coverage": [{ "rule", "paths", "files", "ui" }] }` to stdout, empty when nothing was copied, with `files` null outside git. The report never changes the exit code.
+After `canon gov sync` applies, it lists each rule it copied with its globs and how many project files match. A `ui/` rule adds a pointer to `/canon:ui-audit`. `--json` writes `{ "coverage": [{ "rule", "paths", "files", "ui" }] }` to stdout, empty when nothing was copied, with `files` null outside git. The report never changes the exit code.
 
 Try a scenario from [sandbox](../../canon/context/development/sandbox.md) before syncing a real project.
 

package/docs/workflow/skill-map-on-request.md

@@ -15,11 +15,10 @@ These skills serve a request rather than a moment. With the [skill map](skill-ma
 | `canon:create-rule`     | A project rule the toolkit does not ship          |
 | `canon:create-skill`    | A new `SKILL.md`                                  |
 | `canon:write-doc`       | A new `docs/` page, context entry, or `README.md` |
-| `canon:plan-ready`      | Finished files a worker should copy               |
 | `canon:draw-figure`     | A figure or architecture view inside a doc        |
 | `canon:ci-workflow`     | A GitHub Actions workflow file                    |
 | `canon:design-identity` | A logo mark and social card                       |
-| `canon:ui-record`       | Real footage of the app for a video               |
+| `canon:ui-film`         | Real footage of the app for a video               |
 
 ## Answer a question at any point
 

package/docs/workflow/skill-map.md

@@ -24,7 +24,7 @@ Groups run in the order a project meets them. Every name `canon claude skills li
 | `canon:backlog-triage`     | The backlog needs pruning                          |
 | `canon:plan-groundwork`    | The state is unmeasured and approaches compete     |
 | `canon:decision-escalate`  | Open decisions turn on your preference             |
-| `canon:pick-by-eye`        | The call is taste, wanting candidates side by side |
+| `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           |
 | `canon:codebase-layout`    | A change adds a file and needs a folder            |
@@ -53,8 +53,8 @@ Groups run in the order a project meets them. Every name `canon claude skills li
 | Skill                   | When to use                                    |
 | ----------------------- | ---------------------------------------------- |
 | `canon:document-health` | Documents must answer for length and staleness |
-| `canon:ux-audit`        | To read UI source for missing states           |
-| `canon:ux-measure`      | To measure paint, processor, and layout cost   |
+| `canon:ui-audit`        | To read UI source for missing states           |
+| `canon:ui-measure`      | To measure paint, processor, and layout cost   |
 | `canon:app-drive`       | To drive a built app with the operator         |
 
 ## Ship it
@@ -100,10 +100,9 @@ Groups run in the order a project meets them. Every name `canon claude skills li
 
 ## Keep the project current with the toolkit
 
-| Skill                         | When to use                                             |
-| ----------------------------- | ------------------------------------------------------- |
-| `canon:target-check`          | In a target, to compare each domain with the toolkit    |
-| `canon:target-update`         | After a release, to catch a target up to the toolkit    |
-| `canon:document-repair`       | Rewrite a failing docs folder to the limits and gate it |
-| `canon:canon-feedback`        | The toolkit is broken, missing, or off                  |
-| `canon:canon-feedback-triage` | In the toolkit repo, to file feedback issues            |
+| Skill                   | When to use                                             |
+| ----------------------- | ------------------------------------------------------- |
+| `canon:target-check`    | In a target, to compare each domain with the toolkit    |
+| `canon:target-update`   | After a release, to catch a target up to the toolkit    |
+| `canon:document-repair` | Rewrite a failing docs folder to the limits and gate it |
+| `canon:canon-feedback`  | The toolkit is broken, missing, or off                  |

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

@@ -72,7 +72,12 @@ A close posts as `## UI review closed`. The reviewers lift the draft mark on the
 
 ## Design authoring
 
-Most projects author design in the loop above and need nothing more. Start with `canon:pick-by-eye`, 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.
+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.
+
+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.
 
 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/claude/background.md

@@ -0,0 +1,26 @@
+---
+title: Background rule ledger
+description: Decisions behind governance/rules/claude/background.md, one row per bullet
+---
+
+# Background rule ledger
+
+The rule is a core rule, so every row is a house choice rather than a citation. Each names what goes wrong without its bullet and the option the bullet beat, with the date it was decided.
+
+## Slow commands
+
+| Bullet                            | Source                                                                                                                                                                                         | Read       |
+| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| Background past about a minute    | House choice: a foreground run holds the conversation, so the operator waits on a check they could have talked over. It beat a warning hook, which would only warn and still let the run block | 2026-10-26 |
+| Name the slow kinds               | House choice: a minute is a guess made before the run, and with no cases to match a session reads a full check as quick. It beat the threshold alone                                           | 2026-10-26 |
+| Keep a seconds command foreground | House choice: each wake costs a turn, so backgrounding a quick command spends two turns where one did. It beat backgrounding every command                                                     | 2026-10-26 |
+| End the turn on one status line   | House choice: a turn that stops silently leaves the operator unable to tell a wait from a stall. It beat ending on the tool call alone                                                         | 2026-10-26 |
+| Keep working beside a server      | House choice: a dev server or a watch never exits, so a session awaiting its wake waits forever. It beat treating every background command as awaited                                          | 2026-10-26 |
+
+## Waking
+
+| Bullet                            | Source                                                                                                                                                                                | Read       |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| Act on the wake, never a guess    | House choice: a session guessing a command is done reads a partial output as the result. It beat checking the output file on a hunch                                                  | 2026-10-26 |
+| No sleep, poll, or scheduled wait | House choice: a foreground sleep or poll holds the conversation the rule freed, and a scheduled prompt spends a turn on every check. It beat all three as ways to wait on one command | 2026-10-26 |
+| Keep a skill's own wait           | House choice: a skill owns the verb and the timeout it waits on, such as a review-state wait, and one rule-wide wait would override it. It beat a single wait for every caller        | 2026-10-26 |

package/governance/rules/claude/background.md

@@ -0,0 +1,19 @@
+---
+description: Run a command that may take more than about a minute in the background and resume on the harness wake, so the operator keeps the conversation
+---
+
+# Background standards
+
+## Slow commands
+
+- Start a command that may run past about a minute with `run_in_background: true`, since a foreground run holds the conversation. Revisit when a foreground Bash call stops blocking the turn.
+- Treat a full check, a sandbox run, a capture or render, a build, and a wait on another session as slow.
+- Keep a command expected to finish in seconds in the foreground, since each wake costs a turn.
+- End the turn on one line naming what runs, when the next step needs that command's result.
+- Keep working beside a server or a watch the session never waits on, since it never exits and its wake never comes.
+
+## Waking
+
+- Act on the wake the harness sends when an awaited command exits, never on a guess about when it is done. Revisit when a background Bash command stops waking the session at exit.
+- Never wait with a foreground `sleep`, a foreground poll loop, or a scheduled prompt for one wait. The background run and its wake replace all three.
+- Keep a skill's own wait as the skill states it, since the skill owns the verb and the timeout it waits on.

package/governance/stacks/base.toml

@@ -12,4 +12,5 @@ rules = [
   "tasks",
   "plan",
   "markdown",
+  "background",
 ]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@erclx/canon",
   "type": "module",
-  "version": "5.68.0",
+  "version": "5.69.0",
   "description": "Runs your agent's work and keeps its code good, on one setup for every repo.",
   "license": "MIT",
   "bin": {
@@ -25,9 +25,9 @@
     "access": "public"
   },
   "scripts": {
-    "format": "oxfmt . && prettier --write --log-level warn 'web/**/*.astro' && shfmt --write --indent 2 scripts/ tooling/ claude/",
-    "check:format": "oxfmt --check . && prettier --check --log-level warn 'web/**/*.astro' && shfmt --diff --indent 2 scripts/ tooling/ claude/",
-    "check:shell": "find scripts tooling claude .claude/hooks -name '*.sh' -exec shellcheck --severity=warning {} + && find .husky -maxdepth 1 -type f -exec shellcheck --severity=warning --shell=sh {} +",
+    "format": "oxfmt . && prettier --write --log-level warn 'web/**/*.astro' && shfmt --write --indent 2 scripts/ tooling/ claude/ src/",
+    "check:format": "oxfmt --check . && prettier --check --log-level warn 'web/**/*.astro' && shfmt --diff --indent 2 scripts/ tooling/ claude/ src/",
+    "check:shell": "find scripts tooling claude src .claude/hooks -name '*.sh' -exec shellcheck --severity=warning {} + && find .husky -maxdepth 1 -type f -exec shellcheck --severity=warning --shell=sh {} +",
     "check:lint": "oxlint --disable-nested-config --max-warnings 0",
     "check:types": "tsc --noEmit",
     "check:install": "bun scripts/core/install-check.ts",

package/scripts/ci/install-playwright-deps.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# Installs the Playwright system packages for the named browsers, killing an
+# attempt that outlives its bound and retrying it. A degraded apt mirror hangs
+# one connection rather than failing it, so a step timeout alone turns the
+# hang into a red check and never recovers it, while a fresh attempt usually
+# lands on a healthy backend.
+#
+# Usage: install-playwright-deps.sh [--package <spec>] <browser>...
+# Exits 0 on the first success, 2 when no browser is named, and the last
+# attempt's code when every attempt fails.
+set -e
+
+package=playwright
+if [ "$1" = "--package" ]; then
+  package=$2
+  shift 2
+fi
+
+if [ $# -eq 0 ]; then
+  echo "Usage: install-playwright-deps.sh [--package <spec>] <browser>..." >&2
+  exit 2
+fi
+
+attempts=3
+bound=${INSTALL_ATTEMPT_SECONDS:-150}
+
+# The runner image sets these, yet a stalled log shows gaps of minutes, so
+# print what apt actually reads to settle whether they took effect
+apt-config dump | grep -E '^Acquire::(Retries|http::Timeout) ' || true
+
+status=0
+for attempt in $(seq 1 "$attempts"); do
+  if [ "$attempt" -gt 1 ]; then
+    # timeout runs as the runner user, and Linux drops its signal to the root
+    # apt-get playwright spawns through sudo. sudo relays it only to its own
+    # child shell, so a root apt-get or dpkg can outlive the kill and hold the
+    # lock the next attempt needs.
+    sudo pkill -KILL -x 'apt-get|dpkg' || true
+    # A kill during unpack leaves dpkg interrupted, which refuses the next
+    # install. Its own failure must not end the loop.
+    sudo dpkg --configure -a || echo "dpkg --configure -a failed before attempt ${attempt}" >&2
+  fi
+
+  status=0
+  timeout --kill-after=10 "$bound" bunx "$package" install-deps "$@" || status=$?
+  if [ "$status" -eq 0 ]; then
+    exit 0
+  fi
+  echo "attempt ${attempt}/${attempts} failed with exit ${status}" >&2
+done
+
+exit "$status"

package/src/claude/cases/authoring.ts

@@ -26,8 +26,8 @@ export const AUTHORING_CASES: readonly SkillCase[] = [
   },
   {
     prompt:
-      'I already wrote the finished skill files, package them as a ready folder with a plan and a task for a worker to copy.',
-    expect: 'plan-ready',
+      'I already wrote the finished wording for a small new reference file, put it in a plan so a worker lands it exactly as written.',
+    expect: 'plan-feature',
   },
   {
     prompt: 'This project has no README.md at all, write one from scratch.',

package/src/claude/cases/misc.ts

@@ -10,7 +10,7 @@ export const MISC_CASES: readonly SkillCase[] = [
   {
     prompt:
       'Show me a few different treatments for this callout so I can pick one by looking.',
-    expect: 'pick-by-eye',
+    expect: 'design-pick',
   },
   {
     prompt:

package/src/claude/cases/setup.ts

@@ -54,11 +54,6 @@ export const SETUP_CASES: readonly SkillCase[] = [
       "Whatever the right toolkit command is, get this project's rules installed.",
     expect: 'target-setup',
   },
-  {
-    prompt:
-      'File the open feedback issues on the toolkit repo into an intake folder.',
-    expect: 'canon-feedback-triage',
-  },
   // This answers one fixed question across a fixed domain list and repairs
   // nothing, which is what separates it from the setup skill above.
   {

package/src/claude/cases/workflow.ts

@@ -143,11 +143,11 @@ export const WORKFLOW_CASES: readonly SkillCase[] = [
   {
     prompt:
       'Look over the interface and tell me what feels unfinished or confusing.',
-    expect: 'ux-audit',
+    expect: 'ui-audit',
   },
   {
     prompt: 'Tell me the paint and layout cost of this page right now.',
-    expect: 'ux-measure',
+    expect: 'ui-measure',
   },
   {
     prompt:
@@ -162,12 +162,12 @@ export const WORKFLOW_CASES: readonly SkillCase[] = [
   {
     prompt:
       'I need real footage of the board import flow for the launch video. Film it from our app so HyperFrames can zoom in on the clicks.',
-    expect: 'ui-record',
+    expect: 'ui-film',
   },
   {
     prompt:
       'Shoot the takes for the storyboard we wrote, one clip per beat of the app doing its thing.',
-    expect: 'ui-record',
+    expect: 'ui-film',
   },
   {
     prompt:
@@ -216,10 +216,10 @@ export const WORKFLOW_CASES: readonly SkillCase[] = [
   },
   {
     prompt: 'Find the rough, unfinished-feeling spots in this interface.',
-    expect: 'ux-audit',
+    expect: 'ui-audit',
   },
   {
     prompt: 'Tell me the render cost of this page in the browser.',
-    expect: 'ux-measure',
+    expect: 'ui-measure',
   },
 ]

package/src/commands/fixtures/gh.sh

@@ -0,0 +1,64 @@
+#!/usr/bin/env bash
+# Fake gh for src/commands/pr.test.ts. Reads FAKE_GH_FX, FAKE_GH_COMMENTS, and FAKE_GH_API_LOG.
+set -o pipefail
+fx="$FAKE_GH_FX"
+f=.
+p=
+for a in "$@"; do
+  [ "$p" = --jq ] && f=$a
+  p=$a
+done
+case "$*" in
+*graphql* | "pr "* | "repo view"*) exit 1 ;;
+api*pulls/7/files*)
+  echo "$*" >>"$fx/files-calls.log"
+  [ -f "$fx/files-fail" ] && exit 1
+  {
+    if [ -f "$fx/files.tsv" ]; then
+      cat "$fx/files.tsv"
+    else
+      git diff --name-status --no-renames main...HEAD | sed -e 's/^A/added/' -e 's/^M/modified/' -e 's/^D/removed/'
+    fi
+  } | jq -Rn '[inputs | select(length > 0) | split("\t") | {status: .[0], filename: .[1]}]' | jq -r "$f"
+  ;;
+api*git/trees/*)
+  [ -f "$fx/base-tree.json" ] || exit 1
+  jq -r "$f" "$fx/base-tree.json"
+  ;;
+api*contents/*)
+  a="$*"
+  p=${a##*contents/}
+  p=${p%%\?*}
+  r=${a##*ref=}
+  [ -f "$fx/img/$r-$(basename "$p")" ] && cat "$fx/img/$r-$(basename "$p")" || exit 1
+  ;;
+api*compare/*)
+  if [ -f "$fx/merge-base" ]; then cat "$fx/merge-base"; else git merge-base main HEAD; fi
+  ;;
+"api -X PUT repos/{owner}/{repo}/pulls/7/reviews/"*)
+  id=${4##*/}
+  echo "$id" >>"$fx/review-puts.log"
+  [ -f "$fx/review-put-fail-$id" ] && exit 1
+  printf '%s\n' "${@: -1}" >>"$fx/review-bodies.log"
+  echo "{}"
+  ;;
+api*pulls/7/reviews*) [ -f "$fx/ui-reviews.json" ] && jq -r "$f" "$fx/ui-reviews.json" ;;
+api*issues/7/comments*) jq '[.comments[] | {html_url: .url, body}]' "$FAKE_GH_COMMENTS" | jq -r "$f" ;;
+"api -X PATCH repos/{owner}/{repo}/pulls/7 "*)
+  [ -f "$fx/body-fail" ] && exit 1
+  printf '%s' "${@: -1}" >"$fx/body-write.log"
+  echo "{}"
+  ;;
+"api repos/{owner}/{repo}/pulls/7")
+  if [ -f "$fx/head" ]; then h=$(cat "$fx/head"); else h=$(git rev-parse HEAD); fi
+  b=
+  [ -f "$fx/pr-body" ] && b=$(cat "$fx/pr-body")
+  jq -n --arg h "$h" --arg b "$b" '{number:7,head:{ref:"feat/x",sha:$h},base:{ref:"main"},mergeable_state:"clean",body:$b}'
+  ;;
+"api repos/{owner}/{repo}") echo "{\"full_name\":\"o/r\"}" ;;
+api*)
+  printf '%s' "${@: -1}" >"$FAKE_GH_API_LOG"
+  echo "{}"
+  ;;
+*) exit 1 ;;
+esac

package/src/commands/gov.ts

@@ -34,6 +34,7 @@ import {
 } from '@/gov/restated'
 import {
   auditExit,
+  CORE_FOLDERS,
   hasFinding,
   PRACTICE_FOLDERS,
   readRuleAudit,
@@ -62,6 +63,11 @@ import {
   readTestOrder,
   type TestOrderReport,
 } from '@/gov/test-order'
+import {
+  type ChangedSet,
+  collectChangedFiles,
+  commandRunner,
+} from '@/gate/sequencer'
 import { recordStamp, runDomainSync } from '@/sync/engine'
 import { detectRules } from '@/gov/detect'
 import { writeChainStamp } from '@/sync/stamp'
@@ -138,6 +144,7 @@ interface AuditOptions {
   readonly root?: string
   readonly json?: boolean
   readonly gate?: boolean
+  readonly touched?: boolean
 }
 
 /** What a reader does about each way the sweep produced no reading. */
@@ -613,6 +620,10 @@ export function register(program: Command): void {
       '--gate',
       'Set 2 only for a finding in a gated folder, which the push stage reads',
     )
+    .option(
+      '--touched',
+      'Owe a ledger for each core rule the branch changed against origin/main',
+    )
     .addHelpText(
       'after',
       [
@@ -632,6 +643,9 @@ export function register(program: Command): void {
         `  asks a ledger of each rule under ${PRACTICE_FOLDERS.join(', ')}`,
         '  at governance/ledger/<folder>/<slug>.md, one table row per bullet',
         '  under a heading of the same name.',
+        `  A rule under ${CORE_FOLDERS.join(', ')} has its ledger checked where`,
+        '  one exists, and under --touched owes one once the branch changed it.',
+        '  With no baseline against main, --touched reads no rule as touched.',
         '  Any other tree reads .claude/rules/project/ alone and asks no ledger.',
         '  .claude/rules/canon/ is fixed at the toolkit source and never read',
         '  unless named. A named path resolves against --root and must sit',
@@ -654,6 +668,7 @@ export function register(program: Command): void {
         '  canon gov audit',
         '  canon gov audit .claude/rules/project/api.md',
         '  canon gov audit --json',
+        '  canon gov audit --gate --touched',
         '',
       ].join('\n'),
     )
@@ -672,7 +687,13 @@ async function runAudit(
   opts: AuditOptions,
 ): Promise<number> {
   const root = resolve(opts.root ?? process.cwd())
-  const report = await readRuleAudit(root, paths)
+  const changed = opts.touched
+    ? await collectChangedFiles(commandRunner(root))
+    : undefined
+  // An unscoped set lists nothing, and reading it as every file would owe a
+  // ledger of every core rule on a branch that touched none of them.
+  const touched = changed?.scoped ? changed.files : []
+  const report = await readRuleAudit(root, paths, { touched })
   const emitJson = opts.json ?? false
 
   if (report.kind === 'unreadable') {
@@ -690,7 +711,7 @@ async function runAudit(
     return 1
   }
 
-  reportAudit(report, root, paths.length > 0)
+  reportAudit(report, root, paths.length > 0, changed)
 
   if (emitJson) {
     process.stdout.write(
@@ -700,6 +721,9 @@ async function runAudit(
         limits: RULE_LIMITS,
         gated: RULE_GATED_FOLDERS,
         exempt: RULE_GATE_EXEMPT,
+        ...(changed === undefined
+          ? {}
+          : { touched: { scoped: changed.scoped } }),
         ...report,
       })}\n`,
     )
@@ -728,6 +752,7 @@ function reportAudit(
   report: Extract<RuleAuditReport, { kind: 'measured' }>,
   root: string,
   named: boolean,
+  changed: ChangedSet | undefined,
 ): void {
   intro('canon gov audit')
 
@@ -761,10 +786,15 @@ function reportAudit(
   }
 
   logStep('Ledgers')
+  if (changed !== undefined && !changed.scoped) {
+    logInfo(
+      'no baseline against main, so --touched reads no core rule as touched',
+    )
+  }
   if (report.scope === 'target') {
     logInfo('not read, since ledgers live in the toolkit and never ship')
   } else if (ledgers.length === 0) {
-    logInfo('every outside-practice rule has a ledger row per bullet')
+    logInfo('every rule owing a ledger has one, with a row per bullet')
   } else {
     for (const line of ledgers) logWarn(line)
   }

package/src/commands/migrate.ts

@@ -1309,6 +1309,13 @@ export function register(program: Command): void {
         'any ordinal evidence/ already carries. The dry run labels every',
         'derived destination, so check the split before passing --write.',
         '',
+        'Moves the design board to the folder Frameboard names:',
+        '  canvas/                         -> board/',
+        '',
+        'Stop a frameboard serve on canvas/ before --write. A project holding',
+        'both folders gets a collision, and a design.toml board key naming',
+        '.canon/canvas is left for you to update.',
+        '',
         'A citation reaching into a moved folder or naming a moved file is',
         'repointed, live or archived. A bare mention of an emptied folder, such',
         'as review/evidence/ with no slug, matches no row and stays as written.',
@@ -1389,8 +1396,11 @@ export function register(program: Command): void {
         `It also carries ${Object.keys(SKILL_CITATION_MAP).length} namespaced-only rows for a skill renamed from a single word.`,
         'The seven draft- skills move onto verb-first names, such as',
         // The old spellings below are the rename itself. canon-keep-retired
-        'draft-doc to write-doc and draft-and-pick to pick-by-eye, and a',
-        'pointer left under each old name is never moved.',
+        'draft-doc to write-doc and draft-slides to make-deck, and a',
+        'pointer left under each old name is never moved. Four skills then',
+        'moved into the family their job belongs to, such as',
+        // canon-keep-retired
+        'ux-audit to ui-audit and pick-by-eye to design-pick.',
         'It takes no scope. The skill folders it moves are authored in the',
         'toolkit and no target holds a copy of that catalog, so in a target it',
         'rewrites citations of a renamed skill and moves nothing.',