zugzbot 1.0.21 → 1.0.23

package/.opencode/oh-my-design/.claude/skills/omd-final-qa/SKILL.md

@@ -1,153 +0,0 @@
----
-name: omd:final-qa
-description: "출간 ready 직전 read-only critic. 8-item rubric 강제. 'looks good' rubber-stamp 금지. 라인 ref 필수. 2-round revision hard cap. '최종 QA', '출간 검수', 'rubric으로 평가' 류 트리거."
-user-invocable: true
----
-
-# omd:final-qa
-
-artifact가 사용자에게 handoff 되기 전 마지막 게이트. **read-only**. 절대 수정하지 않고, verdict + actionable feedback만 emit.
-
-## 0. 입력
-
-- `artifact_paths`: 모든 locale 파일 (예: `index.ko.md`, `index.en.md`)
-- `design_md_path`: brand DESIGN.md
-- `prior_reviews`: designer-review 보고서 경로 (있으면)
-- `voice_preset`: kr-writer가 사용한 preset_id
-- `round`: 1 또는 2 (orchestrator가 주입)
-
-## 1. Rubric (9 items, 모두 closed checklist)
-
-각 항목은 **PASS / FAIL** 이진. 회색 zone 없음. 1개라도 FAIL이면 verdict = REVISION (round 1) 또는 BLOCK (round 2).
-
-### [1] Brand consistency
-- DESIGN.md의 §Color/§Typography/§Spacing 토큰이 artifact에 사용됨
-- DESIGN.md에 없는 hex/font/spacing 직접 사용 0건
-- 검증: artifact 내 모든 토큰값 추출 → DESIGN.md set과 diff
-
-### [2] Typography hierarchy
-- h1 1개, h2 ≥2개, h3는 h2 자식으로만
-- 빈 level skip 0건 (h1→h3 금지)
-- 본문 weight 일관
-
-### [3] Voice register
-- 선언된 `voice_preset` 룰 준수 (예: toss-tech-design이면 `-요` 종결 100%)
-- 금지 어미 0건 (preset spec 참조)
-- 평균 문장 길이가 preset 범위 내
-
-### [4] Image / figure
-- 모든 `<img>` / `![]()`에 alt 텍스트 존재
-- caption (figcaption 또는 figure 옆 짧은 설명) 존재
-- alt와 caption이 다름 (alt=설명, caption=맥락)
-- src 경로 valid (파일 존재)
-
-### [5] Cross-locale parity
-- KR이 N H2 → 다른 locale도 N H2
-- KR이 N figure → 다른 locale도 N figure
-- frontmatter `source_revision` 최신
-
-### [6] Accessibility
-- 대비비 AA 충족 (text/bg 4.5:1, large 3:1)
-- focus state 정의됨 (CSS 또는 컴포넌트)
-- semantic HTML (button vs div, nav, main, article)
-- 한국어 본문에 `lang="ko"`
-
-### [7] Performance
-- 이미지가 적정 크기 (>500KB 단일 이미지 = FAIL)
-- 코드 블록에 lang 태그 (` ```ts `, ` ```python `)
-- 외부 폰트 로드 시 `font-display: swap`
-
-### [8] Links
-- 모든 hyperlink HTTP 200 (브로큰 0건). 외부 링크 체크는 best-effort.
-- 외부 링크에 indicator (icon 또는 `target="_blank" rel="noopener"`)
-- relative path 일관
-
-> 한국어 표기/맞춤법은 이 rubric의 자동 항목이 아니다. 자동 검사가 필요하면
-> 외부 서비스(예: 부산대 한국어 맞춤법 검사기)를 작성자가 별도로 돌린다 —
-> 번들된 결정론적 도구는 없다.
-
-## 2. Anti-rubber-stamp guardrails
-
-- "looks good", "전반적으로 OK", "전체적으로 괜찮음" 등 문구 hard-banned. 사용 시 self-reject.
-- 각 PASS도 **왜 PASS인지 1줄 evidence** 필수.
-- 각 FAIL은 **라인 ref + verbatim quote + fix direction** 필수.
-- DESIGN.md를 강제 재read. 캐시된 기억 사용 금지. Report 헤더에 `design_md_read_at` ISO timestamp 명시.
-
-## 3. 2-round hard cap
-
-```
-round 1:
-  rubric FAIL → verdict = REVISION
-  → orchestrator가 writer로 송환
-round 2:
-  rubric FAIL → verdict = BLOCK
-  → orchestrator가 사용자 escalation
-```
-
-3번째 round 금지. 사용자가 강제 통과 결정 시 known-issues로 frontmatter 기록 후 ship.
-
-## 4. 출력 형식
-
-`<work_dir>/.reviews/final-qa-round-<N>.md`:
-
-```markdown
-# Final QA — round <N>
-
-**Date:** <ISO>
-**Artifacts:** <list>
-**DESIGN.md read at:** <ISO>
-**Voice preset:** <preset_id>
-
-## Rubric
-
-| # | Item | Verdict | Evidence |
-|---|---|---|---|
-| 1 | Brand consistency | PASS | DESIGN.md 12 tokens 모두 사용. 추가 hex 0건. |
-| 2 | Typography hierarchy | FAIL | `index.ko.md:88` h2 → h4 skip. h3 누락. |
-| 3 | Voice register | PASS | 종결어미 `-요` 198/198 (100%). |
-| 4 | Image / figure | FAIL | `index.ko.md:34` alt 텍스트 누락. |
-| 5 | Cross-locale parity | PASS | KR 6 H2 = EN 6 H2. |
-| 6 | Accessibility | PASS | 대비비 7.1:1. focus-visible 정의됨. |
-| 7 | Performance | PASS | 모든 이미지 < 200KB. |
-| 8 | Links | PASS | 23 link, broken 0. |
-
-## Failed items detail
-
-### [2] Typography hierarchy — h-level skip
-- Location: `index.ko.md:88`
-- Evidence: `## 가져가도 좋은 것` → 다음에 `#### 1. 토큰` (h4)
-- Fix: h3로 변경
-
-### [4] alt 텍스트
-- Location: `index.ko.md:34`
-- Evidence: `![](./images/karrot-hero.png "당근 메인")`
-- Fix: alt 채움. 예: `![당근 메인 화면 스크린샷](./images/karrot-hero.png "당근 메인")`
-
-## Verdict
-
-**REVISION** (round 1) — 2 items FAIL. Writer로 송환.
-
-다음 round에서 동일 항목 FAIL 시 BLOCK.
-```
-
-## 5. Anti-patterns
-
-- ❌ "looks good" / "괜찮음" 류 응답 — hard ban
-- ❌ Evidence 없는 PASS
-- ❌ Line ref 없는 FAIL
-- ❌ Severity / verdict 회피 (애매한 "약간 우려" 금지 → PASS 또는 FAIL)
-- ❌ 직접 수정 시도 (read-only 원칙)
-- ❌ Rubric 추가/삭제 (8 items은 고정. 추가는 별도 PR로 SKILL.md 갱신.)
-- ❌ DESIGN.md를 한 번 읽고 round 2에서 재사용
-
-## 6. Rubric 확장 (메타)
-
-새 rubric item 추가는:
-1. 이 SKILL.md에 [9] 이상으로 추가
-2. 한국어 closed PASS/FAIL 정의
-3. orchestrator의 round-cap에 영향 없음 (rubric 늘어도 cap=2 유지)
-
-## 7. Cross-skill 의존
-
-- `omd-designer-review` 보고서 ← `prior_reviews`로 참조 (해소 여부 확인)
-- `omd-locale-adapter` 결과물 ← rubric [5]에서 검증

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

@@ -1,234 +0,0 @@
-<!-- omd:installed-skill — managed by `omd install-skills`. Do not edit; rerun the command to refresh. -->
-
----
-name: omd:harness
-description: "디자인 하네스 — 사용자가 디자인 작업을 자연어로 던지면, omd-master 오케스트레이터가 10-phase 파이프라인(Discovery / Asset / Research / IA / Wireframe / System / Components / AssetSourcing / Microcopy / Validation / Handoff)을 실행하고 8개 sub-agent를 dispatch해서 brief + DESIGN.md + wireframes + components + assets + persona-feedback 패키지를 emit합니다. 트리거: '/omd-harness <task>', '디자인 하네스 돌려줘', '시니어 디자이너처럼 ~ 만들어줘', 'oh-my-design으로 ~ 디자인 알아서 해줘', '하네스로 작업해줘'. v0/Cursor/Subframe에 던질 zip 핸드오프 자동 생성. user checkpoint 3회 mandatory."
----
-
-# omd:harness — Design Harness Entry
-
-이 스킬은 **omd-master 오케스트레이터**를 호출하는 단일 진입점이다. 본 스킬은 *얇은 launcher*이고, 모든 phase 로직은 `.claude/agents/omd-master.md`에 있다.
-
-## 트리거
-
-- `/omd-harness <task>` 명시 호출 — task는 슬래시 명령에 이어서 자연어로
-- 사용자가 자연어로 "디자인 하네스 / 시니어 디자이너처럼 / 알아서 디자인" 요청
-- (선택) 파워 유저는 직접 `omd harness "<task>"` CLI 사용 후 호출 — 그 경우 아래 #1에서 기존 run 자동 감지
-
-## Step 0 — task 추출
-
-사용자가 슬래시 명령에 task를 같이 적었으면 (`/omd-harness 물을 하루 3번 이상 음용하도록 유도하는 웹앱 메인 화면`), 그 자연어 부분을 task로 사용한다.
-
-빈 슬래시(`/omd-harness`)만 보냈으면 한 번 묻는다 (Question discipline `[Q]` 형식):
-
-```
-[Q] 어떤 디자인 작업을 진행할까요?
-    shape: "[도메인] + [톤/스타일] + [핵심 화면]" — 예: "토스 스타일로 가족용 식단 앱 메인 화면"
-```
-
-## 사전 체크 (이 스킬 본체에서 직접 수행)
-
-호출 즉시:
-
-0. **Subagent registration 확인 (critical pre-flight).** 이 세션에서 `omd-master` subagent가 dispatch 가능한지 verify. 만약 master spawn 시 "Agent type 'omd-master' not found" 에러가 발생할 가능성을 방지해야 함.
-
-   감지 방법: Agent tool의 사용 가능 subagent 목록에 `omd-master`가 있는지 확인. 없으면 사용자에게 명확한 안내:
-
-   ```
-   `omd-master` subagent가 이 세션에 등록되어 있지 않아요. Claude Code는 세션 시작 시점에만 `.claude/agents/*.md` 를 로드합니다 — `omd install-skills`를 세션 띄운 *후에* 돌렸으면 이 케이스.
-
-   해결 (가장 빠른 순서):
-   1. **현재 세션에서 `/agents` 실행** — Claude Code가 `.claude/agents/*.md` 강제 재스캔. omd-* 8개가 목록에 나타나면 `/omd-harness` 재호출.
-   2. 안 되면: Claude Code 앱 *완전 종료* (Cmd+Q / 터미널 앱 자체 quit) → 새 터미널 → `claude` 재실행 → `/omd-harness <task>` 재호출 (기존 run dir 자동 재사용).
-   ```
-
-   사용자가 재시작 못 하는 환경(예: 자동화 스크립트)이면 `general-purpose` subagent로 fallback 옵션 제공 (단 master 페르소나가 약해지므로 비추천).
-
-
-
-1. **Run 디렉토리 부트스트랩.** `.omd/runs/` 안의 가장 최근 run dir을 찾는다 (Bash `ls -t .omd/runs 2>/dev/null | head -1` 류). 발견 시:
-   - 그 run의 `task.md`를 읽어서 사용자 task와 일치하는지 짧게 확인
-   - 일치하면 **그 run 디렉토리 재사용** (재진입 시나리오)
-   - 불일치하거나 없으면 신규 run 부트스트랩 — Bash로 internal helper 호출:
-     ```bash
-     omd harness "<extracted task>" --internal
-     ```
-     **이 CLI는 internal helper**다 (사용자에게 `--help`에서 보이지 않음). 출력은 single-line JSON:
-     ```json
-     {"runId":"run-...","runDir":".omd/runs/run-...","taskFile":".omd/runs/run-.../task.md","labVersion":null,"designMdExists":false}
-     ```
-     이 JSON을 파싱해서 `runDir` / `designMdExists`를 확보한다. **스킬은 절대 직접 mkdir 하지 않는다** — slug 일관성(한국어/이모지 처리), 표준 서브폴더, INDEX.md append는 모두 CLI 책임.
-
-2. **DESIGN.md 존재 확인 + reference 의미 매칭 (skill-side, no API key).** 프로젝트 루트에 DESIGN.md 없으면 — **너 자신이 reference 추천을 한다** (외부 CLI 호출 없음, 외부 API key 없음).
-
-   ### 매칭 절차
-
-   a. **카탈로그 로드**: 다음 두 파일을 Read 툴로 전체 로드한다 (install-skills가 `.claude/data/`로 복사한다):
-      - `.claude/data/reference-fingerprints.json` — 67개 reference의 voice fingerprint + tone keywords + visual theme + antipatterns + signature motion + has_personas + category
-      - `.claude/data/reference-tags.md` — 사람-읽기 좋은 keyword 매트릭스
-      - `.claude/data/vocabulary.json` — controlled vocab (사용자 task에서 키워드 추출 시 참조)
-
-      만약 `.claude/data/`에 없으면 `node_modules/oh-my-design-cli/data/` 또는 패키지 root의 `data/` 에서 fallback Read.
-
-   b. **사용자 task 분석 (silent)**:
-      - controlled-vocab keyword 추출 (예: "헬스/웰니스 / calm-blue / 차분"  →  `[calm, minimal, approachable, warm]`)
-      - 명시 brand hint 추출 (예: "토스 같은" → `["toss"]`)
-      - 카테고리 추측 (Consumer / Productivity / Fintech / AI / Developer Tools / Design Tools / Automotive / Aerospace / SaaS / Enterprise — 67개 ref가 이 10개 카테고리로 분포)
-
-   c. **점수 계산** (in-head, 결정론적):
-      - 각 ref의 `tone_keywords` ∩ task keywords → 1점/매칭
-      - brand hint match → +5점
-      - 카테고리 일치 → +1점
-      - top 5 정렬
-
-   d. **검증** (hallucination 방지):
-      - 추천하는 모든 id는 `reference-fingerprints.json` 의 `items[].id` 안에 *반드시* 존재해야 한다. 없는 id는 절대 만들어내지 않는다.
-      - 검증 실패 시 다시 매칭.
-
-   ### 사용자에게 제시 (Question discipline — prose, no `(a)(b)(c)`)
-
-   ```
-   DESIGN.md가 없어서 reference 한 개를 골라 부트스트랩할게요. [task 핵심 한 줄]을 보니 **[top1.id]**가 가장 잘 맞을 것 같아요 — [top1의 visual_theme 핵심 + 매칭 키워드 1-2개를 자연어 한 줄로. 예: '차분한 calm-blue + 한국 핀테크의 절제된 톤이 헬스 도메인과 자연스럽게 어울림'].
-
-   이대로 가시려면 `go` (또는 `[top1.id]`).
-   다른 후보: `[top2.id]` ([top2 한 줄 이유]) · `[top3.id]` (...) · `[top4.id]` (...) · `[top5.id]` (...)
-   본인이 아는 다른 reference면 한 줄로 id만 (예: `vercel`) — 67개 카탈로그에 없으면 알려드립니다.
-   ```
-
-   ### 사용자 응답 처리
-
-   - `go` 또는 reference id (top-5 안) → 그 id로 master spawn (Phase 5에서 master가 `omd init prepare --ref <id> --description "<task>" --json` 호출 — 이 부분은 v1 그대로 유지, delta_set 로직 안전성 위해)
-   - 다른 reference id (top-5 밖이지만 카탈로그 안) → 동일하게 진행
-   - 카탈로그에 없는 id → `해당 id는 67개 카탈로그에 없어요. top-5 중에서 골라주시거나 본인이 init먼저 따로 진행해주세요.`
-   - `init먼저` → 종료, 사용자가 omd init 따로 진행 후 재호출
-   - `중단` → 종료
-
-<!-- API key check intentionally removed — the harness runs entirely inside the host CLI session (Claude Code / Codex). External API keys are NOT needed for v1. Cross-family jury is a v2+ opt-in feature. -->
-
-
-## Master 호출 — handoff loop (CRITICAL architecture)
-
-**Subagent (master)는 AskUserQuestion 호출 불가 (main-thread 전용).** 그래서 file-based handoff 패턴으로 돌린다 — master가 questions.json 작성, launcher(이 스킬, main thread)가 AskUserQuestion 호출.
-
-### 루프 의사코드
-
-```
-spawn_count = 0
-prompt = "<run_dir + task + chosen_ref_id>. Phase 1부터 시작."
-
-while spawn_count < 12 (safety cap):
-  result = Agent({
-    subagent_type: "omd-master",
-    description: "Run design harness round N",
-    prompt: prompt
-  })
-  spawn_count += 1
-
-  handoff_path = "<run_dir>/.handoff.json"
-  if not exists(handoff_path):
-    # master가 handoff 안 적었으면 그 응답을 그대로 relay하고 종료
-    relay result text to user
-    halt
-  
-  handoff = JSON.parse(Read(handoff_path))
-  
-  if handoff.user_prose:
-    print handoff.user_prose to user
-
-  if handoff.status == "done":
-    halt — done
-  
-  if handoff.status == "error":
-    halt — show error
-  
-  if handoff.status == "ask_user":
-    questions = JSON.parse(Read(handoff.questions_file))
-    answers = AskUserQuestion({ questions: questions.questions })
-    answers_file = "<run_dir>/checkpoints/<handoff.checkpoint_id>.answers.json"
-    Write(answers_file, JSON.stringify({checkpoint_id: handoff.checkpoint_id, answers}))
-    
-    prompt = "continue checkpoint:" + handoff.checkpoint_id + " — answers at " + answers_file
-    # next loop iteration re-spawns master
-  
-  else:
-    error — unknown status
-```
-
-### Step-by-step launcher 행동 (spawn 사이마다)
-
-1. **Spawn master** with current prompt (initial: task + ref; subsequent: "continue checkpoint:X").
-2. After Agent return, read `<run_dir>/.handoff.json`. 없으면 master 응답을 사용자에게 relay하고 종료.
-3. handoff.user_prose가 있으면 사용자에게 출력 (개행/마크다운 그대로).
-4. handoff.status에 따라 분기:
-   - `done` → 종료 (user_prose가 최종 메시지)
-   - `error` → 종료 + 사용자 알림
-   - `ask_user` → 4-7번 진행
-5. handoff.questions_file Read.
-6. `AskUserQuestion({ questions: questions.questions })` 호출. 사용자가 picker UI에서 클릭.
-7. answers를 `<run_dir>/checkpoints/<checkpoint_id>.answers.json`에 Write.
-8. master 재spawn — prompt: `"continue checkpoint:<checkpoint_id> — answers at <answers_file>"`.
-9. 1번으로 돌아감 (spawn_count cap = 12).
-
-### Safety cap
-
-한 번의 `/omd-harness` 호출에 최대 12 spawn (Phase 1 round1+2, Asset checkpoint #0, ckpt#1, ckpt#2, ckpt#3, 잠재적 iteration × 2까지 여유). 초과 시 사용자에게 escalate ("master가 12 spawn 초과, 멈춥니다 — run dir 보존").
-
-### 재진입 (사용자가 다음 turn에 무언가 답했을 때)
-
-`/omd-harness` 다음 호출 시 (또는 사용자가 자연어로 "go" / "fix X" 답하면), 위 동일 loop 재시작. master는 .handoff.json 보고 어디까지 갔는지 파악.
-
-## 사용자 체크포인트 처리
-
-Master가 checkpoint에서 turn을 종료하면, 다음 사용자 메시지가 오면:
-
-- 사용자 메시지가 **하네스 컨텍스트 안의 응답**이면 (예: "go", "fix the home screen IA", "stop") → master를 다시 spawn하고 그대로 전달.
-- **다른 작업으로 바뀐 메시지**면 → 하네스를 일시 중단 (run dir에 `paused.flag` 생성). 사용자가 나중에 `/omd-harness resume` 하면 재개.
-
-## 산출물 위치 (master가 emit, 이 스킬은 안내만)
-
-```
-.omd/runs/run-<ts>-<slug>/
-├── task.md
-├── brief.md
-├── references-cited.md
-├── journey.mmd
-├── wireframes/
-├── DESIGN.md.patch
-├── components/
-│   ├── manifest.json
-│   └── microcopy.json
-├── assets/
-│   ├── brief.md
-│   ├── manifest.json
-│   ├── briefs/         # user self-fill
-│   ├── fallback/       # downloaded
-│   └── pinterest-refs/ # url listings
-├── eval/
-│   ├── deterministic.json
-│   ├── jury.json
-│   └── screenshots/
-├── persona-feedback/
-│   └── <persona>.json
-├── critique.md         # iteration > 1일 때
-├── handoff/
-│   ├── v0.zip
-│   ├── cursor.zip
-│   └── subframe.zip
-├── run.log
-└── postmortem.md
-```
-
-## 이 스킬이 *하지 않는* 것
-
-- Phase 로직 실행 (master가 함)
-- Sub-agent 직접 spawn (master가 함)
-- 사용자 응답 해석/라우팅 (master가 함)
-- DESIGN.md 직접 수정 (Phase 5에서 master가 함)
-
-이 스킬의 책임 = **launcher + 사전체크 + 안내**, 그 이상은 절대 X.
-
-## 금지
-
-- Master 없이 phase를 직접 수행하지 말 것.
-- 사용자 체크포인트를 자동 승인하지 말 것 (master의 응답에 사용자가 직접 답해야 함).
-- Run 디렉토리를 임의로 정리/삭제하지 말 것.

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

@@ -1,169 +0,0 @@
-<!-- omd:installed-skill — managed by `omd install-skills`. Do not edit; rerun the command to refresh. -->
-
----
-name: omd:init
-description: "프로젝트 루트에 DESIGN.md를 생성합니다. 사용자가 프로젝트를 묘사하면 67개 레퍼런스 중 가장 잘 맞는 것을 추천하고, 사용자가 고른 레퍼런스의 톤&매너를 preserve하면서 프로젝트 맥락 delta만 반영한 variation을 생성합니다. '디자인 시스템 만들어줘', 'DESIGN.md 세팅', 'brand 초기화', 'omd init' 같은 요청에 트리거됩니다. CLAUDE.md / AGENTS.md / Cursor rule shim도 함께 설치."
----
-
-# omd:init — DESIGN.md Bootstrap
-
-프로젝트에 DESIGN.md + 4개 AI 코딩 에이전트용 shim을 한 번에 세팅한다. 레퍼런스 톤&매너는 **preserve**하고, 사용자 프로젝트 맥락은 controlled-vocabulary delta_set으로만 반영.
-
-## 전체 플로우
-
-```
-Phase 1: 사용자 맥락 파악 (1-2 질문)
-Phase 2: 레퍼런스 추천 (omd init recommend)
-Phase 3: 사용자가 1개 선택
-Phase 4: omd init prepare — context + delta_set 준비
-Phase 5: Hybrid variation으로 DESIGN.md 생성 (이 스킬의 핵심)
-Phase 6: omd sync --force로 shim 3종 설치
-Phase 7: 요약 출력
-```
-
-## Phase 1 — 맥락 파악
-
-사용자가 이미 충분한 description을 줬으면 skip. 부족하면 **최대 2개** 질문:
-
-1. 프로젝트 유형/도메인 (SaaS / 랜딩 / 대시보드 / 이커머스 / 커뮤니티 등)
-2. 분위기 키워드 (warm, minimal, premium, playful, dense, airy 등) — controlled vocab 참조 유도
-
-여러 질문을 한꺼번에 쌓지 말 것. 한 번에 하나씩, 또는 통합해서 한 번에.
-
-## Phase 2 — 레퍼런스 추천
-
-Bash:
-```bash
-omd init recommend "<사용자 description 전체>" --json
-```
-
-JSON 출력에서:
-- `recommendations` — top 5 references (id, category, score, matchedKeywords)
-- `delta_set` — description에서 추출된 controlled vocab 기반 축 이동
-- `delta_set.warnings` — conflict (e.g. "formal ↔ playful")
-- `delta_set.matchedKeywords` — 실제 매칭된 vocabulary 키워드
-
-사용자에게 제시할 때:
-- 5개 레퍼런스를 번호 + 한 줄 설명으로 나열 (description에 매칭된 keyword 1-2개 강조)
-- warnings 있으면 먼저 알린다: "formal과 playful이 충돌해요. 'primarily playful'처럼 한쪽을 우선시하면 변형에 더 잘 반영됩니다."
-
-## Phase 3 — 레퍼런스 선택
-
-사용자가 레퍼런스를 고르면 Phase 4로. `omd init recommend`의 출력에 없는 레퍼런스를 요청하면 그대로 사용 (e.g. "stripe로 해줘").
-
-## Phase 4 — Prepare
-
-```bash
-omd init prepare --ref <id> --description "<원본 description>" --json
-```
-
-이게 하는 일:
-- `references/<id>/DESIGN.md` 경로 확정 (JSON에 `reference_md` 필드로 전체 내용 포함)
-- 기존 `DESIGN.md`가 있으면 → `DESIGN_DEPRECATED.md`로 rename (메타 헤더 자동 삽입)
-- `.omd/init-context.json` 작성 (`delta_set`, `description` 담김)
-
-JSON 출력의 `reference_md`는 variation의 input이다. Read.
-
-## Phase 4.5 — Philosophy Layer 입력 수집 (CRITICAL)
-
-§11 (Brand Narrative), §12 (Principles), §13 (Personas)는 **레퍼런스의 검증된 historical facts에 기반**한다 — 창립년도, founder 이름, verbatim 인용, 공식 tagline 등. 이걸 단순 domain swap하면 **사용자 프로젝트에 거짓 brand claim을 ship**하는 사고가 난다.
-
-따라서 Phase 5B 진입 전에 사용자에게 다음 정보를 묻는다 (한 번에):
-
-```
-DESIGN.md의 §11-13 (Brand Narrative / Principles / Personas)에는 사실 정보가 들어갑니다. 다음을 알려주시거나 "skip"이라고 답해주세요:
-
-1. 프로젝트 이름 / 창립 시점 (대략)
-2. 핵심 thesis 한 문장 (e.g. Airbnb의 "Belong Anywhere")
-3. 공식 tagline 또는 거부하는 카테고리 default (e.g. "혼밥 시대의 가족 식사")
-4. 타겟 사용자 segment 2-4개 (e.g. "맞벌이 부부", "Chef Partner", "재구매 가족")
-
-답변 받으면 → Phase 5B에서 §11-13에 반영
-"skip" → §11-13은 [FILL IN: ...] placeholder + omd:limitation 코멘트로 처리
-```
-
-사용자가 부분 답변(예: 1만, 4만)을 주면 받은 부분만 사용하고 나머지는 skip 처리.
-
-## Phase 5 — Hybrid Variation 생성 (핵심)
-
-`.omd/init-context.json`의 `delta_set`과 Phase 4 JSON의 `reference_md`를 입력으로, **새 DESIGN.md를 작성**한다.
-
-### Phase 5A — Voice Fingerprint 내부 추출 (silent)
-
-출력하지 말 것. 작성 전, 레퍼런스 DESIGN.md에서 다음을 머릿속으로 파악:
-- 평균 문장 길이 밴드 (짧음/중간/긺)
-- 어휘 register (engineering-terse / editorial-warm / clinical / playful 중)
-- 은유 밀도 (없음/희소/빈번)
-- 기술 밀도 (token-heavy / prose-heavy / balanced)
-- 문단 리듬 (list-forward / paragraph-forward)
-
-Phase 5B에서 emit하는 모든 내러티브 문단은 이 fingerprint에 **정확히** 맞춰야 한다.
-
-### Phase 5B — 새 DESIGN.md emit
-
-**엄격 규칙 (위반 = regression)**:
-
-1. **Section 구조 frozen.** 레퍼런스의 H2/H3 heading을 같은 순서로 그대로. 새 섹션 추가 금지. 삭제 금지. 이름 변경 금지.
-
-2. **Token 값은 `delta_set`가 허가한 것만 변경.** `delta_set.axes`에 없는 토큰은 레퍼런스와 **byte-for-byte 동일**하게. "개선"하지 말 것. 색상 hex는 `delta_set.axes["color.hue_deg"]` / `["color.saturation_pct"]` / `["color.lightness_pct"]` 에 따라 **HSL** 변환으로 shift (도 단위 hue rotation, % 단위 saturation/lightness 가산). 정확한 hex 계산이 필요하면 `omd init prepare --json` 의 출력에 이미 적용된 stub-shifted DESIGN.md를 활용 가능 (단 stub은 narrative를 손대지 않으므로 token-only baseline일 뿐임 — voice 작업은 직접 수행).
-
-3. **내러티브 프로즈는 Phase 5A fingerprint에 매칭.** 도메인 예시를 프로젝트 맥락으로 교체할 때, 레퍼런스의 문장 길이/register/은유 밀도 그대로 유지. Vercel의 "Ship a deploy preview in seconds"를 "Ship a meal plan in seconds"로 바꾸는 건 OK. "Help families discover joyful dinners fast"로 바꾸는 건 voice violation.
-
-4. **Domain swap은 구체 명사만.** 동사 / 형용사 / framing 건드리지 말 것.
-
-5. **새 philosophy 도입 금지.** OmD v0.1 레이어, 없던 원칙을 추가하지 말 것. **Delta-derived 노트(예: "+0.005em casual tracking")도 새 bullet으로 넣지 말 것.** 기존 bullet에 자연스럽게 통합 (e.g. "Negative tracking on headings; light positive tracking on body for casual register").
-
-6. **해결 불가능한 delta는 top-of-file HTML comment로 표시.** `delta_set.axes`가 참조하는 token이 레퍼런스 DESIGN.md에 없으면 `<!-- omd:unresolved: <axis> -->` 상단 추가하고 해당 token은 건드리지 않는다.
-
-7. **Voice hints 반영.** `delta_set.voiceHints`는 Voice 섹션의 내러티브 문장에 반영하되, 레퍼런스 voice의 문장 스타일 안에서만 적용. "contractions ok"를 Voice 섹션의 원칙 bullet에 한 줄 추가하는 식.
-
-8. **§11-13 (Brand Narrative / Principles / Personas) 처리 분기.**
-   - **Phase 4.5에서 사용자가 정보를 제공한 경우**: 그 정보로 §11/12/13 작성. 단 verbatim 인용은 사용자가 직접 준 표현만 인용 부호로 감싸고, 그 외는 일반 prose. 레퍼런스의 시간 표현("In July 2014..."), 공식 인용 등은 모두 사용자 프로젝트 맥락으로 대체.
-   - **Phase 4.5에서 skip한 경우**: §11-13 본문을 `[FILL IN: <섹션 목적 한 줄>]` placeholder로 emit + 각 섹션 상단에 `<!-- omd:limitation Reference §X requires project-specific facts. Replace before shipping; do not fabricate. -->` 코멘트.
-   - **§14 (States), §15 (Motion)**: 일반 Hybrid 적용 (구체 명사만 swap).
-
-### Phase 5C — 파일 작성
-
-Write 툴로 `DESIGN.md`에 emit.
-
-## Phase 6 — Shim 설치
-
-```bash
-omd sync --force
-```
-
-이게 `CLAUDE.md`, `AGENTS.md`, `.cursor/rules/omd-design.mdc`를 생성/갱신하고 `.omd/sync.lock.json`을 업데이트한다.
-
-## Phase 7 — 요약 출력
-
-한 문단으로:
-- Base reference + 프로젝트 context 한 줄 요약
-- 적용된 주요 delta 2-3개 (e.g. "primary hex shifted warm by +12°, radius +4px")
-- 생성된 파일 목록 (DESIGN.md + shims)
-- DESIGN_DEPRECATED.md 있으면 언급
-- 다음 스텝: `omd:apply`로 UI 작업 시작하거나, `/omd:remember`로 선호 추가 로깅
-
-예시:
-```
-✓ DESIGN.md created (based on Airbnb, warm B2C marketplace context)
-  - primary hue shifted +12° (warmer coral)
-  - radius +6px (softer approach)
-  - voice hints: contractions ok, second person
-
-Shim files:
-  ✓ CLAUDE.md
-  ✓ AGENTS.md
-  ✓ .cursor/rules/omd-design.mdc
-
-Next:
-  - Start UI work — the omd:apply skill will inject DESIGN.md automatically
-  - Use `/omd:remember <note>` anytime you want to log a design preference
-```
-
-## 금지
-
-- Phase 5A fingerprint를 출력하지 말 것 (내부 전용).
-- `delta_set.axes`에 없는 token을 마음대로 바꾸지 말 것.
-- 레퍼런스에 없는 section/heading을 추가하지 말 것.
-- `.omd/init-context.json`을 직접 편집하지 말 것 (CLI가 관리).
-- DESIGN.md가 이미 있는데 백업 없이 덮어쓰지 말 것 — `omd init prepare`가 자동 rename하니 스킬이 별도 처리 불필요.