@qijenchen/design-system 0.1.0-beta.35 → 0.1.0-beta.37

package/ds-canonical/skills/knowledge-prune/SKILL.md

@@ -7,7 +7,7 @@ description: Prune governance sprawl across CLAUDE.md / specs / skills / hooks /
 
 **目的**:本 DS governance 自身是活的知識庫,若只 append 會讓 CLAUDE.md 載入成本失控、MEMORY.md 條目爆炸、hook 變殭屍、spec.md 重複。本 skill 掃 8 個 home 找冗贅,提議 retire 候選,加嚴執行 Rule-of-3 SSOT + 行數預算。
 
-**對齊 CLAUDE.md `# 資訊治理 canonical`**:本 skill 是 L3(Periodic deep)實作。L1(pre-write hook)+ L2(fire log)自動執行,L3 需人決策 canonical retire,走 checkpoint。
+**對齊 CLAUDE.md `# 治理 canonical`**:本 skill 是 L3(Periodic deep)實作。L1(pre-write hook)+ L2(fire log)自動執行,L3 需人決策 canonical retire,走 checkpoint。
 
 **對齊 CLAUDE.md `# 稽核 canonical`「Audit-vs-execute 分權」**:動 canonical substantive meaning → **STOP 提議**;對齊 / 清 duplicate / 回填 pointer → **AUTO**。
 
@@ -72,7 +72,7 @@ Scan:同概念(同 keyword / 同 canonical)出現在 ≥ 3 個不同 home 寫完
 Example violations(historic — 2026-05-22 prune verify 後均已收斂為 pointer 模式,僅留作教學範例):
 - `Portal 逃脫 theme`:過去在 hover-card.spec.md / avatar.spec.md / color.spec.md 各重述;現只 M3 SSOT + 各 spec pointer。2026-05-22 audit verify 為已對齊(僅 ui-development.md / meta-patterns.md 2 home 涉及,clean pointer)
 - `Inline Action vs Button predicate`:過去 CLAUDE.md / item-anatomy.spec.md / button.spec.md 各完整;現 `inline-action.spec.md` 為 SSOT,其他 cross-link
-- 新範例(2026-05-22 抓):**hook count threshold** 在 CLAUDE.md L35 / meta-patterns M14 / M20 / `session_start_governance_check.sh:173` 4 處 drift 3 值(40/35/30)→ M14/M20 strip 數字改 pointer SSOT 修
+- 新範例(2026-05-22 抓):**hook count threshold** 在 CLAUDE.md `# 治理 canonical` 行數預算表 / meta-patterns M14 / M20 / `session_start_governance_check.sh` 4 處 drift 3 值(40/35/30)→ M14/M20 strip 數字改 pointer SSOT 修
 
 **Output**:duplicate cluster 清單 + 建議 SSOT home。
 
@@ -104,68 +104,19 @@ Example:
 
 **Output**:matrix of 衝突點 + 誰該讓步
 
-#### D5 — Canonical drift(spec vs code 語義漂移)— 2026-05-17 加
+#### D5-D10 — 2026-05-17 加維度(各維 scan + Example + Output 詳 references/prune-dimensions-d5-d10.md)
 
-Scan:`*.spec.md` 寫的 canonical vs `*.tsx` 實際 code 行為衝突 / spec 寫禁止但 code 仍用 / spec 升級但 code 沒跟。
-
-Example:
-- `radius.spec.md:57-71` 禁 `rounded-xl/2xl/3xl` → grep `packages/design-system/src/**/*.tsx` 仍有用 → drift
-- `field-controls.spec.md` v13 state machine 升級 → 但 Combobox.tsx 還是 v12 behavior → drift
-
-**Output**:per (spec, code) drift entry + 對應 commit hash 追溯 last alignment 時點
-
-#### D6 — Hook-fire health(log-driven)— 2026-05-17 加
-
-讀 `.claude/logs/hook-fires-per-hook.jsonl`,3 大病徵:
-- **Dead**:6 月 0 fire(retire 候選,per `# Retire rules` Hook 規則)
-- **Hot**(過 fire):fire / day > 50 → 可能 false positive 多 / regex 太鬆
-- **Toggle pattern**:同 fire 反覆 inject + retract → hook design 不穩
-
-**Output**:dead retire list + hot tune list + toggle re-design list
-
-#### D7 — Skill-invoke health(log-driven)— 2026-05-17 加
-
-讀 `.claude/logs/skill-invokes.jsonl`,2 大病徵:
-- **Unused**:3 月 0 invoke(除 rare-event skill 如 delivery-handoff)
-- **Always co-invoked**:Skill A 永遠跟 Skill B 一起 invoke → 該合 1 skill 或 chain auto
-
-**Output**:retire list + merge candidate list
-
-#### D8 — Memory recency / orphan— 2026-05-17 加
-
-Scan `~/.claude/.../memory/*.md`:
-- 6 月無 git log 變動 + 不在 MEMORY.md index head = stale candidate(per existing D2 retire rule)
-- file 存在但 MEMORY.md 沒 entry = orphan(可能 retire 漏刪)
-- entry 存在但 file 不在 = broken pointer
-
-**Output**:stale / orphan / broken pointer 3-class list
-
-#### D9 — Benchmark / citation debt(2026-05-17 加,對應 M22)
-
-Scan 全 repo:
-- `@benchmark-unverified-blanket` marker(per file retraction;codify 後該 backfill cite 變 verified)
-- spec.md / tsx 含 world-class DS keyword(Material / Polaris / Carbon / Ant / Atlassian / Apple)但無 inline URL / GitHub path / screenshot ref
-- 過期 benchmark(cite URL 是 v3 但 framework 已 v5)
-
-**Output**:per (file, claim) cite debt entry + 建議 WebFetch 補 source
-
-#### D10 — Verification artifact rot(2026-05-17 加,對應 M32)
-
-Scan 全 audit / test infra:
-- audit script 只驗 `getAttribute(...)` / `class.includes(...)` 不驗 `getBoundingClientRect()` numeric(pixel-quantified 缺)
-- `*.spec.md` 寫 visual canonical 但無對應 playwright snapshot 或 visual-audit 覆蓋
-- stale screenshot ref(snapshot file 6 月未更新)
-
-**Output**:per audit script 升 pixel-quantified 提名 + 缺 visual coverage 列表
+D5 Canonical drift(spec vs code)/ D6 Hook-fire health / D7 Skill-invoke health / D8 Memory recency-orphan / D9 Benchmark-citation debt(M22)/ D10 Verification artifact rot(M32)。
 
 ### Phase 2 — Triage + Checkpoint 1(MUST ASK)
 
 ```
-Phase 1 findings:
+Phase 1 findings(D1-D10):
 - D1 duplicate: M clusters
 - D2 dead/stale: N items
 - D3 over-concrete: K items (abstract proposals)
 - D4 contradiction: L pairs
+- D5-D10(2026-05-17 加,detail 詳 references/prune-dimensions-d5-d10.md): D5 canonical drift / D6 hook-fire health / D7 skill-invoke health / D8 memory recency-orphan / D9 benchmark-citation debt / D10 verification artifact rot — 各 N items
 
 Priority:
 - P0 (AUTO): 對齊 SSOT / 補 pointer / 刪 confirmed dead hook / retire unused skill — 表達層調整,不動 canonical 意思
@@ -188,15 +139,9 @@ Proceed with P0+P1 as atomic commit? Then discuss P2?
 - 每 P2 item 一個獨立 commit(animation trail 可回溯)
 - 新 meta-pattern 加進 CLAUDE.md `# Meta-Pattern 預警` → 同時**必檢討哪些下游條目冗餘**(上游加 = 下游減)
 
-### Phase Z reference — Cross-repo SSOT propagation(2026-05-26 retract skill-specific Phase Z,移到 CLAUDE.md canonical)
-
-**Per user 2026-05-26 correction**:「不是只要一 knowledge audit deep 之後就要,是等我 push main 後才要」。
+### Phase Z reference — Cross-repo SSOT propagation
 
-Cross-repo SSOT sync trigger 不是「skill 跑完」而是「push main 後 SSOT-affecting diff」— canonical 統一在:
-- `CLAUDE.md` `# Git solo-work canonical` Step 5.5
-- Hook `check_post_main_ssot_propagate.sh`(PostToolUse Bash 偵測 `git push origin main` + diff)
-
-→ /knowledge-prune skill 本身**不負責 trigger sync**;Phase 3-4 commit + Phase 6 user 拍板 push main 後,canonical hook 自動偵測 SSOT diff + 提議 npm bump。**整鏈 1 trigger 同時 cover /deep-audit-cross-codex / 一般 dev / 任何 SSOT-affecting 來源**(DRY,不複製到每個 skill)。
+詳 references/phase-z-cross-repo-ssot-propagation.md(2026-05-26 retract skill-specific Phase Z;sync trigger = push main 後 SSOT-affecting diff,canonical 在 CLAUDE.md `# Git solo-work canonical` Step 5.5 + hook check_post_main_ssot_propagate.sh)。
 
 ---
 
@@ -293,23 +238,11 @@ Phase 1 D3 發現 5+ 條下游條目可被新 meta 吸收 → 提議新 Meta-Pat
 
 ## 世界級對照
 
-本 skill 是本 DS 原創的自我 prune 機制,但對齊:
-
-- **Elasticsearch Index Lifecycle Management**:hot / warm / cold 階段自動降級 + delete old data — 類 retire rate
-- **Linux kernel doc policy**:Sphinx deprecation warnings + removal schedule — 類 transition period 過渡期
-- **Python PEP 387 Backwards Compatibility Policy**:明定哪些改動需 deprecation 期,哪些可立刻刪 — 類 P0 vs P2 triage
+詳 references/world-class-prune-alignment.md(Elasticsearch ILM / Linux kernel doc policy / Python PEP 387)。
 
 ## 與其他 skill 的分工
 
 | Skill | Scope | 不重疊點 |
 |-------|-------|---------|
-| `/design-system-audit` | **33 維 DS code + spec audit**(Phase 0 自建 baseline) | 不管治理文件冗贅 — 找 bug / drift,不 prune governance 大小 |
+| `/design-system-audit` | **full-dim DS code + spec audit**(Phase 0 自建 baseline) | 不管治理文件冗贅 — 找 bug / drift,不 prune governance 大小 |
 | `/knowledge-prune` | **治理文件冗贅 + 行數 + 矛盾** | 不 audit DS code 本體 — 管 governance 不管 DS |
-
----
-
-## Non-goals 重申
-
-- 不 refactor spec.md 內容(改寫走 `/design-system-audit`)
-- 不 retire 有 active consumer 的 rule(必先改 consumer)
-- 不處理 `git log` 歷史 / 歷史 commit 訊息

package/ds-canonical/skills/knowledge-prune/references/phase-z-cross-repo-ssot-propagation.md

@@ -0,0 +1,11 @@
+# Phase Z reference — Cross-repo SSOT propagation(knowledge-prune SKILL.md「Phase Z reference」extract)
+
+### Phase Z reference — Cross-repo SSOT propagation(2026-05-26 retract skill-specific Phase Z,移到 CLAUDE.md canonical)
+
+**Per user 2026-05-26 correction**:「不是只要一 knowledge audit deep 之後就要,是等我 push main 後才要」。
+
+Cross-repo SSOT sync trigger 不是「skill 跑完」而是「push main 後 SSOT-affecting diff」— canonical 統一在:
+- `CLAUDE.md` `# Git solo-work canonical` Step 5.5
+- Hook `check_post_main_ssot_propagate.sh`(PostToolUse Bash 偵測 `git push origin main` + diff)
+
+→ /knowledge-prune skill 本身**不負責 trigger sync**;Phase 3-4 commit + Phase 6 user 拍板 push main 後,canonical hook 自動偵測 SSOT diff + 提議 npm bump。**整鏈 1 trigger 同時 cover /deep-audit-cross-codex / 一般 dev / 任何 SSOT-affecting 來源**(DRY,不複製到每個 skill)。

package/ds-canonical/skills/knowledge-prune/references/prune-dimensions-d5-d10.md

@@ -0,0 +1,55 @@
+# Prune Phase 1 D5-D10 dimension detail(2026-05-17 加;knowledge-prune SKILL.md Phase 1 extract)
+
+#### D5 — Canonical drift(spec vs code 語義漂移)— 2026-05-17 加
+
+Scan:`*.spec.md` 寫的 canonical vs `*.tsx` 實際 code 行為衝突 / spec 寫禁止但 code 仍用 / spec 升級但 code 沒跟。
+
+Example:
+- `radius.spec.md:57-71` 禁 `rounded-xl/2xl/3xl` → grep `packages/design-system/src/**/*.tsx` 仍有用 → drift
+- `field-controls.spec.md` v13 state machine 升級 → 但 Combobox.tsx 還是 v12 behavior → drift
+
+**Output**:per (spec, code) drift entry + 對應 commit hash 追溯 last alignment 時點
+
+#### D6 — Hook-fire health(log-driven)— 2026-05-17 加
+
+讀 `.claude/logs/hook-fires-per-hook.jsonl`,3 大病徵:
+- **Dead**:6 月 0 fire(retire 候選,per `# Retire rules` Hook 規則)
+- **Hot**(過 fire):fire / day > 50 → 可能 false positive 多 / regex 太鬆
+- **Toggle pattern**:同 fire 反覆 inject + retract → hook design 不穩
+
+**Output**:dead retire list + hot tune list + toggle re-design list
+
+#### D7 — Skill-invoke health(log-driven)— 2026-05-17 加
+
+讀 `.claude/logs/skill-invokes.jsonl`,2 大病徵:
+- **Unused**:3 月 0 invoke(除 rare-event skill 如 delivery-handoff)
+- **Always co-invoked**:Skill A 永遠跟 Skill B 一起 invoke → 該合 1 skill 或 chain auto
+
+**Output**:retire list + merge candidate list
+
+#### D8 — Memory recency / orphan— 2026-05-17 加
+
+Scan `~/.claude/.../memory/*.md`:
+- 6 月無 git log 變動 + 不在 MEMORY.md index head = stale candidate(per existing D2 retire rule)
+- file 存在但 MEMORY.md 沒 entry = orphan(可能 retire 漏刪)
+- entry 存在但 file 不在 = broken pointer
+
+**Output**:stale / orphan / broken pointer 3-class list
+
+#### D9 — Benchmark / citation debt(2026-05-17 加,對應 M22)
+
+Scan 全 repo:
+- `@benchmark-unverified-blanket` marker(per file retraction;codify 後該 backfill cite 變 verified)
+- spec.md / tsx 含 world-class DS keyword(Material / Polaris / Carbon / Ant / Atlassian / Apple)但無 inline URL / GitHub path / screenshot ref
+- 過期 benchmark(cite URL 是 v3 但 framework 已 v5)
+
+**Output**:per (file, claim) cite debt entry + 建議 WebFetch 補 source
+
+#### D10 — Verification artifact rot(2026-05-17 加,對應 M32)
+
+Scan 全 audit / test infra:
+- audit script 只驗 `getAttribute(...)` / `class.includes(...)` 不驗 `getBoundingClientRect()` numeric(pixel-quantified 缺)
+- `*.spec.md` 寫 visual canonical 但無對應 playwright snapshot 或 visual-audit 覆蓋
+- stale screenshot ref(snapshot file 6 月未更新)
+
+**Output**:per audit script 升 pixel-quantified 提名 + 缺 visual coverage 列表

package/ds-canonical/skills/knowledge-prune/references/world-class-prune-alignment.md

@@ -0,0 +1,7 @@
+# knowledge-prune 世界級對照(knowledge-prune SKILL.md「世界級對照」extract)
+
+本 skill 是本 DS 原創的自我 prune 機制,但對齊:
+
+- **Elasticsearch Index Lifecycle Management**:hot / warm / cold 階段自動降級 + delete old data — 類 retire rate
+- **Linux kernel doc policy**:Sphinx deprecation warnings + removal schedule — 類 transition period 過渡期
+- **Python PEP 387 Backwards Compatibility Policy**:明定哪些改動需 deprecation 期,哪些可立刻刪 — 類 P0 vs P2 triage

package/ds-canonical/skills/new-component/SKILL.md

@@ -134,7 +134,7 @@ traits:
 
 **Phase 5.1-5.3 — 三層 stories**:
 
-1. **`{name}.stories.tsx` 展示**:per Phase 5.0 declared traits → 對照 `category-templates.md` 衍生 required core stories(`hasVariants` → AllVariants / `hasSizes` → AllSizes / `isOverlay` → OpenSnapshot 等)。再加 1-2 真實業務 scenario(Jira / Stripe / Notion 過 earn-existence)。Hook `check_story_category.sh` write-time 攔不符 trait core。
+1. **`{name}.stories.tsx` 展示**:per Phase 5.0 declared traits → 對照 `category-templates.md` 衍生 required core stories(`hasVariants` → AllVariants / `hasSizes` → AllSizes / `isOverlay` → OpenSnapshot 等)。再加 1-2 真實業務 scenario(Jira / Stripe / Notion 過 earn-existence)。Hook `check_story_invariants.sh` R3 category(原 check_story_category.sh folded 折入)write-time 攔不符 trait core。
 2. **`{name}.anatomy.stories.tsx` 設計規格**:5-story 標準(Overview + SizeMatrix + ColorMatrix + StateBehavior + Inspector)或合理 subset + rationale。
 3. **`{name}.principles.stories.tsx` 設計原則**(對齊 Polaris/Carbon/Ant canonical,2026-04-26):universal core ≥ 2 of {`WhenToUse` / `WhenNotToUse` / `Vs{Sibling}Rule` / `ContentGuidelines`}。do / don't 情境對照,每則 Rule title + Rule note + 範例。Hook `check_principles_canonical.sh` write-time 攔不符。
 

package/ds-canonical/skills/new-component/references/new-component-checklist.md

@@ -59,7 +59,7 @@
 - [ ] `{name}.principles.stories.tsx` 含 do/don't Rule stories,每則 title + note + 範例
 - [ ] 「人」test 過:遮標題 5 秒能懂情境
 - [ ] 「舉一反三」test 過:讀者推得出自己產品怎用
-- [ ] hook `check_story_anatomy.sh` 未觸發 block(無手刻 list item / label Button dismiss / 自刻 overlay)
+- [ ] hook `check_story_invariants.sh` R1 anatomy(原 check_story_anatomy.sh folded 折入)未觸發 block(無手刻 list item / label Button dismiss / 自刻 overlay)
 - [ ] Storybook title path 正確(`Design System/Components/{Name}/{中文子頁}` 或 `Internal/{Name}/...`)
 
 ## Phase 6 — Self quality-gate chain

package/ds-canonical/skills/product-ui-audit/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: product-ui-audit
-description: Audit product / consumer UI code (非 design-system 本身) against DS usage discipline + mindset adherence. Catches element misuse / design principle violations / token leakage / geometry bugs / a11y gaps across 6 dimensions. Invoke via /product-ui-audit when user says「audit 這個 UI」「檢查 X feature 用對 DS 嗎」「這段 code 符合設計原則嗎」,or auto-invoked by /prototype Phase 3.5 gate.
+description: Audit product / consumer UI code (非 design-system 本身) against DS usage discipline + mindset adherence. Catches element misuse / design principle violations / token leakage / geometry bugs / a11y gaps across 7 dimensions. Invoke via /product-ui-audit when user says「audit 這個 UI」「檢查 X feature 用對 DS 嗎」「這段 code 符合設計原則嗎」,or auto-invoked by /prototype Phase 3.5 gate.
 ---
 
 # Product UI Audit Workflow
@@ -38,24 +38,24 @@ Purpose: design-system-audit audits the **DS itself**(spec / cva / SSOT 三方
 ## Preconditions
 
 - User 指定 audit target(file path / folder / feature area)
-- Target 是 consumer 層 UI code(`src/app/**` / `src/explorations/**` / `src/pages/**` / `src/features/**`等 — **不掃 `packages/design-system/src/`**)
-- CLAUDE.md 全讀(6 維 audit 都依此為基準)
+- Target 是 consumer 層 UI code(`src/app/**` / `src/explorations/**` / `src/pages/**` / `src/features/**` / `apps/**`(含 DS repo 自家 `apps/template` + create-app 產物)等 — **不掃 `packages/design-system/src/`**)
+- CLAUDE.md 全讀(7 維 audit 都依此為基準)
 
 ---
 
-## 6-Dimension Audit
+## 7-Dimension Audit
 
 每個 dimension 獨立檢查,產出 findings。詳細 grep pattern + rule 見 `references/audit-checks.md`。
 
 ### Dim 1 — Token 紀律(token hygiene)
 
 - 硬寫 hex / rgb / rgba / hsl 色值
-- shadcn compat alias(bg-popover / text-muted-foreground / bg-accent / bg-destructive / bg-background / bg-card / border-input / text-primary-foreground / text-accent-foreground / text-card-foreground / text-popover-foreground)
+- shadcn compat alias(bg-popover / text-muted-foreground / bg-accent / bg-destructive / bg-background / bg-card / border-input / text-primary-foreground / text-accent-foreground / text-card-foreground / text-popover-foreground)**(完整 deny-list SSOT:`packages/design-system/src/tokens/utility-registry.json`;此處 inline 為 grep 便利,新增 alias 改 registry)**
 - Tailwind default shadow(shadow-sm / md / lg / xl / 2xl / inner)— 應走 elevation token
 - Tailwind v4 `[--foo]` shorthand 靜默失效
 - 硬寫 px 值當該用 token(`w-[48px]` 應改 token)
 
-此維對齊既有 `check_token_hygiene.sh` hook 的 4 項 + 擴充硬色值 / 硬 px 檢查。
+此維對齊既有 token 防線(`lib/_token_hygiene.sh` 5-check:shadcn alias / v4 shorthand / hardcoded shadow / primitive-color-as-utility / native overflow，由 `post_edit_dispatcher.sh` source；+ `check_opacity_token_usage.sh` 讀 utility-registry.json)+ 擴充硬色值 / 硬 px 檢查。
 
 ### Dim 2 — Layout primitive 消費(per CLAUDE.md 清單)
 
@@ -95,7 +95,7 @@ Purpose: design-system-audit audits the **DS itself**(spec / cva / SSOT 三方
 - **M4 真實業務場景**:stories / examples 用真實場景 (Jira / Stripe / Notion...)?無 `Option A/B/C` / `按鈕一` / `Rule A`?
 - **M5 猶豫就問**:code 裡有 TODO-未確認留白?
 
-### Dim 5 — 視覺幾何(Mindset #1 視覺擴充 + CLAUDE.md「同 flex 列互動 slot 幾何鐵律」)
+### Dim 5 — 視覺幾何(Mindset #1 視覺擴充 + .claude/references/ui-dev-rules.md「同 flex 列互動 slot 幾何鐵律」)
 
 - 同 flex 行的互動 slot box 尺寸一致(例:FileItem status / delete 都 h-field-sm)
 - hover-bg / ring / focus outline 不溢出 box 吃 gap token
@@ -133,7 +133,7 @@ chain `.claude/skills/design-system-audit/references/principle-audit-protocol.md
 
 ### Phase 1 — Parallel 6-dim audit
 
-6 個維度各自獨立 grep + code review。可 parallelize。
+7 個維度各自獨立 grep + code review。可 parallelize。
 
 ### Phase 2 — Report
 
@@ -225,6 +225,6 @@ audit 完畢報告應含:
 
 ## References
 
-- [references/audit-checks.md](references/audit-checks.md) — 6 維度具體 grep pattern + rule
+- [references/audit-checks.md](references/audit-checks.md) — 7 維度具體 grep pattern + rule
 - [references/common-misuses.md](references/common-misuses.md) — 常見元件誤用 negative example 庫
 - [references/report-template.md](references/report-template.md) — P0/P1/P2 severity 分類 + report 格式

package/ds-canonical/skills/product-ui-audit/references/audit-checks.md

@@ -1,4 +1,4 @@
-# Audit Checks — 6 維度 grep pattern + rule
+# Audit Checks — 7 維度 grep pattern + rule
 
 每個維度的具體 check。AI Phase 1 parallel 執行時依此 grep + rule 判斷。
 
@@ -12,7 +12,7 @@
 grep -nE '\b(bg-popover|text-popover-foreground|text-muted-foreground|bg-accent|text-accent-foreground|bg-destructive|bg-background|bg-card|text-card-foreground|border-input|text-primary-foreground)\b' {target}
 ```
 
-**Severity**: P0。**Fix**: 對映見 `check_token_hygiene.sh` hook。
+**Severity**: P0。**Fix**: 對映見 token 防線 `lib/_token_hygiene.sh` + `check_opacity_token_usage.sh`。
 
 ### Check 1.2: Tailwind default shadow
 
@@ -192,7 +192,7 @@ grep -nE '(TODO:\s*待確認|TODO:\s*decide|FIXME|XXX)' {target}
 
 例: FileItem `status slot(16px)` + `delete Button sm(28px)` = 不一致 → hover-bg 吃 gap。
 
-**Severity**: P0(世界級 DS 鐵律違反,違反 CLAUDE.md「同 flex 列的互動 slot 幾何鐵律」)。
+**Severity**: P0(世界級 DS 鐵律違反,違反 .claude/references/ui-dev-rules.md「同 flex 列的互動 slot 幾何鐵律」)。
 
 ### Check 5.2: 自造 typography tier
 

package/ds-canonical/skills/product-ui-audit/references/report-template.md

@@ -15,7 +15,7 @@
 - Dialog / Modal 無 DialogTitle
 - 非 button 綁 onClick(a11y 破壞)
 - 巢狀浮層 / 巢狀 Modal(HTML invalid 或 UX 破壞)
-- CLAUDE.md「同 flex 列互動 slot 幾何鐵律」違反
+- .claude/references/ui-dev-rules.md「同 flex 列互動 slot 幾何鐵律」違反
 
 **處理**: AI 可直接修(surgical fix),commit 時 user 一併 review。
 

package/ds-canonical/skills/propose-options/SKILL.md

@@ -1,15 +1,15 @@
 ---
 name: propose-options
-description: Auto-invoke when listing options / 建議 / 候選方案. Forces inline 4-Q principle check(M8 benchmark / M17 SSOT / Rule-of-3 / M10 subsumption)per option BEFORE listing. Failures filtered or labeled. Codifies「verify before propose」runtime discipline.
+description: Auto-invoke when listing options / 建議 / 候選方案. Forces inline 7-Q principle check(M8 benchmark / M17 SSOT / Rule-of-3 / M10 subsumption)per option BEFORE listing. Failures filtered or labeled. Codifies「verify before propose」runtime discipline.
 ---
 
-# /propose-options — Propose-time 4-Q Gate
+# /propose-options — Propose-time 7-Q Gate
 
-**目的**:Claude 對 user 提建議 / 列 option list 時,**先跑 4 題原則自檢**,通過才寫進回覆。Reject 的不列 OR 列出時標 fail 原因。
+**目的**:Claude 對 user 提建議 / 列 option list 時,**先跑 7 題原則自檢**,通過才寫進回覆。Reject 的不列 OR 列出時標 fail 原因。
 
 **對齊**:
 - CLAUDE.md mindset #1(不取巧)+ #2(消費既有)+ #5(猶豫就問)+ #6(meta 抽象)
-- M8 benchmark / M17 SSOT / M12 binary rule / 資訊治理「加規則前 3 題」
+- M8 benchmark / M17 SSOT / M12 binary rule / 治理「加規則前 3 題」
 - 本 skill 是上述 meta 的**propose-time 落地** — meta 寫成文字不夠,要 mechanical workflow 釘住
 
 ## When to invoke
@@ -27,9 +27,9 @@ description: Auto-invoke when listing options / 建議 / 候選方案. Forces in
 
 ---
 
-## Workflow(強制 6 題,缺一就 reject 此 option)
+## Workflow(強制 7 題,缺一就 reject 此 option)
 
-每個 candidate option 過以下 6 題,inline 寫進回覆:
+每個 candidate option 過以下 7 題,inline 寫進回覆:
 
 ### Q0 — **Pre-ASK self-verify problem 真存在**(2026-05-18 加,absorbs Sheet/inline-action/SurfaceBody 三題誤判事件)
 
@@ -93,7 +93,7 @@ description: Auto-invoke when listing options / 建議 / 候選方案. Forces in
 
 ### Q4 — M10 下游吸收
 **問**:本 option 加入後,既有哪些 rule / memory / bug case 被吸收可刪?
-**Fail**:純 append 沒 retire,違反「上游加 = 下游減」 + 資訊治理 anti-bloat
+**Fail**:純 append 沒 retire,違反「上游加 = 下游減」 + 治理 anti-bloat
 **例**:
 - ✅ "M18 加,M12 部分 overlap 但 scope 不同共存(說明)"
 - ❌ "新加 M18,既有 M-row 全保留(沒檢查)"
@@ -109,7 +109,7 @@ description: Auto-invoke when listing options / 建議 / 候選方案. Forces in
 
 ## Workflow Output Format
 
-對 user 回覆中的 option list 必含 **inline 5-Q 表 + Issue mapping**(plan iteration 場景):
+對 user 回覆中的 option list 必含 **inline 7-Q 表 + Issue mapping**(plan iteration 場景):
 
 ```markdown
 | 選項 | M23 DS grep | M8 benchmark | M17 SSOT | Rule-of-3 | M10 下游 | Issue cover | 結論 |
@@ -126,17 +126,17 @@ description: Auto-invoke when listing options / 建議 / 候選方案. Forces in
 | ... | ... | ... |
 ```
 
-**所有 fail 過 4-Q 的 option 必明示 reject + 原因**,不只 list 不過的。User 看見 reject 過程才能信 propose 過原則。
+**所有 fail 過 7-Q 的 option 必明示 reject + 原因**,不只 list 不過的。User 看見 reject 過程才能信 propose 過原則。
 
 ---
 
 ## Edge cases
 
 ### 緊急 / surgical bug fix
-不需走全 4 題(沒 option list,直接修)。但 commit message 仍應簡述「修法已知 root cause + 不取巧」(對齊 mindset #1)。
+不需走全 7 題(沒 option list,直接修)。但 commit message 仍應簡述「修法已知 root cause + 不取巧」(對齊 mindset #1)。
 
 ### Option 內含 sub-option(nested)
-每層各自跑 4 題。Skill 不限深度但實作上 ≥ 3 層 nested 已是設計問題,user 該停下重整。
+每層各自跑 7 題。Skill 不限深度但實作上 ≥ 3 層 nested 已是設計問題,user 該停下重整。
 
 ### User 已明示要 X(非 propose)
 不跑 skill。直接執行。
@@ -147,19 +147,19 @@ description: Auto-invoke when listing options / 建議 / 候選方案. Forces in
 
 User 已就「為什麼會給錯誤建議」糾正 ≥ 3 次:
 - session 初:G6/G7/G8 推力,我自己沒 dogfood test → 第 3 次問才補
-- 中:c hook + d M18-inner-area propose,**user sign-off 前剛好我自己覺察跑 4-Q 才撤回**
+- 中:c hook + d M18-inner-area propose,**user sign-off 前剛好我自己覺察跑 7-Q 才撤回**
 - 末:user 直接質問「為什麼會給錯誤建議?如果我答應了會直接執行嗎?」(本 skill 的觸發)
 
-**Infra G6/G7/G8 是 post-edit / session-start 防線,沒 propose-time gate**。Claude Code event model 沒 OnAssistantMessage hook,**只能靠 model-runtime 紀律 + skill self-invoke**。本 skill 就是 mechanical 補位 — invoke 時讀本檔,4-Q 表格自然寫進回覆。
+**Infra G6/G7/G8 是 post-edit / session-start 防線,沒 propose-time gate**。Claude Code event model 沒 OnAssistantMessage hook,**只能靠 model-runtime 紀律 + skill self-invoke**。本 skill 就是 mechanical 補位 — invoke 時讀本檔,7-Q 表格自然寫進回覆。
 
 ---
 
 ## Self-improvement capture
 
 每次 invoke 完,session 結束前自問:
-- (a) 是否每個 option 真跑了 4-Q 還是糊弄填表?
+- (a) 是否每個 option 真跑了 7-Q 還是糊弄填表?
 - (b) 是否有 reject option 曾被 list?(reject 不該被列出)
-- (c) 是否 user 仍質疑 propose 品質?(若是 → 4-Q 沒抓到的 gap → 加 Q5)
+- (c) 是否 user 仍質疑 propose 品質?(若是 → 7-Q 沒抓到的 gap → 加 Q5)
 
 回填到本 SKILL.md 或 CLAUDE.md M18(若需 escalate)。
 
@@ -170,8 +170,8 @@ User 已就「為什麼會給錯誤建議」糾正 ≥ 3 次:
 | Skill | scope |
 |---|---|
 | `pre_write_subsumption_check.sh`(hook)| Edit/Write 已發生時 |
-| `post_edit_canonical_interrogate.sh`(hook)| 寫完 canonical 後 3 題 |
-| `check_governance_compliance.sh`(hook)| 寫新 hook 7 題 |
-| **本 skill** `/propose-options` | **propose-time(寫進 user 回覆前)4 題** |
+| `post_edit_canonical_interrogate.sh`(retired/未實作 — mindset enforcement)| 寫完 canonical 後 3 題 |
+| `check_governance_compliance.sh`(retired/未實作 — 靠 `check_propose_pre_grep_verify.sh` + 加 hook 前 3 題)| 寫新 hook 7 題 |
+| **本 skill** `/propose-options` | **propose-time(寫進 user 回覆前)7 題** |
 
 4 個正交 — propose 前 / write 前 / write 中 / write 後 全 cover。

package/ds-canonical/skills/prototype/SKILL.md

@@ -141,7 +141,7 @@ Narrative 必含:
 
 **Input**: shortlist(2-3 items)+ Phase 3.0 產出的 Object Map
 
-**Phase 3.0a — SSOT 5-step pre-check**:寫任何 candidate code 前必過 CLAUDE.md「SSOT 消費 canonical」+ memory `feedback_proactive_5layer_pipeline.md`「5-step pre-check」(SSOT 在 memory + CLAUDE.md,本 skill 不重複)。`check_story_anatomy.sh` PreToolUse 是最後安全網,但 5-step 是事前 discipline。
+**Phase 3.0a — SSOT 5-step pre-check**:寫任何 candidate code 前必過 CLAUDE.md「SSOT 消費 canonical」+ memory `feedback_proactive_5layer_pipeline.md`「5-step pre-check」(SSOT 在 memory + CLAUDE.md,本 skill 不重複)。`check_story_invariants.sh` R1 anatomy(原 check_story_anatomy.sh folded 折入)PreToolUse 是最後安全網,但 5-step 是事前 discipline。
 
 **Process**: 每個 candidate 建一個 exploration story,**各 candidate 共享 Object Map 但差異在 UI shape + CTAs 順序**。see `references/proposal-template.md` for structure。
 
@@ -209,7 +209,7 @@ User / stakeholder 決定採用某 candidate 後:
 - `(c)` 混搭 A+B 新 hybrid(新 exploration)
 - `(d)` 全部不採用(保留 explorations/ 作紀錄,也是有價值的 ruled-out)
 
-**Graduation 流程**:若升級到正式,在 `explorations/_archive/` 備份 exploration(CLAUDE.md line 633:「不再使用但需保留的內容移至 _archive/」),正式 code 進 design-system/。
+**Graduation 流程**:若升級到正式,在 `explorations/_archive/` 備份 exploration(per CLAUDE.md `# 元件完成 + Exploration`:比稿定案升級 patterns/ 或 components/,舊比稿保留作紀錄),正式 code 進 design-system/。
 
 ### Phase 5 — Cleanup
 

package/ds-canonical/skills/prototype/references/audit-checks.md

@@ -22,7 +22,7 @@
 4. Chain `/ux-audit`(D4)scope 到 exploration
 5. Chain `/visual-audit`(D5 Layer B AI judgement)讀 `snapshots/*.png`
 6. **D6 真 scan**:chain `.claude/skills/design-system-audit/references/principle-audit-protocol.md` 對 exploration code 跑 4 子維;依判斷公式 auto / STOP
-7. **Self-improvement capture**(強制 Phase F step,見 CLAUDE.md `# 資訊治理 canonical`)
+7. **Self-improvement capture**(強制 Phase F step,見 CLAUDE.md `# 治理 canonical`)
 
 ## Gate 規則(嚴格)
 

package/ds-canonical/skills/prototype/references/evaluation-matrix.md

@@ -38,7 +38,7 @@ Phase 2 將 Phase 1 scan 結果變成可決策的評分表。
 **扣分場景**:
 - 候選需要覆蓋 `--chart-*` token 家族 → DS 一致性扣
 - 需要 hack Popover / Dialog 基底 → DS 一致性扣
-- 違反 hook check_token_hygiene.sh 4 條守則 → 直接 1(這是 bug,不是 DS 選擇)
+- 違反 token 防線 lib/_token_hygiene.sh 5 條守則 → 直接 1(這是 bug,不是 DS 選擇)
 
 ### 業務 fit(1-5,5 最高)
 

package/ds-canonical/skills/prototype/references/proposal-template.md

@@ -217,7 +217,7 @@ Phase 3 建 exploration 時:
 1. **優先用既有元件** `packages/design-system/src/components/`,不自創
 2. **Layout primitives 消費**(per CLAUDE.md 清單):Empty / item-layout / overlay-surface / ScrollArea / AspectRatio
 3. **Token 紀律**:只用 semantic token,不硬寫 hex / rgb / shadow-sm
-4. **hook check_token_hygiene 4 項**:shadcn alias / v4 shorthand / hardcoded shadow / native overflow — 4 項全過
+4. **token 防線 lib/_token_hygiene.sh 5-check**:shadcn alias / v4 shorthand / hardcoded shadow / primitive-color-as-utility / native overflow — 5 項全過
 5. **新元件需求**:**notes.md 明文標示**,不偷偷 add 到 Components/(Checkpoint 3 專屬)
 
 ---

package/ds-canonical/skills/scan-similar-bugs/SKILL.md

@@ -13,7 +13,7 @@ description: Auto-invoke after fix commits — extracts root-cause anti-pattern,
 - 對齊 IDE「find similar / find references」+ Chrome DevTools「find usages」+ GitHub Copilot「related code」3+ 家世界級 idiom
 
 **對位其他 skill**:
-- `/design-system-audit` 是**定期 batch** 7 維 audit
+- `/design-system-audit` 是**定期 batch** full-dim audit
 - `/visual-audit` 是**單次視覺對齊** check
 - 本 skill 是 **batch-end-only root-pattern scan**(2026-05-12 codex 抓 infra conflict 重構:per-fix → batch-end,對齊 `/bug-fix-rhythm` Phase 2-3 batch fix + single end-verify canonical;M32 split 後 batch-end home 移至 bug-fix-rhythm skill)
 
@@ -36,7 +36,7 @@ description: Auto-invoke after fix commits — extracts root-cause anti-pattern,
 
 ## Non-goals
 
-- 不擴展 scope 到「audit 7 維品質」(那是 `/design-system-audit`)
+- 不擴展 scope 到「audit full-dim品質」(那是 `/design-system-audit`)
 - 不做視覺 regression baseline diff(那是 `/visual-audit`)
 - 不改 canonical(找到 pattern 後修是 surgical fix,動 canonical 走 audit / Checkpoint)
 
@@ -163,17 +163,17 @@ N 個 candidate 的修法 scope。**禁止 auto-fix 超過 5 檔不 ask user**
 
 | Tool | scope | 跟本 skill 關係 |
 |---|---|---|
-| `/design-system-audit` | 7 維 batch audit | 本 skill 抓不到的 architectural pattern audit 補位 |
+| `/design-system-audit` | full-dim batch audit | 本 skill 抓不到的 architectural pattern audit 補位 |
 | `/visual-audit` | 單次視覺對齊 | Phase 3 verify 用 |
 | `/scan-similar-bugs`(本) | **immediate-after-fix grep + verify** | M10 mechanical 落地 |
 | `/knowledge-prune` | 季度 governance prune | 不重複 |
-| `check_l3_primitive_import.sh`(hook) | L3 import 違規 | 即時 detect,本 skill 是 batch retro scan |
+| `check_canonical_propagation.sh` E.2(hook;原 check_l3_primitive_import.sh folded 折入,P0 BLOCK) | L3 primitive import 違規 | 即時 detect,本 skill 是 batch retro scan |
 | `pre_write_subsumption_check.sh`(hook)| 新 file / M-row | 不重複 |
 
 **3 層 防線**:
 - Hook(pre/post tool):**寫的瞬間** detect
 - 本 skill(fix-time):**修完瞬間** scan DS-wide
-- `/design-system-audit`(periodic):**季度** 7 維 sweep
+- `/design-system-audit`(periodic):**季度** full-dim sweep
 
 ---
 

package/ds-canonical/skills/story-auto-compile-migrate/SKILL.md

@@ -5,7 +5,7 @@ description: Batch-migrate design system components to Story Auto-Compile Phase
 
 # Story Auto-Compile Migrate — 批次將元件移到 Phase 1+2 結構
 
-**目的**:把 44+ 元件從 hand-written stories 遷到 auto-compile-able 結構(tsx `componentMeta` export + spec YAML frontmatter)。分「mechanical auto」+「judgment checkpoint」兩層。
+**目的**:把全部元件從 hand-written stories 遷到 auto-compile-able 結構(tsx `componentMeta` export + spec YAML frontmatter)。分「mechanical auto」+「judgment checkpoint」兩層。元件總數 Phase 0 動態計(`ls -d packages/design-system/src/components/*/ | wc -l`,當前 62),禁 hardcode。
 
 **不含**:不改元件實作(cva / tsx logic 不動);不產 stories(compile-stories 負責)。只加 metadata。
 
@@ -121,7 +121,7 @@ Commit 每批 5-10 元件一個(不一次全推,好 review)。
 ## Self-improvement capture
 - 新發現 cva patterns: {特殊邏輯整理到 planning/story-auto-compile.md 供未來參考}
 - Mechanical migration 失敗 case: {列出 + 手動 workaround 紀錄}
-- Migration 覆蓋率:{N migrated / 44 total}
+- Migration 覆蓋率:{N migrated / total}(total = Phase 0 動態計 `ls -d packages/design-system/src/components/*/ | wc -l`)
 ```
 
 ---

package/ds-canonical/skills/story-writing/SKILL.md

@@ -53,7 +53,7 @@ Purpose: Storybook 是公開文件,範例 = 設計系統品質。本 skill 把
    - 真實業務情境 → 1 場景 1 故事
 4. **present mapping** 給 user sign-off(若走 skill);user 拍板才寫;反 pattern 在 step 3 即可避免
 
-Hook `check_story_slot_split.sh` write-time block 同源反 pattern。Audit `/design-system-audit` Dim 28 後驗。
+Hook `check_story_invariants.sh` R2 slot_split write-time block 同源反 pattern。Audit `/design-system-audit` Dim 28 後驗。
 
 ### Phase 1 — 定位(決定寫哪層 story)
 
@@ -82,7 +82,7 @@ Hook `check_story_slot_split.sh` write-time block 同源反 pattern。Audit `/de
 
 **參考 `references/anatomy-standard.md`**——每個元件 anatomy 必備 **6 件套**(`export const Overview / Inspector / ColorMatrix / SizeMatrix / StateBehavior / Accessibility`,一字不差;Accessibility 第 6 章 2026-04-24+ 對齊 Material / Polaris / Atlassian) + Inspect 面板規格 + token-first 原則 + 值溯源完整性。
 
-**偏離 canonical 規則**(CLAUDE.md 「Consistency Audit 原則」):
+**偏離 canonical 規則**(CLAUDE.md `# 稽核 canonical`「Consistency 類稽核必 Phase 0 全掃再判」;偏離需 rationale 由 design-system-audit Dim 13 enforce):
 - 追加第 7+ 個元件特有 story → OK,免 rationale
 - 取代 6-canonical 中某個 → **必須在元件 spec.md 寫 rationale**
 - 同概念改名(如 `VisualTokens` 取代 `ColorMatrix`) → **禁止**
@@ -119,4 +119,4 @@ Checkpoint: 寫完後必驗:
 
 - `.claude/rules/story-rules.md`:三層定位 + title 命名(high-level signal)
 - CLAUDE.md `# 失敗記憶索引` → 三方漂移:SegmentedControl cva defaultVariants bug
-- `.claude/hooks/check_sync_update.sh`:Edit 後自動提醒三方連動
+- M3 mindset #3「改一處看三處」+ `.claude/hooks/pre_edit_spec_check.sh`:Edit 前讀 spec、三方連動靠 mindset(`check_sync_update.sh` retired/未實作)

package/ds-canonical/skills/story-writing/references/anatomy-standard.md

@@ -58,7 +58,7 @@ export const Overview = {
 
 **嚴格警告**:曾經被誤用「applicable-where-meaningful」放行大量元件跳 Inspector,造成 anatomy 紙本文件不如世界級。**2026-04-21 audit 重修:policy 改回「6-canonical 預設全建(含 Accessibility),N/A 要硬 rationale」**。N/A 不是省工通行證。
 
-### 允許的偏離(CLAUDE.md「Consistency Audit 原則」公式)
+### 允許的偏離(CLAUDE.md `# 稽核 canonical`「Consistency 類稽核」公式;design-system-audit Dim 13 enforce)
 
 #### `@anatomy-rationale:` 檔頭註解(scope-N/A 的 canonical escape)
 
@@ -76,7 +76,7 @@ import type { Meta, StoryObj } from '@storybook/react'
 **何時不用**:section 只是還沒填完 — 補完內容,不要拿 escape 規避。
 **世界級對照**:對齊 ESLint `eslint-disable-next-line {rule}` 的 per-line allowlist idiom — 每個豁免必有具名 rule + 一行 rationale,不允許整檔默默繞過。
 
-`check_story_anatomy.sh` 識別 `@anatomy-rationale:` block:列出的 section 視為 legitimately N/A;未列出的 missing section 仍 violation。
+`check_story_invariants.sh` R1 anatomy 識別 `@anatomy-rationale:` block:列出的 section 視為 legitimately N/A;未列出的 missing section 仍 violation。
 
 #### 其他允許的偏離
 

package/ds-canonical/skills/story-writing/references/category-templates.md

@@ -100,7 +100,7 @@ v1 7 categories(A 視覺 variant / B field control / C selection / D structural
 
 - `.claude/rules/story-rules.md`「拆分原則」— canonical 上游 one-liner
 - `/story-writing` SKILL.md Phase 0 — write-time mapping
-- Hook `check_story_category.sh` — pre-write enforcement(攔不符 trait core)
+- Hook `check_story_invariants.sh` R3 category — pre-write enforcement(攔不符 trait core)
 - `/design-system-audit` Dim 29 — periodic verify
 - `/new-component` Phase 5 — 新元件 trait-based scaffold
 - `scripts/compile-stories.mjs` — runtime trait → required stories check
@@ -168,7 +168,7 @@ v1 7 categories(A 視覺 variant / B field control / C selection / D structural
 
 ## 強制機制
 
-- **Hook** `check_principles_canonical.sh`:PreToolUse 攔不符 ≥ 2 universal core
+- **Hook** `check_canonical_propagation.sh` E.1 principles:PreToolUse 攔不符 ≥ 2 universal core
 - **Audit Dim 30**:periodic verify
 - **`/new-component` Phase 5.3**:scaffold 4 universal stories template