zugzbot 1.0.21 → 1.0.22

package/.opencode/oh-my-design/.claude/skills/omd-batch-launch/SKILL.md

@@ -1,270 +0,0 @@
----
-name: omd:batch-launch
-description: "10개 brand 일괄 reference 추가 + 문서 카운트 sync + hyperframes 기반 promo MP4 생성. '10개씩 추천해줘', '한국 IT 10개 추가하고 영상까지', 'batch-launch', 'X 카테고리에서 10개 더' 류 트리거. 매 회 reference count +10, gitignored promo video 1편."
-argument-hint: "[category|theme] [--n 10] [--lang ko|en] [--orientation portrait|landscape]"
-user-invocable: true
----
-
-# omd:batch-launch
-
-omd 카탈로그에 **한 번에 10개**의 brand reference를 추가하고, 동시에 SNS(스레드/X/링크드인)에 그대로 올릴 수 있는 **30초+ 프로모 MP4**를 만드는 3-phase 파이프라인.
-
-**왜 스킬화 했나**: 사용자가 "10개씩" 요청을 반복할 예정이라 매번 (1) 후보 큐레이션 (2) reference build (3) 문서 카운트 갱신 (4) 영상 합성을 일관 포맷으로 돌려야 한다. 매 회 의사결정 흔들림 없이 같은 산출물 → 시리즈가 일관된 톤을 가지게 됨.
-
----
-
-## Phase 1 — Recommend (큐레이션)
-
-### 입력 파싱
-- `[category|theme]` 자유 텍스트. 예: "한국 IT 대기업", "AI 스타트업", "글로벌 핀테크", "디자인 스튜디오"
-- 미입력 시 사용자에게 카테고리/제약 물어보기
-
-### 후보 산출 규칙
-1. **중복 배제**: `ls web/references/` 결과를 먼저 읽고, 거기 있는 id는 후보에서 제외
-2. **DS 가시성 기준**: 다음 중 최소 1개 만족
-   - 공식 design system docs 페이지 존재 (예: `<brand>.design`, `<brand>/design-system`)
-   - 디자인팀 medium/brunch 시리즈 (≥2 글)
-   - `getdesign.md/<id>` 또는 `styles.refero.design` 에 entry 존재
-3. **도메인 다양성**: 같은 도메인(예: 핀테크)이 5개 초과하지 않도록
-4. **단순 reskinning 회피**: 게임사처럼 DS보다 IP UI가 지배적인 경우 제외 권장
-
-### 출력 포맷
-사용자에게 표로 제시 (id / 한글명 / DS 자료 근거 1줄):
-
-```
-| # | id           | 한글명     | DS 근거 |
-|---|--------------|------------|---------|
-| 1 | socar        | 쏘카       | SOCAR DS brunch 시리즈 |
-| ...
-```
-
-+ "포트폴리오 관점 균형" 단락(도메인/규모/카테고리 다양성)과 "대체 후보 5개"를 같이 제시. 사용자 컨펌 후 Phase 2로.
-
----
-
-## Phase 2 — Build (10개 일괄 reference 생성)
-
-각 brand에 대해 `omd:add-reference` CREATE 파이프라인을 그대로 적용. **단순 footer 박기 금지** — 모든 brand가 Apple-tier 풀 reconcile.
-
-### 실행 방식
-- **병렬 wave**: 5개씩 2 wave (Agent subagent로 위임 권장). 한 wave 안에서는 brand별로 독립 subagent를 spawn해 parallel WebFetch + sequential playwright.
-- **Wave 1 끝나면 sanity check** (`grep -c "^## 4\." web/references/<id>/DESIGN.md` 각각 1 이상) 후 Wave 2 진행.
-- 실패한 brand는 보고하고 다음 wave에서 단독 재시도. 2회 실패 시 사용자에게 escalate.
-
-### 각 brand build 체크리스트 (omd:add-reference CREATE 그대로)
-- [ ] Tier 1: 라이브 inspect (hero CTA / nav / footer / input / card) — playwright 필수
-- [ ] Tier 2: getdesign.md/<id> + refero (둘 다 시도)
-- [ ] **Tier 1.5 — 공식 DS surface 탐색** (Phase 3 등재에 직접 사용):
-  - `<brand>.design`, `design.<domain>`, `<domain>/brand`, `<domain>/brandcenter` HEAD
-  - GitHub: `gh search repos "<brand> design"`, `<org>.github.io/<brand>-ui` (Storybook 흔함)
-  - WebSearch: `"<brand>" design system site:<domain>`, `"<brand>" brunch design system`, `"<brand>" tech blog design`
-  - 발견 시 `curl -sIL` 200 확인 → `_promo.json` `design_system` 필드 기입
-  - 없으면 필드 omit
-- [ ] Tier 3: reconcile + §4 canonical schema
-- [ ] §10-15 philosophy (Voice/Narrative/Principles/Personas/States/Motion)
-- [ ] `_research.md` 작성
-- [ ] §4 footer `**Verified:** YYYY-MM-DD` + sources
-
-### 산출물
-- `web/references/<id>/DESIGN.md`
-- `web/references/<id>/.verification.md` (Proof block + conflict matrix + 리서치 노트 — `_research.md` 대체)
-- (선택) `web/references/<id>/_preview.png` — Phase 3에서 쓸 라이브 hero 캡쳐 1장. **Phase 2에서 미리 찍어두면 Phase 3 재방문 비용 절감.**
-
-### 빌드 실행 방식 (mandatory)
-brand당 서브에이전트 1개, 프롬프트 = `.claude/skills/omd-add-reference/batch-instructions.md` 경로 + brand 파라미터. 각 서브에이전트의 종료 조건은 `node web/scripts/verify-reference.mjs <id>` 전 게이트 PASS. 서브에이전트는 ref 디렉터리 2파일만 쓰고 SYNC/test/git을 건드리지 않는다 (omd:add-reference "Batch 서브에이전트 프로토콜" 참조).
-
----
-
-## Phase 2.5 — Audit (리서치 정합도 추적)
-
-**핵심**: 매 batch마다 `data/reference-audits/<YYYY-MM-DD>-<batch-slug>.md` 단일 파일 생성. 6개월 뒤에도 어떤 brand가 어떤 깊이로 추출됐는지, 어디를 보완해야 하는지 한 페이지로 확인 가능해야 한다.
-
-### 필수 섹션 (greppable)
-
-`data/reference-audits/2026-05-13-kr10.md` 가 reference template:
-
-1. `## How the N were researched` — 적용된 파이프라인 요약
-2. `## Systemic finding` — 이 batch에서 발견된 카테고리 수준 인사이트 (예: "Korean brands는 Tier 2 directories에서 empty")
-3. `## Per-brand audit` — 표: id / confidence / Tier 1 depth / Tier 2 / Known gaps / Follow-up
-4. `## Confidence distribution` — High / Medium / Low 분포 + aggregate publishability
-5. `## Known shared limitation` — process 차원의 한계 + 다음 batch process 개선안
-6. `## Promo highlight selection` — `_promo.json` highlight type 분포 (palette / voice / cta)
-7. `## Follow-up TODO` — 우선순위 정렬된 UPDATE 대상
-
-### Confidence 등급 기준 (3-tier)
-
-- **High** — ≥2 Tier 1 surfaces OR production CSS bundle 캡쳐; 미해결 hex 없음; ≥3 brand-owned 보조 source (blog/medium/brunch); §10-15 sourced
-- **Medium** — 1 Tier 1 surface; 일부 inferred values; brand-owned philosophy sources 있음
-- **Low** — Tier 1 partial blocked; 핵심 토큰 `(unverified live)` 또는 `(illustrative)` 표시; UPDATE pass 필요
-
-이 등급은 batch 보고서뿐 아니라 **`web/references/<id>/_research.md` 상단에도 명시**되어야 (`Confidence: High|Medium|Low`).
-
-### Audit 작성 절차
-
-Phase 2 끝난 직후, build subagent들의 return summary를 모아서 작성. 각 subagent가 return한 정보:
-- Tier 1 source count
-- Tier 2 found / empty
-- Conflicts unresolved
-- Known gaps
-
-→ 이걸 표로 합치고, 위 기준에 따라 confidence 등급 매김. Aggregate / TODO 작성.
-
-### Anti-patterns
-
-- ❌ 모든 brand를 "High"로 표시 (작성자 편의를 위한 인플레이션)
-- ❌ Follow-up TODO를 비워둠 (Medium/Low brand는 항상 TODO entry가 있어야 함)
-- ❌ Audit 없이 SYNC로 넘어감
-
----
-
-## Phase 3 — SYNC (registry-driven)
-
-Hand-maintained map drift was the recurring 10-brand batch-bug. Eliminated: every brand attribute lives in the **canonical frontmatter** of `references/<id>/DESIGN.md`, projected into `web/src/data/registry.generated.ts`, which every UI surface reads.
-
-### 1. Canonical frontmatter per new id (the ONLY data edit)
-Schema lives at the top of `web/src/data/registry.generated.ts`. Required: `id`, `name`, `country`, `category`, `homepage`, `primary_color`, `logo.{type,slug}`, `verified`. Optional: `display_name_kr`, `ds`.
-
-### 2. Regenerate + propagate + gate (single command)
-```bash
-node web/scripts/sync-catalog.mjs        # --dry-run으로 미리보기
-```
-한 명령이 build-registry → fingerprints ×3 (append/count/mirror) → design-md mirror → README ×4 / llms.txt / SEO layout 카운트 문자열 → llms.txt Examples append → `npm test` 까지 수행. Husky pre-commit이 같은 catalog-integrity 게이트를 재실행한다.
-
-### 3. 여전히 수동인 것
-- CHANGELOG.md 엔트리 + `package.json` patch bump
-- 스크립트가 생성한 fingerprint `tone_keywords` 휴리스틱 검토 (어색하면 다듬기)
-- `skills/*/SKILL.md` / `agents/*.md` stay count-agnostic — do not hardcode numbers there.
-
-### 4. Sub-agent self-verification (mandatory at end of every batch slot)
-```bash
-node web/scripts/verify-reference.mjs <id>    # 슬롯별, registry 빌드 불필요
-```
-Report the summary line per id. batch 전체 완료 선언은 sync-catalog의 `npm test` 그린 이후에만.
-
----
-
-## Phase 4 — Promo (hyperframes MP4)
-
-### 사용 도구
-`npx hyperframes` (v0.6+). 처음 호출이면 자동 설치.
-
-### 디렉토리
-`.promo/<YYYY-MM-DD>-<batch-slug>/` (gitignored). 결과 MP4는 같은 폴더에.
-- 예: `.promo/2026-05-13-kr10/` → `.promo/2026-05-13-kr10/kr10.mp4`
-
-### Composition 구조 (30s+, 1080×1920 portrait 기본)
-
-| Segment | duration | 내용 |
-|---|---|---|
-| Intro (0–3s) | 3s | "오늘의 batch — <category>" + omd 로고 페이드인 |
-| Brand cards (3–33s) | 3s × 10 = 30s | **좌**: brand 로고(SVG 우선) + 한글명 큼지막 / **우**: 우리가 추출한 "흥미 요소" 1개 |
-| Outro (33–37s) | 4s | "지금 바로 **oh-my-design**에서 확인해보세요" + URL/QR |
-
-**총 길이 37s** (사용자 요구 30s 이상 만족). orientation flag로 landscape(1920×1080) 전환 가능.
-
-### "흥미 요소" 추출 규칙 (우측 우리 preview)
-각 brand DESIGN.md에서 다음 우선순위로 1개 골라 HTML로 합성:
-1. **시그니처 컬러 팔레트**: §3 컬러 토큰 중 brand-primary + accent — 색칩 카드
-2. **CTA 컴포넌트**: §4 의 primary button (배경/radius/padding/font) 그대로 렌더
-3. **Voice sample**: §10 voice sample 1개 (한글 강조)
-
-→ 어떤 걸 고를지는 build subagent가 brand별로 **"가장 시각적으로 강력한 1개"**를 `_promo.json` 에 기록하게 함. 이후 Phase 4가 그걸 그대로 합성.
-
-### `_promo.json` 스키마 (Phase 2에서 작성)
-```json
-{
-  "id": "socar",
-  "korean": "쏘카",
-  "logo_url": "https://socar.kr/.../logo.svg",
-  "highlight": {
-    "type": "palette|cta|voice",
-    "tokens": { "primary": "#00A862", "accent": "#222" },
-    "label": "Signature Green"
-  },
-  "design_system": {
-    "name": "SOCAR Design",
-    "url": "https://design.socar.kr/",
-    "type": "system",
-    "description": "SOCAR's design system hub — Space Frame, SOCAR Blue, mobility-flow components.",
-    "live_verified": "2026-05-13"
-  }
-}
-```
-
-**`design_system` 필드 규칙 (build 시점에 결정)**:
-- 공식 DS docs / Storybook / Carbon급 시스템 → `type: "system"`
-- 브랜드 가이드라인 페이지 / DS-narrative 블로그 / GitHub org → `type: "brand"`
-- 공개 DS surface 전혀 없음 → 필드 자체를 **omit** (UI에서 자연스럽게 버튼 숨김)
-- URL은 build subagent가 **반드시 `curl -sIL`로 200 확인 후 기입** (404/403 박지 않기)
-- description은 1-2문장. brand의 시그니처 토큰/철학을 1개 언급 (보일러플레이트 금지)
-- 이렇게 build 시점에 박아두면 Phase 3는 단순 집계만 함 → 중복 리서치 제거
-
-### Hyperframes 단계
-1. **scaffold**: `npx hyperframes init <dir> --resolution portrait --non-interactive --skip-transcribe`. 직전 batch (`.promo/<prev>/index.html`)가 있으면 **반드시 읽고 layout/CSS/모션 패턴을 그대로 미러** — 시리즈 톤 일관성.
-2. **assets/logos/** (mandatory — 이전 batch 누락 함정):
-   - 모든 brand에 대해 `assets/logos/<id>.png` 다운로드. 1차: Tier 1 사이트의 `<link rel="icon" sizes="256">` / `apple-touch-icon`. 2차 fallback: `https://www.google.com/s2/favicons?domain=<domain>&sz=256`. 3차: `https://github.com/<org>.png?size=128` (GitHub org avatar).
-   - **검증**: `file assets/logos/*.png` → 모두 `PNG image data` 출력. 1KB 미만은 retry (다른 source).
-   - **mandatory `<img class="logo">`**: 각 brand 카드 좌상단(=wordmark 위)에 `<img class="logo" src="assets/logos/<id>.png" alt="<id>" />` 삽입. wordmark만 텍스트로 두는 패턴 금지 — 직전 batch (2026-05-14 kr10) 가 이걸 빼먹어 재렌더 사태 발생.
-   - **CSS template** (직전 batch 2026-05-13 패턴 그대로):
-     ```css
-     .card .left .logo {
-       width: 140px; height: 140px;
-       border-radius: 28px;
-       background: #fff;
-       padding: 12px;
-       object-fit: contain;
-       box-shadow: 0 8px 24px rgba(0,0,0,.08);
-     }
-     ```
-   - **GSAP intro**: `tl.from(logo, { scale: 0.7, opacity: 0, ease: "back.out(2)" })` — 카드 entry 모션의 첫 비트.
-3. **edit `index.html`**: 카드 시퀀스 합성. timeline은 GSAP 또는 hyperframes 기본 `data-anim`.
-4. **lint**: `npx hyperframes lint` — 0 errors 확인.
-5. **render**: `npx hyperframes render -o ../<batch-slug>.mp4 -q standard -f 30`
-6. **verify**: 파일 사이즈 > 1MB, duration ≥ 30s (`ffprobe`).
-7. **logo presence assertion** (regression guard, render 후):
-   ```bash
-   # index.html에 모든 10 brand logo가 박혀있는지 확인
-   for id in <10-brand-ids>; do
-     grep -q "assets/logos/${id}.png" .promo/<batch>/index.html || echo "MISSING LOGO: $id"
-   done
-   ```
-   하나라도 missing이면 render 무효 — 다시 작업.
-
-### 자막/오디오
-- TTS는 옵션. 기본은 무음 + 한글 텍스트 큰 활자. 사용자가 명시적으로 요청 시 `hyperframes tts` 사용.
-
----
-
-## 트리거 패턴
-
-- 카테고리 + 숫자 자유 텍스트:
-  - "한국 IT 10개 추가해줘" → 카테고리=한국 IT, n=10
-  - "AI 스타트업 10개 더" → AI 스타트업, n=10
-  - "디자인 스튜디오 10개 batch" → 디자인 스튜디오, n=10
-- 영상까지 기본 포함. "영상 없이"라고 명시하면 Phase 4 스킵.
-
----
-
-## 안티패턴 (절대 금지)
-
-- ❌ Phase 2 완료 전에 Phase 3 카운트 갱신 (mismatch 발생)
-- ❌ `.promo/` 결과물을 git add (gitignored 강제)
-- ❌ "Verified footer만 박고 §4 본문 안 건드림" (omd:add-reference 와 동일 룰)
-- ❌ TTS/음악을 사용자 컨펌 없이 추가
-- ❌ logo를 자체 그리기 (public brand asset URL 또는 fetch 실패 시 텍스트 로고)
-- ❌ **카드에 logo `<img>` 없이 wordmark 텍스트만 박는 것** — 2026-05-14 kr10 재렌더 trigger. 카드 좌상단 logo PNG는 hard requirement.
-- ❌ Phase 3 끝났는데 regression guard grep을 안 돌림 (stale number 누락의 1순위 원인)
-- ❌ `web/src/app/builder/layout.tsx` · `web/src/app/design-systems/layout.tsx` · `web/src/app/layout.tsx`의 SEO description 미갱신 (이전 2 batch 연속 누락된 surface — 체크리스트 명시됨)
-- ❌ promo composition을 Phase 2 결과(_promo.json) 없이 작성
-- ❌ **§1 헤더를 비표준으로 작성** — `## 1. Visual Theme & Atmosphere` + 산문 첫 단락이 catalog canonical. "Overview" / "Identity" / "Foundation tokens" / `## §1` 변형 쓰면 `/reference/<id>` Hero card mood prose가 빈칸으로 렌더 (2026-05-14 kr10 batch에서 flex/upbit/kbank 3건 발생). Phase 3 regression guard에 `grep -L '^## 1\. Visual Theme' references/*/DESIGN.md` 검증 포함.
-
----
-
-## 산출 보고 형식 (각 phase 끝)
-
-```
-Phase 1: 10 후보 — <list>  ✓ 사용자 컨펌
-Phase 2: build — 완료 <n>/10, 실패 <list>, 평균 §4 길이 <n> bullets
-Phase 3: sync — refs <prev> → <now>, 갱신 파일 <n>개, npm test pass
-Phase 4: promo — .promo/<batch>/<file>.mp4, <duration>s, <size>
-```

package/.opencode/oh-my-design/.claude/skills/omd-codex-image/SKILL.md

@@ -1,162 +0,0 @@
----
-name: omd:codex-image
-description: "이미지 placeholder를 동적으로 materialize. Codex 채널에서는 내장 image-generation primitive 호출, Claude Code 채널에서는 omd-asset-curator로 fall back, OpenCode에서는 spec dump. HTML/MD의 `<!-- omd:gen-image -->` 블록을 단일 source of truth로 사용. '이미지 생성해줘', '플레이스홀더 채워줘', '코덱스로 이미지 만들어' 류 트리거."
-user-invocable: true
----
-
-# omd:codex-image
-
-채널-aware 이미지 materialization 스킬. **하나의 spec format** + **세 가지 downstream 처리**.
-
-문제: oh-my-design이 emit하는 HTML/MD에는 늘 illustration 자리가 비어있다. 채널별 capability가 다르다 — Codex CLI는 내장 image generation을 갖고, Claude Code는 안 가졌고, OpenCode는 user에게 위임한다. 이 차이를 skill 1개로 통합한다.
-
-## 0. 단일 spec format
-
-artifact (HTML, Markdown, JSX, MDX) 안에 다음 주석 블록을 둔다.
-
-```html
-<!-- omd:gen-image
-  filename: assets/karrot-hero.png
-  prompt: "Karrot mobile home feed screenshot — white canvas, warm near-black headings, single Karrot Orange #FF6600 floating CTA. Mobile portrait, no chrome."
-  aspect: "16:9"
-  style: "product screenshot, minimal, mobile"
-  references:
-    - https://www.daangn.com/
-    - https://seed-design.io/
-  notes: "Single saturated element per viewport. Use brand orange only on the CTA."
--->
-<img src="assets/karrot-hero.png" alt="당근 홈 피드의 단일 오렌지 CTA" />
-```
-
-규칙:
-
-- `filename` — 결과물 저장 경로. 같은 디렉토리 기준 상대경로 권장.
-- `prompt` — 한 문단, 구체적, 시각 디테일 + 톤 + 컬러 hex 포함.
-- `aspect` — `16:9` `4:3` `1:1` `9:16` 중 하나.
-- `style` — 1~3 단어 (`product screenshot` / `inline svg` / `editorial photo` / `dieline diagram`).
-- `references` — 실제 브랜드 URL (선택, IP-safe 컨텍스트용).
-- `notes` — generator나 검수자가 알아야 할 제약. 
-
-이 spec은 channel과 무관하다. 채널별 처리는 §1.
-
-## 1. 채널 분기
-
-호출 envelope의 `channel` (또는 환경 detect — `process.env.OMD_CHANNEL`이나 host agent 식별)에 따라:
-
-### 1.1 channel = `codex`
-
-Codex CLI는 native image generation을 갖고 있다. 다음 순서:
-
-1. artifact를 Read로 전체 로드
-2. `<!-- omd:gen-image ... -->` 블록을 정규식으로 추출 (multiline)
-3. 각 블록마다 Codex의 image generation primitive 호출 — 도구명은 host에 따라 다르다 (`generate_image`, `image.create`, `dall_e_image_generation`, `gpt_image_1` 등). Codex agent가 자기 환경에서 사용 가능한 것을 선택한다.
-4. 출력 파일을 `filename` 경로에 저장 (mkdir -p)
-5. **주석 블록은 그대로 두고** `<img src>`나 `![]()` 경로가 매칭되는지 확인. 안 맞으면 alt 텍스트 보존하면서 src만 교체.
-6. 각 처리 항목에 `<!-- omd:gen-image:done at=<ISO timestamp> by=codex -->` 주석을 spec 블록 아래에 1줄 추가.
-
-generation 실패 시: spec 블록은 그대로, `<!-- omd:gen-image:error reason="..." -->` 추가. 다음 호출이 재시도 가능하도록.
-
-prompt 보강 (Codex가 좋은 결과를 내려면):
-
-- `prompt` 원문 + 다음 prefix 자동 prepend: `"Render as <aspect> <style>. "`
-- `notes`에 색 hex 있으면 prompt 끝에 `"Use only the following colors: <hex list>."` 추가
-- `references` 있으면 `"Stylistic reference inspiration only — do not copy verbatim: <urls>"` 추가
-
-### 1.2 channel = `claude-code`
-
-Claude Code는 native image generation이 없다. 대신 `omd-asset-curator` 스킬로 라우팅:
-
-1. spec 블록을 추출
-2. 각 블록을 omd-asset-curator의 spec 형식으로 변환:
-   - `prompt` → asset-curator의 `description`
-   - `style` → asset-curator의 medium 힌트 (`product screenshot` → Picsum/Loremflickr, `inline svg` → 직접 SVG 생성, `icon` → Lucide)
-3. asset-curator가 free-license 자원에서 매칭 (DiceBear avatars, Lucide icons, Picsum CC0 photos, unDraw SVG 등) 또는 인라인 SVG를 생성해 `filename`에 저장
-4. spec 블록 그대로 두고 `<!-- omd:gen-image:done at=<ISO> by=asset-curator source=<url> -->` 추가
-5. **사용자에게 1줄 알림**: "Claude Code에서는 free-license fallback을 적용했어요. 더 정확한 이미지는 Codex 채널에서 generate하면 돼요."
-
-### 1.3 channel = `opencode`
-
-OpenCode는 image generation도, asset-curator도 자동으로 못 돌린다. user-in-the-loop:
-
-1. spec 블록을 추출
-2. terminal에 `## Image generation queue` 섹션을 emit:
-   ```
-   3개 이미지를 수동으로 생성/소싱해서 다음 경로에 두세요:
-
-   1. assets/karrot-hero.png  (16:9)
-      prompt: "Karrot mobile home feed — single orange CTA..."
-      refs: https://www.daangn.com/
-
-   2. ...
-   ```
-3. spec 블록은 그대로 두고 done 주석은 user 확인 후에만 추가
-
-## 2. fallback 그래프
-
-artifact를 처리할 때 항상 우선순위:
-
-```
-Codex native gen  ──┐
-                    ├─► success → done 주석 추가
-asset-curator      ──┘
-                    │
-                    └─► fail → user-queue (OpenCode 식 prompt)
-```
-
-각 단계 실패는 다음 단계로 escalate. 마지막 단계도 실패하면 error 주석 + 사용자에게 명시.
-
-## 3. idempotency
-
-이 스킬은 같은 artifact에 여러 번 돌려도 안전해야 한다.
-
-- 이미 `<!-- omd:gen-image:done -->` 주석이 붙은 spec 블록은 스킵
-- `filename` 경로의 파일이 이미 존재하면 (size > 0) 스킵
-- `--force` 명시되면 둘 다 무시하고 재생성
-
-## 4. IP safe rails
-
-- `references` URL은 inspiration만. 절대 verbatim 카피 X.
-- 브랜드 로고는 generation이 아니라 reference에서 **다운로드**해서 가져오기. Codex/asset-curator 둘 다 로고는 generate 금지 (왜곡된 가짜 로고는 IP risk).
-- 사람 얼굴이 들어가는 generation은 디폴트 거절 (DiceBear avatars 같은 캐리커처는 OK).
-
-## 5. 출력 보고
-
-처리 끝에 한 줄 요약:
-
-```
-✓ 4 images materialized (codex)  ·  0 skipped  ·  0 errors
-  → experiments/2026-05-19/karrot/assets/{hero,one-color,grid,detail}.png
-```
-
-또는 fallback이 섞였을 때:
-
-```
-✓ 2 codex · 2 asset-curator fallback · 1 user-queue
-```
-
-## 6. 호출 envelope
-
-```yaml
-agent: omd-codex-image
-inputs:
-  artifact_path: experiments/2026-05-19/karrot/landing.html
-  channel: codex          # 또는 claude-code | opencode | auto
-  force: false            # done 주석 무시하고 재생성
-  dry_run: false          # spec parse만 하고 generation 안 함
-```
-
-`channel: auto`면 env 또는 host detection으로 분기.
-
-## 7. 금지
-
-- spec 블록을 *제거*하지 말 것. done 주석만 *추가*. spec은 영구 기록.
-- Codex가 사용 불가한 환경에서 channel=codex 강제 호출 X — auto 또는 명시적 fallback 사용.
-- 같은 filename에 다른 prompt 두 번 처리 금지 (idempotency violation).
-- generation prompt에 사람 신원이나 실명 절대 넣지 않기.
-
-## 8. 다른 스킬과의 관계
-
-- **omd-asset-curator**: 무료 라이선스 자산 카탈로그. codex-image의 claude-code fallback path.
-- **omd-reference-capture**: 라이브 브랜드 사이트 캡쳐. `references:` URL 검증용으로 같이 쓰면 정확도 ↑.
-- **omd-orchestrator**: HTML emit 후 codex-image를 마지막 단계에 끼워 넣을 수 있음. orchestrator의 worker 카탈로그에 추가됨.
-- **omd-final-qa**: gen 결과 paste-in 후 자기 rubric에 "image quality" 항목 추가 (선택).

package/.opencode/oh-my-design/.claude/skills/omd-component-harvest/SKILL.md

@@ -1,59 +0,0 @@
----
-name: omd-component-harvest
-description: "기존 references/<id>의 §8 Component Patterns + frontmatter `tokens.components`를 멀티서피스(여러 라우트 + 메뉴/모달 인터랙션) + 공개 디자인시스템(Storybook/Primer/Polaris/Cedar/Geist/*.design) 크롤로 풍부화. 단일 랜딩 스냅샷의 '버튼 수준'을 모달·탭·테이블·토스트·폼상태까지 확장하되, 소스가 빈약하면(랜딩만 있는 앱 중심 기업) 억지로 만들지 않고 정직하게 cap. 완료 시 `tokens.components_harvested: true` 마커. '컴포넌트 풍부화', '컴포넌트 하베스트', 'X 컴포넌트 보강', 'component harvest' 류에 트리거. 토큰 자체가 없으면 먼저 omd-token-backfill/omd-add-reference."
----
-
-# omd:component-harvest — deepen a reference's component documentation
-
-단일 랜딩 인스펙트는 컴포넌트를 **버튼/카드/내브 수준**에서 멈춘다(모달·데이트피커·테이블·토스트·탭·스텝퍼·빈상태·폼에러는 클릭/로그인/앱 라우트 뒤에 있음). 이 스킬은 **인스펙션 표면을 넓혀**(멀티 라우트 + 인터랙션 + 공개 DS 크롤) §8과 `tokens.components`를 풍부하게 만든다 — **단, 정직성 게이트를 유지**한다.
-
-## 제1원칙 — 억지로 만들지 않는다 (정직성)
-> "도전은 하되, 소스가 빈약하면 무리해서 뭔가를 만들어 제공해야 한다는 강박을 두지 않는다."
-
-- 풍부함은 **소스가 허락하는 만큼**만. 랜딩 한 장 + 앱스토어 스크린샷뿐인 모바일 앱 중심 기업은 **6개에서 정직하게 멈춘다**. 채우려고 컴포넌트를 발명(confabulate)하지 않는다.
-- 우리 게이트는 **색(hex) grounding만** 강제한다. 컴포넌트 세부 스펙은 게이트가 전수 검증하지 않으므로, **출처 없는 스펙을 쓰면 그게 곧 confabulation**이다. 측정했거나 공개 DS에 문서화된 것만 쓴다.
-
-## 티어링 (소스 신뢰도 순)
-1. **공개 DS 있음** (primer.style·polaris·cedar·geist·*.design·공개 Storybook/Figma) → **헤비 크롤**. DS 문서의 컴포넌트 인벤토리 + 정확한 토큰명·radius·height를 lift. (github=Primer가 모범 사례: 0→41.)
-2. **공개 DS 없으나 웹앱 깊음** (SaaS 대시보드, 다중 마케팅 라우트) → **멀티 라우트 + 인터랙션**: pricing/docs/login/blog 방문, 메뉴·모달·드롭다운 열어 getComputedStyle. 본 것만 기록.
-3. **소스 빈약** (랜딩 1장, 앱 중심) → **정직한 cap**. 보이는 3~6개만, `note`에 "landing-only / app-first — capped" 명시. **그래도 `components_harvested: true`** (= "시도했고, 이게 소스의 끝").
-
-## 절차 (ref 1개)
-1. **베이스라인** — `references/<id>/DESIGN.md` 전체 읽기. 현재 §8 컴포넌트 수 + `tokens.components` 수 기록.
-2. **소스 판별** — 공개 DS 존재 여부 확인(브랜드명 + "design system"/"storybook"/"primer/polaris/cedar/geist", `*.design` 서브도메인). 티어 결정.
-3. **하베스트**:
-   - 라이브: playwright `getComputedStyle` (GLOBAL_ROOT=$(npm root -g), `--disable-http2`, networkidle, 쿠키/모달 dismiss). 여러 라우트면 순회. 가능하면 메뉴/모달 열어 캡처.
-   - 공개 DS: 컴포넌트 인덱스 + 각 컴포넌트의 shape(radius)/size(height·padding)/color roles/states를 **실제 토큰명으로** lift.
-4. **§8 재작성** — `## 8. Component Patterns`를 그룹화(Actions/Navigation/Forms/Data display/Overlays/Feedback & Status)된 `**component**` 항목들로. 각 항목에 구체 스펙(radius/height/padding/color/states). 소스가 빈약하면 적게 — 발명 금지.
-   - `## Responsive Behavior` 표(브레이크포인트 + 변화)도 공개 DS에 있으면 보강.
-5. **tokens 블록 (구조화 — 렌더러 직결)** — `tokens.components`를 **구조화 객체**로 작성(헤비면 15+, cap이면 3~6). 렌더러(`componentsFromTokens`)가 이걸 직접 읽어 그린다(프로즈 §4 파싱보다 우선). flat 문자열 금지.
-   ```yaml
-   components:
-     button-primary: { type: button, bg: "#1f883d", fg: "#ffffff", radius: "6px", height: "32px", padding: "0 16px", 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" }
-   ```
-   - **`type` 필수** — `button input card badge tab toggle toast dialog listItem avatar` 중 정확히 하나. 이 밖은 가장 가까운 것으로(table/tooltip/banner/empty-state→card, modal/sheet/overlay→dialog, segmented/nav→tab, chip/label/counter→badge, stepper/switch→toggle). **무엇도 버리지 않음.**
-   - 선택 필드(소스에 있는 것만): `bg fg border radius padding height font shadow hover focus active disabled states use`. tab은 `active`에 "Npx bottom border #hex" 형태로 넣어야 언더라인이 그려짐.
-   - `tokens.components_harvested: true` 추가. 공개 DS 출처면 `source: design-system`. (상세: `spec/components-schema.md`)
-6. **미러** — `design-md/<id>/DESIGN.md` 복사.
-7. **검증 + 트래킹** — `cd web && node scripts/build-registry.mjs && npx vitest run` (정합성·proof·leak 게이트 통과). `node scripts/token-status.mjs --components`로 harvested 카운트 +1 확인.
-
-## 하드 규칙 (테스트가 강제)
-- `colors` hex는 6-digit `#rrggbb`만, 전부 산문에 grounding. (rgba는 shadow/note만.)
-- frontmatter 닫는 `---` **위**에 `##`/`-` 프로즈 금지(leak 가드).
-- flow 매핑 `{` 앞 공백.
-- **출처 없는 컴포넌트 스펙 금지.** 측정값 또는 공개 DS 문서만.
-
-## 마커 & 체크리스트
-- 완료 표식: `tokens.components_harvested: true` (리치든 정직-cap이든 "패스 돌림"의 의미). 이게 있으면 트래커가 더 이상 candidate로 안 띄움 → **빈약한 ref를 영원히 nag하지 않음.**
-- **`web/scripts/token-status.mjs`** 가 컴포넌트 체크리스트:
-  - `--components` → harvested · rich(unmarked) · candidates 카운트 + candidate 목록(토큰 있고 <10 comp, 미harvest).
-  - `--md` → "Components — Harvested / Harvest candidates" 섹션.
-
-## 배치
-**기본 5개 / run.** candidate 목록 앞에서 뽑되, 티어 섞기(공개 DS 1~2 + 일반 + cap 후보)로 원칙을 매번 검증. 재개는 token-status가 보장.
-
-## 하지 말 것
-- ❌ 숫자 채우려 컴포넌트 발명. ❌ 출처 없는 스펙. ❌ cap한 ref에 `components_harvested` 누락(트래커가 계속 nag함).
-- ❌ 토큰 없는 ref를 여기서 처리(먼저 omd-token-backfill 또는 omd-add-reference Phase 4.5).
-- ❌ 산문 본문에 `{token}` 참조 치환(렌더러 이슈).

package/.opencode/oh-my-design/.claude/skills/omd-designer-review/SKILL.md

@@ -1,146 +0,0 @@
----
-name: omd:designer-review
-description: "시각 + 브랜드 일관성 리뷰. HTML/MD/JSX artifact를 받아 brand DESIGN.md 대비 typo hierarchy, 색 budget, radius scale, 컴포넌트 state, 모바일 반응형 검수. severity BLOCK/WARN/FYI + line ref 출력. 'UI 리뷰', '디자인 검토', 'DESIGN.md 대비 검수' 류 트리거."
-user-invocable: true
----
-
-# omd:designer-review
-
-artifact를 받아 brand의 DESIGN.md 기준으로 visual / brand consistency를 audit한다. **read-write가 아니라 advisory** — 직접 수정하지 않고 review report만 emit.
-
-구조는 [`mastepanoski/claude-skills` ui-design-review](https://agentskills.so/skills/mastepanoski-claude-skills-ui-design-review)에서 차용.
-
-## 0. 필수 입력
-
-- `artifact_path`: HTML, MD, JSX, TSX 중 하나
-- `design_md_path`: 해당 브랜드의 `references/<id>/DESIGN.md` 또는 프로젝트 루트 `DESIGN.md`
-- (선택) `viewport`: `mobile` | `desktop` | `both` (default: both)
-
-이 두 입력이 없으면 BLOCK으로 즉시 종료.
-
-## 1. Audit 카테고리 (6)
-
-### 1.1 Typography hierarchy
-
-- DESIGN.md `§ Typography` 스펙 read
-- artifact 내 h1/h2/h3/p의 size, weight, line-height 추출
-- 일치 여부 검사
-- 빈 h-level skip (h1 → h3) → WARN
-- 본문 weight가 400/500이 아닌 700 fall-through → WARN
-
-### 1.2 Color budget (Toss "2 saturated brand elements / viewport" rule)
-
-DESIGN.md `§ Color`의 brand saturated tokens 추출.
-
-- viewport당 brand saturated 사용 횟수 카운트
-- > 2 → WARN (Toss principle 위반)
-- > 4 → BLOCK
-- DESIGN.md에 없는 hex 직접 사용 → WARN
-- 회색 대신 saturated 사용 (예: warning이 아닌 컨테이너에 red-500) → WARN
-
-### 1.3 Radius scale
-
-- DESIGN.md `§ Radius` 토큰 read (예: 0, 4, 8, 12, 16, 9999)
-- artifact 내 `border-radius` 추출
-- 토큰에 없는 값 → WARN
-- 한 컴포넌트 안에서 radius 혼용 (8 + 12) → FYI
-
-### 1.4 Component states
-
-각 interactive 요소가 다음 state를 갖춰야:
-- default ✓
-- hover ✓
-- focus (focus-visible OK) ✓
-- active ✓
-- disabled ✓
-
-누락 → BLOCK (focus는 a11y 필수)
-
-### 1.5 Mobile responsiveness
-
-- viewport=both인 경우 mobile에서 검사
-- 최소 hit area 44x44 (iOS HIG) → BLOCK 미달
-- 가로 스크롤 발생 → BLOCK
-- 텍스트 14px 미만 → WARN
-
-### 1.6 Spacing / layout
-
-- DESIGN.md `§ Spacing` 토큰
-- 토큰 외 값 (예: `padding: 13px`) → WARN
-- 인접 요소 간 일관성 (한 카드 안에서 padding-x가 16 vs 20 혼재) → WARN
-
-## 2. Severity 정의
-
-| Severity | 의미 | 후속 조치 |
-|---|---|---|
-| **BLOCK** | a11y 또는 hard rule 위반. 출간 불가. | writer로 revision round 1 |
-| **WARN** | best practice 위반. 출간 가능하나 권장 수정. | writer가 판단 후 fix |
-| **FYI** | 정보성. 의도일 수 있음. | 무시 가능 |
-
-## 3. 출력 형식
-
-`<work_dir>/.reviews/designer-review-round-<N>.md`:
-
-```markdown
-# Designer review — round <N>
-
-**Date:** <ISO>
-**Artifact:** <path>
-**DESIGN.md:** <path>
-**Viewport:** mobile | desktop | both
-
-## Summary
-
-- BLOCK: <count>
-- WARN: <count>
-- FYI: <count>
-
-## Issues
-
-### [BLOCK] Focus state missing on primary CTA
-- **Location:** `components/SignupForm.tsx:42`
-- **Rule:** § Component states — focus is mandatory
-- **Evidence:** `<button className="bg-blue-500 hover:bg-blue-600">` — focus 클래스 없음
-- **Fix suggestion:** add `focus-visible:ring-2 focus-visible:ring-blue-300`
-
-### [WARN] Color budget exceeded on mobile hero
-- **Location:** `index.ko.md:34-41`
-- **Rule:** § Color budget — max 2 saturated / viewport
-- **Evidence:** 3 saturated brand 사용 (red-500, blue-500, green-500)
-- **Fix suggestion:** green-500을 gray-700 또는 텍스트로 대체
-...
-
-## Verdict
-
-- **PASS** (BLOCK=0, WARN≤3) — 출간 OK
-- **REVISION** (BLOCK=0, WARN>3) — 권장 수정 후 재리뷰 옵션
-- **BLOCK** (BLOCK≥1) — 출간 불가, writer revision round 시작
-```
-
-## 4. 시각 검수 (optional)
-
-artifact가 HTML/JSX이고 browser-harness가 가용하면 mobile 320px + desktop 1280px 스크린샷을 캡쳐해 `.reviews/screenshots/`에 저장. 텍스트 audit과 함께 첨부.
-
-## 5. DESIGN.md 강제 재독
-
-**Anti-pattern**: 이전 review에서 읽은 DESIGN.md를 캐싱해 재사용 → memory hallucination 위험.
-
-→ 매 호출마다 DESIGN.md를 **다시 read**. 읽은 timestamp를 report 헤더에 명시.
-
-## 6. Anti-patterns
-
-- ❌ "looks good" rubber-stamp (final-qa 동일 룰. designer-review도 "전반적으로 괜찮음" 식 응답 금지)
-- ❌ DESIGN.md 안 읽고 일반 best practice로 평가
-- ❌ severity inflation (모든 걸 BLOCK)
-- ❌ severity deflation (BLOCK 사안을 FYI로)
-- ❌ Fix suggestion 없는 issue (반드시 actionable)
-- ❌ Line ref 없는 issue (`somewhere in the file` 금지)
-
-## 7. 1회 revision 후 재호출 시
-
-input에 `prior_report_path` 포함되면:
-- 이전 BLOCK/WARN 항목을 list로 추출
-- artifact 재read
-- 항목별로 RESOLVED / UNRESOLVED / NEW로 표시
-
-Round 2에도 UNRESOLVED BLOCK 있으면 orchestrator로 BLOCK escalation.