zugzbot 1.0.21 → 1.0.23

package/.opencode/oh-my-design/skills/omd-remember/SKILL.md

@@ -1,122 +0,0 @@
----
-name: omd:remember
-description: "사용자의 디자인 선호·교정을 .omd/preferences.md에 기록. '이거 기억해줘', '앞으로는 이렇게', 'remember this', 'going forward never X', 「覚えておいて」, 「記住這個」류의 발화 또는 omd:apply가 교정을 감지했을 때 트리거. 기록된 내용은 omd:learn으로 DESIGN.md에 정식 반영."
----
-
-# omd:remember — Preference Logger
-
-사용자의 디자인 선호/교정을 `.omd/preferences.md`에 append-only로 기록한다. 나중에 `omd:learn`이 배치로 DESIGN.md에 반영. **CLI 호출 없음** — Read/Edit/Write 툴로 직접 처리.
-
-## 트리거 발화 패턴
-
-- "기억해 둬", "앞으로는 ~로 해"
-- "우리는 ~한다 / ~하지 않는다"
-- "remember that ...", "going forward ..."
-- "rule of thumb: ..."
-- 사용자가 당신의 디자인 선택을 명시적으로 교정
-
-## 파일 포맷 (`.omd/preferences.md`)
-
-frontmatter + 엔트리 시퀀스. 엔트리 하나당 `## <heading>` + `omd-meta` 코드블록 + body.
-
-```
----
-schema: omd.preferences/v1
-design_md_hash_at_creation: <hash 또는 빈 문자열>
----
-
-# Preference Log
-
-## 2026-04-30T17:48:00.000Z — ctas-never-uppercase
-
-​```omd-meta
-id: pref_lqxk2_a3f9c1d4
-timestamp: 2026-04-30T17:48:00.000Z
-scope: components.button
-signal: user-statement
-confidence: explicit
-status: pending
-source_agent: claude-code
-source_context: "src/components/Button.tsx"
-​```
-
-CTAs are never uppercase
-```
-
-## 실행 절차
-
-### Step 1 — note 정규화
-사용자 발화를 한 문장 영문으로 요약 (예: "앞으로 CTA 대문자 쓰지마" → `CTAs are never uppercase`).
-
-### Step 2 — scope 추론
-note 내용에서 다음 매핑 우선순위 사용:
-
-| 매칭 키워드 (정규식, case-i) | scope |
-|---|---|
-| `\b(buttons?\|ctas?\|btns?)\b` | `components.button` |
-| `\b(cards?)\b` | `components.card` |
-| `\b(dialogs?\|modals?)\b` | `components.dialog` |
-| `\b(inputs?\|fields?\|forms?)\b` | `components.input` |
-| `\b(nav\|navigation\|headers?\|menus?)\b` | `components.navigation` |
-| `\b(badges?\|chips?\|pills?\|tags?)\b` | `components.badge` |
-| `\b(tables?\|rows?\|cells?)\b` | `components.table` |
-| `\b(dropdowns?\|selects?\|comboboxes?)\b` | `components.dropdown` |
-| `\b(toasts?\|notifications?\|snackbars?)\b` | `components.toast` |
-| `\b(tabs?)\b` | `components.tabs` |
-| `\b(colors?\|palette\|hex\|hue\|saturation\|shades?\|tints?\|gradients?)\b` | `color` |
-| `\b(font\|typography\|typeface\|weight\|leading\|tracking\|letter-?spacing)\b` | `typography` |
-| `\b(spacing\|gap\|padding\|margin\|grid)\b` | `spacing` |
-| `\b(voice\|tone\|copy\|microcopy\|wording\|language)\b` | `voice` |
-| `\b(motion\|animation\|transition\|easing\|duration)\b` | `motion` |
-| `\b(layout\|structure\|hierarchy)\b` | `layout` |
-| `\b(theme\|aesthetic\|vibe\|mood\|look\|feel)\b` | `visualTheme` |
-| (어느 것도 매칭 X) | `visualTheme` |
-
-사용자가 명시적으로 scope를 지정했으면 그대로 사용.
-
-### Step 3 — id 생성
-형식: `pref_<base36 timestamp>_<8 hex chars>`. Bash로 한 줄:
-```bash
-node -e "console.log('pref_' + Date.now().toString(36) + '_' + require('crypto').randomBytes(4).toString('hex'))"
-```
-
-### Step 4 — slug + heading
-```bash
-node -e "console.log(process.argv[1].toLowerCase().replace(/[^a-z0-9]+/g,'-').replace(/^-+|-+$/g,'').slice(0,40) || 'entry')" "<note>"
-```
-heading: `<ISO timestamp> — <slug>`
-
-### Step 5 — 파일 read/append
-1. `Read .omd/preferences.md` — 없으면 frontmatter+header부터 만든다:
-   ```
-   ---
-   schema: omd.preferences/v1
-   design_md_hash_at_creation:
-   ---
-
-   # Preference Log
-
-   ```
-2. 새 엔트리 블록을 **파일 끝에 append** (Edit 툴, old_string은 마지막 라인, new_string은 마지막 라인 + 빈 줄 + 새 엔트리). 또는 Write로 전체 재작성.
-3. 메타 필드:
-   - `id`, `timestamp`, `scope` (필수)
-   - `signal: user-statement` (디폴트, 사용자가 직접 발화한 경우) 또는 `user-correction` (사용자가 당신의 선택을 교정한 경우)
-   - `confidence: explicit` (디폴트, 사용자가 명시적으로 말한 경우) 또는 `inferred` (당신이 사용자 행동에서 추론한 경우)
-   - `status: pending` (모든 새 엔트리)
-   - `source_agent`: 환경에서 추론 (`claude-code` / `codex` / `opencode` / `cursor`)
-   - `source_context`: 관련 파일 경로 또는 PR번호 (있으면 JSON.stringify로 quote)
-
-### Step 6 — 응답
-간결한 한 줄: `Logged ${id} to .omd/preferences.md (scope: ${scope})`
-
-## omd:apply 스킬과의 관계
-
-- **자동 감지**: 일반 UI 작업 중 교정 발생 시 `omd:apply`가 이 스킬 트리거
-- **명시적 호출**: 디자인 원칙 선언만 할 때 직접 트리거
-
-## 금지
-
-- `.omd/preferences.md` 파일을 frontmatter 외 직접 손대지 말 것 (id 충돌 방지) — 항상 위 절차로
-- 같은 세션 내 동일 내용 중복 기록 금지
-- 사용자에게 "기록할까요?" 묻지 말 것 — 감지 즉시 기록 + 간결 알림
-- frontmatter의 `design_md_hash_at_creation`은 첫 생성 시에만 채움 (이후 절대 수정 X)

package/.opencode/oh-my-design/skills/omd-sync/SKILL.md

@@ -1,162 +0,0 @@
----
-name: omd:sync
-description: "DESIGN.md 변경분을 CLAUDE.md / AGENTS.md / .cursor/rules/omd-design.mdc shim 3종에 전파. 'shim 갱신', 'drift 확인', 'ship', 'publish', 「shimを更新」, 「同步 CLAUDE.md」류의 요청에 트리거. DESIGN.md가 수정됐는데 shim이 오래됐을 때 자동 감지해 제안하기도 함."
----
-
-# omd:sync — Shim Maintenance
-
-DESIGN.md가 모든 주요 AI 코딩 에이전트(Claude Code, Codex, OpenCode, Cursor)에게 보이도록 shim 파일 3종을 관리한다. **CLI 호출 없음** — Read/Write/Edit 툴로 직접 처리.
-
-## 관리 대상 (3 파일)
-
-| ID | 경로 | 모드 |
-|---|---|---|
-| `claude` | `CLAUDE.md` | block (managed marker만) |
-| `agents` | `AGENTS.md` | block (managed marker만) |
-| `cursor` | `.cursor/rules/omd-design.mdc` | whole (전체 파일이 omd 전용) |
-
-block 모드는 `<!-- omd:start v=1 hash=<sha256:12> -->` ~ `<!-- omd:end -->` 마커 안만 관리, 나머지 사용자 콘텐츠 보존. whole 모드는 frontmatter 포함 전체 파일이 관리 단위.
-
-## 템플릿 (정확히 이 본문 — 절대 paraphrase 금지)
-
-### CLAUDE.md body
-
-```markdown
-# Design System (oh-my-design)
-
-The authoritative brand & UI spec is **@./DESIGN.md**.
-Read before any UI/styling/microcopy/motion work.
-
-Preference log (pending corrections): @./.omd/preferences.md
-
-Precedence: DESIGN.md > preferences.md > your defaults.
-```
-
-### AGENTS.md body
-
-```markdown
-## Design System (oh-my-design)
-
-**Before any UI, styling, copy, or motion change, open and read `./DESIGN.md` in full.** It is the authoritative brand/design spec. Treat its tokens, voice, and component rules as binding unless the user overrides in chat.
-
-If present, read `./.omd/preferences.md` — pending corrections not yet folded into DESIGN.md. Apply them; flag conflicts.
-```
-
-### .cursor/rules/omd-design.mdc (whole, frontmatter 포함)
-
-```mdc
----
-description: Authoritative brand & UI design system. Read DESIGN.md before UI work.
-globs:
-  - "**/*.tsx"
-  - "**/*.jsx"
-  - "**/*.vue"
-  - "**/*.svelte"
-  - "**/*.css"
-  - "**/*.scss"
-  - "**/tailwind.config.*"
-  - "**/components/**"
-  - "**/app/**/page.*"
-alwaysApply: false
----
-
-<!-- omd:start v=1 hash=<HASH> -->
-The authoritative design spec lives at `@DESIGN.md` (repo root). Open and read before generating/modifying UI.
-
-Pending preference corrections: `@.omd/preferences.md`.
-
-Precedence: DESIGN.md > preferences.md > framework defaults.
-<!-- omd:end -->
-```
-
-## 해시 계산
-
-`<HASH>` = sha256 of the body content (마커 제외, body 텍스트만), 12자 hex prefix:
-
-```bash
-node -e "console.log(require('crypto').createHash('sha256').update(process.argv[1]).digest('hex').slice(0,12))" "<body 텍스트>"
-```
-
-block 모드 마커 형식 정확히:
-```
-<!-- omd:start v=1 hash=ab12cd34ef56 -->
-<body>
-<!-- omd:end -->
-```
-
-## 실행 절차
-
-사용자가 어떤 모드를 요청하는지 분기:
-- **인터랙티브 (디폴트)** — drift 발견 시 사용자에게 묻기
-- **--force 의도** ("강제 덮어쓰기") — drift 무시하고 덮어씀
-- **--check 의도** ("상태만 검사") — 파일 상태만 출력, write 안 함
-
-각 shim별로:
-
-### Step 1 — Read existing
-파일 없으면 → status: `missing`, 새로 write 진행
-파일 있으면 → 내용 파싱
-
-### Step 2 — block 모드 파싱
-`<!-- omd:start v=N hash=H -->` 라인 찾기:
-- 없으면 → status: `missing` (block 부재, 사용자 content 외에 새로 추가 필요)
-- 있으면 → marker 사이의 본문 추출. 추출된 본문의 sha256:12를 계산해서 marker의 `hash=H`와 비교
-  - 불일치 → status: `drifted` (사용자가 수동 편집함)
-  - 일치 + 본문 == 템플릿 → status: `clean`
-  - 일치 + 본문 != 템플릿 → status: `out-of-date` (omd 템플릿이 갱신됨)
-
-### Step 3 — whole 모드 파싱
-existing 전체 content와 rendered 템플릿 비교:
-- 동일 → `clean`
-- 차이 → `drifted`
-
-### Step 4 — drift 처리
-- **인터랙티브**: drift된 shim별로 "${path}는 수동 편집됐어요. 덮어쓸까요? (yes/no/show diff)" 묻기
-- **--force**: drift 무시 덮어씀
-- **--check**: drift 있으면 exit 1 동등 — 사용자에게 "drift detected" 보고 후 종료
-
-### Step 5 — Write
-- block 모드: existing 안의 marker block만 새 hash + 새 body로 교체. 마커 외부 사용자 content는 보존
-- whole 모드: 파일 전체를 새 rendered content로 교체. 디렉토리 (`.cursor/rules/`) 없으면 mkdir
-
-### Step 6 — sync-lock 갱신
-`.omd/sync.lock.json` 기록 (없으면 만든다):
-```json
-{
-  "design_md_hash": "<DESIGN.md sha256:12>",
-  "targets": {
-    "CLAUDE.md": "<hash>",
-    "AGENTS.md": "<hash>",
-    ".cursor/rules/omd-design.mdc": "<hash>"
-  },
-  "updated_at": "<ISO timestamp>"
-}
-```
-
-DESIGN.md 해시:
-```bash
-[ -f DESIGN.md ] && node -e "console.log(require('crypto').createHash('sha256').update(require('fs').readFileSync('DESIGN.md')).digest('hex').slice(0,12))"
-```
-
-## 결과 보고
-
-```
-CLAUDE.md (block) — updated
-AGENTS.md (block) — unchanged
-.cursor/rules/omd-design.mdc — created
-DESIGN.md hash: ab12cd34ef56
-```
-
-## 언제 실행하나
-
-- DESIGN.md 변경 직후 (shim hash 갱신용)
-- 새 프로젝트 첫 도입 (3종 생성)
-- `.claude` / `.cursor` 디렉토리 추가 후
-- "drift 확인" 요청
-
-## 금지
-
-- 마커 안 본문에 임의 추가/축약 금지 — 위 템플릿 정확히 사용
-- block 모드 파일에서 마커 외부 사용자 content 절대 삭제 금지
-- `.omd/sync.lock.json` 무시 금지 — 항상 갱신
-- DESIGN.md가 없어도 shim은 만들 수 있음 (DESIGN.md 생성 후에 hash만 채움)

package/.opencode/oh-my-design/skills/omd-taste/SKILL.md

@@ -1,79 +0,0 @@
----
-name: omd:taste
-description: "시스템이 학습한 사용자의 디자인 취향을 한 뷰로 렌더. .omd/preferences.md + foldin-proposal.json + DESIGN.md를 읽어 반영됨/대기 중/보류됨/모르는 것 4그룹으로 보여준다. '/omd-taste', '내 취향 보여줘', '취향 현황', 'what are my preferences', 'show my taste', 「私の好みを見せて」, 「顯示我的偏好」류의 발화에 트리거. 기록은 omd:remember, DESIGN.md 반영은 omd:learn."
-user-invocable: true
----
-
-# omd:taste — Taste Dashboard
-
-시스템이 사용자에 대해 알고 있는 취향을 **한 뷰**로 렌더한다. 신뢰는 가시성에서 나온다 — 루프가 뭘 배웠고, 뭘 기다리고, 뭘 모르는지 보여주면 사용자가 루프에 더 먹인다. 기본 동작은 **읽기 전용** — 기록은 `omd:remember`, 반영은 `omd:learn`의 몫이고, 이 스킬은 보여주고 다음 행동만 안내한다. **CLI 호출 없음** — Read/Edit 툴로 직접 처리.
-
-## 입력 (모두 Read 툴)
-
-1. `.omd/preferences.md` — canonical 포맷 (`## <heading>` + ` ```omd-meta` 블록 + body — `omd:remember` 스킬의 포맷 정의 참조). **모든 status**의 엔트리를 파싱: `id` / `timestamp` / `scope` / `signal` / `confidence` / `status`
-2. `.omd/foldin-proposal.json` — 있으면 `status` (`proposed` / `applied` / `partial` / `snoozed`)와 `scopes[]` (scope, count, score, summary)
-3. `DESIGN.md` — § 라우팅 표시 + "모르는 것" 축 도출용
-
-## 빈 상태
-
-`.omd/preferences.md`가 없거나 파싱된 엔트리가 0개면 두 줄로 끝낸다:
-
-> 아직 학습된 취향이 없어요.
-> 작업 중 "앞으로는 ~로 해"라고 말하면 omd:remember가 기록하고, 같은 취향이 쌓이면 omd:learn이 DESIGN.md에 정식 반영해요.
-
-이때 `.omd/` 디렉토리나 파일을 **만들지 말 것** — 뷰 스킬이 상태를 생성하면 안 된다.
-
-## 렌더 — 4 그룹 한 뷰
-
-### ① 반영됨 (`status: applied`)
-
-scope별 한 줄: body 요약 + 반영된 DESIGN.md 섹션 + `applied_at` (있으면). 섹션은 omd:learn Phase 3의 scope→§ 라우팅으로 도출:
-
-| scope | DESIGN.md § |
-|---|---|
-| `components.*` | §8 (Components) 또는 §13 |
-| `color` | §2 (Color Palette) |
-| `typography` | §3 |
-| `spacing` | §4 |
-| `voice` | §10 (Voice & Tone) |
-| `motion` | §15 (Motion & Easing) |
-| `visualTheme` | §1 (Visual Theme) |
-
-DESIGN.md에 해당 섹션이 실제로 없으면 § 표기는 생략 (추측으로 적지 말 것).
-
-### ② 대기 중 (`status: pending`)
-
-scope별로 그룹화해 한 그룹당 한 줄:
-
-- **발생 횟수** — 해당 scope의 pending 엔트리 수
-- **confidence** — explicit / inferred 구성 (예: `explicit ×2, inferred ×1`)
-- **한 줄 요약** — 최신 엔트리 body의 첫 줄
-- **폴드 제안까지 남은 횟수** — 자동 fold-in 게이트(session-end hook)의 기본 임계는 **최근 7일 창 안에서 같은 scope 3회**. `max(0, 3 - 7일 내 발생 횟수)`로 계산해 "N회 더 쌓이면 제안돼요"로 표기. 이미 충족이면 "다음 세션 종료 시 제안 예정"
-
-### ③ 보류됨 (snoozed)
-
-`.omd/foldin-proposal.json`의 `status`가 `snoozed`면 그 `scopes[]`를 나열 — scope + summary + `snoozed_at`. "지금 반영하려면 omd:learn을 부르세요" 한 줄 덧붙임. proposal 파일이 없거나 snoozed가 아니면 이 그룹은 생략.
-
-### ④ 시스템이 모르는 것 (가볍게)
-
-DESIGN.md에는 정의돼 있지만 preference 엔트리(어느 status든)로 한 번도 확인된 적 없는 주요 축을 **1-2개만** 짚는다 (예: "motion은 DESIGN.md 기본값 그대로 — 아직 취향을 들은 적이 없어요"). 절대 전 축을 나열하지 말 것 — 가볍게 한두 줄.
-
-## 다음 행동 안내 (뷰 끝에 항상)
-
-```
-다음 중 하나로 이어갈 수 있어요:
-- "지금 반영"        → omd:learn — pending을 DESIGN.md에 fold
-- "잊어줘 <id|scope>" → 해당 엔트리 status를 rejected로 플립
-- "수정: <내용>"      → omd:remember로 재기록 (옛 엔트리는 superseded)
-```
-
-- **"지금 반영"** → `omd:learn` 트리거 (전체 또는 사용자가 지정한 scope만)
-- **"잊어줘"** → 해당 엔트리의 omd-meta 블록만 Edit 툴로 `status: rejected` + `rejected_reason: "user-forget"` 플립 (omd:learn의 single-entry 플립과 동일 절차). body는 건드리지 않는다
-- **"수정"** → body 직접 편집 금지 (영구 기록) — `omd:remember`로 새 엔트리 재기록 후 옛 엔트리를 `status: superseded` + `superseded_by: <새 id>`로 플립
-
-## 금지
-
-- "잊어줘"/"수정" 후속 요청의 status 플립 외에는 어떤 파일도 수정하지 말 것 — DESIGN.md 수정은 항상 omd:learn 경유
-- 엔트리 전체 dump 금지 — scope 그룹 요약으로
-- ④번 그룹을 채우려고 억지 축을 만들지 말 것 — 짚을 게 없으면 생략
-- preferences.md 포맷 해석은 canonical 규칙(omd:remember)만 따를 것 — 자체 변형 포맷 발명 금지

package/.opencode/oh-my-design/skills-lock.json

@@ -1,10 +0,0 @@
-{
-  "version": 1,
-  "skills": {
-    "google-analytics": {
-      "source": "davila7/claude-code-templates",
-      "sourceType": "github",
-      "computedHash": "c7a60543ca235c272d002f0dd6e1370c9cc37f4df604d9f9d75daefaa31ef89a"
-    }
-  }
-}

package/.opencode/oh-my-design/spec/components-schema.md

@@ -1,179 +0,0 @@
-# DESIGN.md §4 Component Stylings — Canonical Schema
-
-This is the canonical structure for `## 4. Component Stylings`. It is the source of truth that `extractComponentSpecs()` parses and `ReferencePreview > Components` renders. Existing refs may not yet conform; the migration plan rewrites §4 in batches of 5.
-
-## Rules
-
-1. `## 4. Component Stylings` opens the section. Subsections use `### {ComponentName}` headers.
-2. Each variant inside a subsection is introduced by a bolded line `**{VariantName}**` and is followed by a bulleted spec list (lines starting with `-`).
-3. Bullet lines use `Field: value` shape. Values may be backtick-wrapped (`` `#3182f6` ``) or plain.
-4. **One field per bullet — strict.** The parser matches `^- Field: value$` per line. **Never** join multiple fields with " / " or ", " on a single bullet — only `font` may use the established sub-syntax `<size> / <weight> / <family>`. Joining `Background: X / Text: Y / Border: Z` will silently drop all but one field and lead to the variant being invisible in the renderer (KRDS 2026-05 regression).
-5. A free-text `- Use: ...` line is the conventional place for the 1-line use case.
-6. Below the variant blocks, a paragraph of notes is permitted (e.g., padding patterns, accessibility notes). Anything that isn't a `**Variant**` heading or `- Field: value` bullet is treated as descriptive prose.
-7. **State variants** (Hover/Pressed/Focus/Disabled/Required/Error) go as separate bullets on the SAME variant block — do not create separate `**Variant**` blocks per state.
-8. **Size scales** (xsmall/small/medium/large/xlarge) collapse into ONE `**Variant**` block using the default size for the bullets; render the size scale as a markdown table or prose immediately after.
-
-## Subsection vocabulary
-
-| Header (case-insensitive)                       | Component type | Required? |
-| ----------------------------------------------- | -------------- | --------- |
-| `Buttons`                                       | button         | required  |
-| `Inputs` / `Inputs & Forms` / `Forms`           | input          | required  |
-| `Cards` / `Cards & Containers` / `Containers`   | card           | required  |
-| `Badges` / `Badges & Tags` / `Chips` / `Tags`   | badge          | required  |
-| `Tabs`                                          | tab            | optional  |
-| `Toggles` / `Switches`                          | toggle         | optional  |
-| `Toasts` / `Snackbar` / `Snackbars`             | toast          | optional  |
-| `Dialogs` / `Modals` / `Sheets` / `Bottom Sheet`| dialog         | optional  |
-| `List Items` / `List Item` / `Friend List Item` | listItem       | optional  |
-| `Avatars`                                       | avatar         | optional  |
-
-Other `### ...` headers under §4 (Navigation, Image Treatment, etc.) are preserved in source but not parsed into structured component specs.
-
-## Field vocabulary
-
-For variants under any subsection. All fields are optional; the parser will populate what it sees.
-
-| Field key (case-insensitive, alias-tolerant) | Aliases recognised                          |
-| -------------------------------------------- | ------------------------------------------- |
-| `bg`                                         | Background, Bg, Fill                        |
-| `fg`                                         | Text, Color, Foreground                     |
-| `border`                                     | Border, Outline, Stroke                     |
-| `radius`                                     | Radius, Border-radius, Border Radius        |
-| `padding`                                    | Padding                                     |
-| `font`                                       | Font, Typography, Type                      |
-| `hover`                                      | Hover                                       |
-| `focus`                                      | Focus                                       |
-| `active`                                     | Active, Pressed                             |
-| `disabled`                                   | Disabled                                    |
-| `shadow`                                     | Shadow                                      |
-| `use`                                        | Use, Usage, When                            |
-
-Any unrecognised `- Foo: bar` line is captured as `extras["Foo"] = "bar"`.
-
-## Variant naming
-
-`**Variant Name**` may be any short title. The parser preserves the exact name. It does NOT require the name to map to a fixed enum (Primary/Secondary/Outline/...). Brand-specific names are encouraged when they reflect real product usage (e.g., `**Send Money**`, `**Kakao Login (Compliance-Mandated)**`).
-
-## Required fields per component class
-
-The renderer can produce a meaningful "live instance" preview when the variant has at least:
-
-| Component | Minimum required fields                 |
-| --------- | --------------------------------------- |
-| button    | bg + fg + radius                        |
-| input     | bg + border + radius                    |
-| card      | bg + radius (padding strongly preferred)|
-| badge     | bg + fg + radius                        |
-| tab       | active fg + inactive fg                 |
-| toggle    | bg + thumb-color (via `extras.thumb`)   |
-| toast     | bg + fg + radius                        |
-| dialog    | bg + radius + shadow                    |
-| listItem  | text + meta-text colors + height        |
-| avatar    | radius / shape (circle vs rounded)      |
-
-Variants missing the minimum are still listed; they render with a "spec only" card (no live instance) so the data isn't lost.
-
-## Example (Toss)
-
-```markdown
-## 4. Component Stylings
-
-### Buttons
-
-**Primary**
-- Background: `#3182f6`
-- Text: `#ffffff`
-- Radius: 12px
-- Padding: 16px 20px
-- Font: 16px / 600 / Toss Product Sans
-- Pressed: dimmed overlay (opacity reduction)
-- Disabled: opacity 0.4
-- Use: Primary CTAs (송금하기, 확인)
-
-**Secondary (Weak)**
-- Background: `#e8f3ff`
-- Text: `#3182f6`
-- Radius: 12px
-- Padding: 14px 18px
-- Font: 16px / 600 / Toss Product Sans
-- Use: Less prominent CTAs
-
-### Inputs
-
-**Default**
-- Background: `#f2f4f6`
-- Border: 1px solid `#e5e8eb`
-- Radius: 8px
-- Padding: 14px 16px
-- Text: 16px / 400 / `#191f28`
-- Placeholder: `#b0b8c1`
-- Focus: 2px solid `#3182f6`
-- Use: Default text input
-
-### Cards
-
-**Standard**
-- Background: `#ffffff`
-- Radius: 12px
-- Padding: 20px
-- Shadow: `0px 2px 8px rgba(0,0,0,0.08)`
-- Use: Most surfaces (account, transaction, balance)
-
-### Badges
-
-**Default**
-- Background: `#e8f3ff`
-- Text: `#3182f6`
-- Radius: 8px
-- Padding: 4px 8px
-- Font: 12px / 500
-- Use: Small status pills, category tags
-```
-
-## Migration policy (existing 67 refs)
-
-Most refs (Toss/Apple/Spotify/Cursor/Stripe + many others) already use the variant-block shape. Migration consists of:
-
-1. Confirming every variant has the minimum required fields (most do).
-2. Adding missing required subsections (Buttons / Inputs / Cards / Badges) — usually pulled from real DS/research, not invented.
-3. Reformatting legacy free-prose subsections into the variant-block shape without rewording prose-only notes.
-
-Migration order is brand-distinctive products first (5 batches of 5 by influence) then dashboard-style refs (where the gap is small).
-
----
-
-## Structured component tokens (canonical machine source — 2026-06)
-
-The preview now prefers a **structured `tokens.components`** block in the
-frontmatter over prose §4 parsing (`componentsFromTokens()` in
-`extract-tokens.ts`). When present, it is the source of truth the renderer draws
-from; prose §4 remains for human reading and as a fallback for un-migrated refs.
-
-Why: prose §4 parsing drops components whose subsection heading doesn't classify
-to a render type (getdesign-style groups like "Actions"/"Overlays"), and only
-scans §4 (rich harvests written to §8 were invisible). Structured tokens carry
-an explicit per-component `type`, so neither problem occurs.
-
-### Format (flow style, one component per line)
-
-```yaml
-tokens:
-  components_harvested: true        # set once a harvest pass has run (rich OR honest cap)
-  components:
-    button-primary: { type: button, bg: "#1f883d", fg: "#ffffff", radius: "6px", height: "32px", padding: "0 16px", border: "1px solid #1f883d", font: "14px / 600", states: "hover #1a7f37 · disabled #94d3a2", use: "Primary constructive action" }
-    underline-tab:   { type: tab, active: "text #1f2328 + 2px bottom border #fd8c73", disabled: "#59636e label", use: "Repo tabs" }
-    data-table:      { type: card, bg: "#ffffff", border: "1px solid #d0d7de", radius: "6px", use: "Repo file list / issues table" }
-```
-
-### Fields
-
-- **`type`** (required) — the render type, EXACTLY one of: `button input card badge tab toggle toast dialog listItem avatar`. For components outside this set, pick the closest: table/tooltip/banner/list/empty-state → `card`; modal/sheet/overlay → `dialog`; segmented-control/nav → `tab`; chip/label/counter → `badge`; stepper/switch → `toggle`. Every component gets a type — nothing is dropped.
-- Optional, include only what the source gives: `bg` `fg` `border` `radius` `padding` `height` `font` (`"<size> / <weight>"`) `shadow` `hover` `focus` `active` `disabled` `states` `use`.
-- Tabs: put the active spec in `active` (e.g. `"text #1f2328 + 2px bottom border #fd8c73"`) so the renderer draws the underline indicator (it parses `"<N>px bottom border <hex>"`).
-
-### Rules
-
-- Component bg/fg hexes should reference colors already grounded in the prose — do not invent new hexes.
-- 6-digit `#rrggbb` only; space before every `{`; one component per line; valid YAML flow mappings.
-- `omd-component-harvest` emits this block. Flat-string `components:` values are legacy/summary and trigger the prose-§4 fallback.