oh-my-design-cli 1.3.9 → 1.5.0

package/skills/omd-final-qa/SKILL.md

@@ -0,0 +1,153 @@
+---
+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/skills/omd-kr-writer/SKILL.md

@@ -0,0 +1,229 @@
+---
+name: omd:kr-writer
+description: "한국어 글쓰기 멀티-preset 스킬. 12개 preset 지원 — toss-tech-design (default) / karrot-neighborly / brunch-maker-popular / naver-d2-engineering / biz-formal-report / academic-paper / journalism-broadsheet / kakao-warm-product / line-global-saas / academic-lecture-essay / emotional-brand / legal-disclosure. '한글 글 작성', 'KR rewrite', '토스 톤으로', '당근 톤으로', '브런치 톤으로', '보고서로 써줘', '학술 톤', '신문기사체' 류 트리거."
+user-invocable: true
+---
+
+# omd:kr-writer
+
+oh-my-design의 한국어 본문 작성 스킬. **preset_id 인자**로 6개 voice 중 선택.
+
+## 0. preset_id 인자
+
+호출 envelope:
+
+```yaml
+agent: omd-kr-writer
+inputs:
+  preset_id: toss-tech-design  # 또는 아래 6개
+  task: "당근 디자인 분석 글 작성"
+  ...
+```
+
+지원 preset 12개. **자세한 9-field spec + verbatim 한국어 examples**: `data/research/2026-05-18-kr-style-presets.md`
+
+| # | preset_id | 종결 | 분량 (한글) | 용도 |
+|---|---|---|---|---|
+| 1 | `toss-tech-design` ⭐ (default) | 해요체 -요 | 5,500~7,000자 | omd 블로그 본문, 디자인 deep-dive |
+| 2 | `karrot-neighborly` | 해요체 + 동네 lexicon | 3,000~5,000자 | 마케팅, 커뮤니티 글 |
+| 3 | `brunch-maker-popular` | 해요체 80% + 회상 `-했다` | 4,000~6,000자 | 회고, 포스트모템, 메이커 에세이 |
+| 4 | `naver-d2-engineering` | 해요체 + 격식 mix | 자유 | 엔지니어링 분석 글 |
+| 5 | `biz-formal-report` | 하십시오체 -습니다 | 자유 | 보고서·기획서·BRD |
+| 6 | `academic-paper` | 해라체 `-한다`/`-이다` | 자유 | 학술 논문, 연구 노트 |
+| 7 | `journalism-broadsheet` | 해라체 `-다`/`-했다` | 자유 | 보도자료, 신문기사 |
+| 8 | `kakao-warm-product` | 해요체 + 감정 표현 | 자유 | 카카오톡·카카오뱅크 in-app copy |
+| 9 | `line-global-saas` | 해요체 + 다국어 친화 | 자유 | 한일 brand voice, 글로벌 SaaS |
+| 10 | `academic-lecture-essay` | 해요체 + 학술 lexicon | 자유 | 교양 강연, 지식 에세이 |
+| 11 | `emotional-brand` | 해요체 + 외래어 자유 | 자유 | 무신사·29CM 패션 커머스 |
+| 12 | `legal-disclosure` | 하십시오체 + 한자어 | 자유 | 법무·약관·고지사항 |
+
+**호출 시 preset 미지정 → `toss-tech-design` 적용.**
+
+본 문서의 § 1~8은 default preset (`toss-tech-design`)의 상세 spec. 다른 preset 선택 시 research doc의 해당 section 룰로 substitution.
+
+### 전환 매트릭스 (자주 쓰는 6개)
+
+같은 콘텐츠를 다른 preset으로 옮길 때 standard rewrite 룰. 자세한 5-step rule은 research doc §14 참조.
+
+| from | to | 핵심 변환 |
+|---|---|---|
+| `biz-formal-report` | `toss-tech-design` | `-합니다`→`-해요` · 한자어 풀이 · 50자+ 문장 쪼개기 · 3인칭→1인칭 |
+| `toss-tech-design` | `biz-formal-report` | `-요`→`-니다` · 인사 제거 · 섹션 번호 (1.1) · 한자어 회복 |
+| `academic-paper` | `toss-tech-design` | `-한다`→`-해요` · `우리는`→`저는` · 인용 형식 인라인 |
+| `karrot-neighborly` | `toss-tech-design` | "동네" lexicon 제거 · 분석 voice 강화 · 5,500자+ |
+| `journalism-broadsheet` | `toss-tech-design` | `-다`→`-요` · OOO 대표 said → 직접 quote · narrative 1인칭 |
+| `legal-disclosure` | `kakao-warm-product` | 한자어 → 우리말 · 수동 → 능동 · 친근 어휘 보강 |
+
+### 한국어 어말어미 — 6단계 speech level
+
+| 단계 | 격식 | 친근 | 종결예 | preset 매핑 |
+|---|---|---|---|---|
+| 하십시오체 | ✓ | ✗ | -습니다 | biz-formal / legal |
+| 하오체 | ✓ | ✗ | -오, -소 | (구식, 거의 안 씀) |
+| 하게체 | △ | △ | -네, -게 | (구식, 윗사람→아랫사람) |
+| 해라체 | ✗ | ✗ | -다, -한다 | academic / journalism |
+| 해요체 ⭐ | △ | ✓ | -요, -아요 | toss / karrot / kakao / brunch / line / lecture / emotional |
+| 해체 (반말) | ✗ | ✓✓ | -아, -이야 | (사용 안 함 — disrespectful) |
+
+omd 디폴트는 **해요체**. 격식이 필요하면 하십시오체. 학술/뉴스만 해라체. 그 외 모든 경우 해요체.
+
+---
+
+## Default preset (toss-tech-design)
+
+oh-my-design 블로그의 한국어 본문을 **Toss Tech 디자인 카테고리** 수준의 voice로 작성. Brunch와 당근 미디엄도 보조 참고.
+
+## 1. Voice DNA — 한국 디자인 블로그 명문 공통 패턴
+
+### 첫 단락 fingerprint (변형 가능)
+
+```
+안녕하세요. [본인 직무] [본인 이름]이에요.
+저는 [구체적인 업무]를 담당하고 있어요.
+[배경 1-2 문장 — 어떤 상황에서 어떤 미션을 받았는지].
+오늘은 [주제]를 나눠보려고 해요.
+```
+
+oh-my-design용 변형:
+```
+안녕하세요. oh-my-design을 만드는 [이름]이에요.
+107개 브랜드의 디자인 시스템을 라이브로 캡쳐해서 카탈로그로 모으고 있어요.
+오늘은 그 중 [브랜드]를 들여다본 이야기를 나누려고 해요.
+```
+
+### 종결 어미 룰
+
+| 사용 | 빈도 |
+|---|---|
+| `-요` | **100%** (default) |
+| `-했어요`, `-있어요`, `-거예요`, `-네요` | 자주 |
+| `-아요`, `-이에요` | 자주 |
+| `-습니다`, `-는다`, `-한다` | **금지** (관공서 톤) |
+| `-입니다`, `-합니다` | **금지** |
+
+### 문장 호흡
+
+- **평균 35~50자/문장**. 80자+ 문장 = 쪼개기.
+- 두 문장 연결: `~했고, ~했어요.` → 가급적 `~했어요. ~했어요.` 두 문장으로.
+- 접속사 `그리고`/`그래서`/`그런데` 남발 금지. 단락 이행은 새 단락으로.
+- 감탄/조사 `~네요`, `~죠`, `~인가요?` 적절히 — 글이 살아남.
+
+### 단락 길이
+
+- **평균 3~5 문장 / 단락**. 80자+ 단락 = 쪼개기.
+- 한 줄 단락 OK — 강조용.
+- 글 전체에서 80% 이상이 짧은 단락.
+
+### 첫 인사 + 마지막 인사
+
+```
+시작: "안녕하세요. ~이에요."
+마무리: 
+  - "여기까지 [주제]에 대해 나눠봤어요."
+  - "혹시 [관련 질문]이 있다면 댓글로 남겨주세요."
+  - "다음 글에서는 [다음 주제]를 들고 올게요."
+```
+
+## 2. 구조 템플릿 — 디자인 시스템 분석 글
+
+### 한국어 H2 헤더 패턴
+
+영문 식 `## Insight 1 — OKLCH-based perceptual color scaling` 같은 무거운 헤더는 금지. 한국어는 **짧고 호흡감 있게**.
+
+| 영문 패턴 | 한국어 변환 |
+|---|---|
+| `## 1. A short history of "the Toss feel"` | `## 토스 느낌의 시작` |
+| `## 2. The atmosphere — calm, confident, deceptively simple` | `## 화면을 열면 흰 캔버스` |
+| `## 3. Insight 1 — OKLCH-based perceptual color scaling` | `## 토스는 색을 수학으로 정의해요` |
+| `## 4. What to steal` | `## 가져가도 좋은 것` |
+| `## 5. What NOT to steal` | `## 따라하면 안 되는 것` |
+
+원칙: 헤더는 **3~12자**. 문장형 OK, 호기심 유발 OK, 결론 spoiler OK.
+
+### 권장 글 구조 (5,500자+ 목표)
+
+1. **인사 + 글 소개** (~300자) — 안녕하세요 인사 + 오늘 분석할 브랜드 소개 + 어떻게 분석했는지
+2. **브랜드 배경** (~600자) — 회사 역사 짧게, 디자인이 왜 지금처럼 됐는지
+3. **첫 인상 — 화면을 열면** (~700자) — 시각 톤, 색, 타입, 첫 느낌
+4. **인사이트 1** (~700자) — 발견 1개, 왜 중요한지, 어떻게 따라할지
+5. **인사이트 2** (~700자)
+6. **인사이트 3** (~700자)
+7. **인사이트 4** (~700자)
+8. **인사이트 5** (~600자) — 더 짧아도 OK
+9. **가져가도 좋은 것** (~400자) — 5개 정리 (불릿 OK)
+10. **따라하면 안 되는 것** (~400자) — 5개 정리
+11. **마무리 + CTA** (~200자) — MCP 설치, design-system 페이지 링크
+
+목표: **5,500자~7,000자** (한국어, 공백 제외).
+
+## 3. 이미지/figure 정책
+
+Toss 글은 단락 2~3개 당 이미지 1개. oh-my-design 본문에서:
+
+- **헤로 이미지**: 글 첫머리, 브랜드 색감 + 타이포 한 컷
+- **인사이트 1~5 각**: 1~2개 이미지 (스크린샷 / 다이어그램 / 컬러 그리드)
+- **figcaption 짧게**: "토스 송금 화면" / "OKLCH 컬러 그리드" / "토스 vs KB의 헤로 비교"
+- **alt 텍스트는 단순한 설명만** — figcaption과 다른 정보
+
+이미지가 부족한 경우:
+- 라이브 캡쳐 (browser-harness로 brand site 스크린샷)
+- CSS 비주얼 컴포넌트 (ColorSwatchGrid, TypeSample 등)
+- 다이어그램 (인라인 SVG, primitive → semantic → component 같은 토큰 트리)
+
+## 4. 인사이트 본문 패턴
+
+각 인사이트는 다음 4 단락 구조 권장:
+
+1. **현상 단락**: "토스를 열면 이상한 게 있어요. ~" — 호기심 hook
+2. **데이터 단락**: "실제로 CSS 번들을 뜯어보니, ~ 81번 등장하더라구요." — 숫자/증거
+3. **이유 단락**: "왜 이렇게 했을까요? ~" — 디자인 thesis
+4. **적용 단락**: "여러분 작업에 가져가려면, ~" — actionable
+
+## 5. 안티패턴 (절대 금지)
+
+- ❌ `-습니다`, `-한다`, `-할 것이다` 등 격식체
+- ❌ `~할 수 있다` 식 가능형 남발 → `~할 수 있어요`
+- ❌ 영어를 한글로 번역만 한 듯한 문장 (`이것은 우리가 만든 시스템이다` — X. `우리가 만든 시스템이에요.` — O)
+- ❌ 영문 인용 부호 그대로 (`"trust comes from clarity"`) → `"신뢰는 깊이가 아니라 명확함에서 온다"` (한글 번역 + 영문 옆에 작게)
+- ❌ 머리말 `## 1. 인사이트 1 — Insight 1: OKLCH-based ~` 식 형식적 헤더
+- ❌ 마지막에 "감사합니다." 한 줄 → 톤 깨짐. 차라리 안 쓰기.
+- ❌ 문단 사이를 `**굵게**` 강조로 도배 — 시각 노이즈
+- ❌ 5,000자 미만 분량 (5분 안 채워짐)
+
+## 6. 어휘 가이드
+
+| 어색한 한자어 | 친근한 한국어 |
+|---|---|
+| 사용자 | 쓰는 사람 / 사용자 (case-by-case, 사용자도 OK) |
+| 설계하다 | 설계하다 / 만들다 |
+| 적용하다 | 적용하다 / 쓰다 |
+| 결과적으로 | 결국 / 그렇게 |
+| 비교했을 때 | 비교하면 |
+| ~에 의하면 | ~에 따르면 |
+| 또한 | 그리고 / 또 |
+| 따라서 | 그래서 |
+| 본인 | 본인 / 자신 / 나 |
+| 일반적으로 | 보통 |
+
+## 7. 실행 절차
+
+1. 영문 원문 본문을 가져옴 (`content/posts/<slug>/index.md`의 EN 부분)
+2. 각 H2 섹션을 한 번에 1개씩 KR로 옮김
+3. 첫 단락에 "안녕하세요 ~" intro 삽입
+4. H2 헤더를 짧은 한국어로 다시 작성
+5. 종결어미 100% `-요`로 통일
+6. figure placeholder `![설명](./images/...png "figcaption")` 삽입 — 인사이트당 1~2개
+7. 마지막에 "여기까지 ~ 나눠봤어요" 마무리
+8. 글 끝에 frontmatter의 `title_ko`, `subtitle_ko` 필드 채움
+
+## 8. Quality bar
+
+- 분량: 5,500자~7,000자 (공백 제외, 한국어 본문)
+- 종결어미 `-습니다` / `-한다` 검사 = 0건
+- 인사이트당 평균 ≥ 2 figure placeholder
+- 첫 단락 "안녕하세요" 인사 포함
+- 가져가도 좋은 것 / 따라하면 안 되는 것 = 각 5개
+
+---
+
+이 스킬은 oh-my-design 블로그 한국어 본문의 **단일 source of truth voice guide**. 모든 KR 글은 이 guide를 따른다.

package/skills/omd-locale-adapter/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: omd:locale-adapter
+description: "한국어 본문을 EN/JP/ZH-TW로 **번역이 아닌 adaptation**. 문화 레퍼런스 swap, JP honorific 정합, ZH-TW 번체 idiom. KR은 항상 source of truth. '다국어 적용', 'EN 버전 만들어줘', 'JP로 옮겨줘' 류 트리거."
+user-invocable: true
+---
+
+# omd:locale-adapter
+
+KR 본문을 받아 EN/JP/ZH-TW로 **adapt**한다. 직역이 아니라 각 문화의 디자인 블로그 voice로 다시 쓴다.
+
+참조: Frontitude brand-voice translation model, LINE localization playbook.
+
+## 0. Source of truth
+
+**KR이 canonical**. EN/JP/ZH-TW는 derivative. KR이 갱신되면 다른 locale도 무효화.
+
+## 1. 대상 locale별 룰
+
+### 1.1 EN (en)
+
+- Voice baseline: Stripe Press / Linear changelog / Vercel blog
+- 문장 길이: 15~25 words (KR 35~50자 ≈ EN 15~25 words)
+- 1인칭: "we" or "I" 자연스럽게
+- 문화 swap:
+  - "토스" → "Toss (Korea's leading fintech)" (첫 출현만)
+  - "당근" → "Karrot (a hyperlocal Korean marketplace)"
+  - 김치/돌잔치 등 강한 KR-only ref → 영미권 equivalent or 짧은 gloss
+  - "안녕하세요" 인사 → "Hi, I'm [name]." 또는 informal opener
+- 분량: KR 자수의 0.45~0.55 (영어가 짧음)
+- 헤더: KR 짧은 헤더 → EN은 좀 더 descriptive OK ("토스 느낌의 시작" → "What gives Toss its 'feel'")
+
+### 1.2 JP (ja)
+
+- Voice baseline: note.com デザイン カテゴリ, クックパッド開発者ブログ
+- 종결: です・ます 일관 (敬体)
+- 격식 register: 영미보다 한 단계 더 정중
+- 문화 swap:
+  - "토스" → "Toss (韓国最大級のフィンテック)"
+  - 한국 특유의 이웃문화 ref → 일본식 「ご近所」 비유
+  - 존경어/겸양어 자연스럽게 ("저는 ~한다고 생각해요" → "私は〜と考えています")
+- 분량: KR 자수의 0.85~1.0
+- 헤더: 한국어 짧은 헤더와 비슷한 호흡 ("토스 느낌の始まり")
+- 한자: 常用漢字 위주. 어려운 한자는 仮名 병기.
+
+### 1.3 ZH-TW (zh-tw)
+
+- Voice baseline: 數位時代, INSIDE 硬塞網
+- **번체** (簡体 금지). 「設計」「顯示」「優化」.
+- 문화 swap:
+  - "토스" → "Toss (南韓金融科技龍頭)"
+  - "당근" → "Karrot (南韓地區型二手交易平台)"
+  - 한국 idiom → 中華圈 idiom (가능한 경우)
+- 분량: KR 자수의 0.6~0.75
+- 인용부호: 「」 사용
+- 헤더: KR 짧은 헤더와 비슷한 호흡 (「Toss 給人的感覺，從何而來」)
+
+## 2. Adaptation 7단계 절차
+
+1. KR canonical 본문 + 출간된 frontmatter 읽기
+2. 글 전체 thesis 한 줄로 추출 (locale 다 동일해야 함)
+3. 각 H2 섹션을 1개씩 옮김 — **문장 단위 직역 금지**, 단락 단위 의역
+4. 문화 ref 발견 시 위 swap 룰 적용 + 첫 출현에 gloss
+5. 인용/코드/URL/figure src는 그대로 보존
+6. 헤더 number 일관성 유지 (KR=5 H2면 다른 locale도 5)
+7. frontmatter `title_<locale>`, `subtitle_<locale>` 채우기
+
+## 3. 보존 (절대 변경 금지)
+
+- 코드 블록 내부 (변수명, 함수명, 주석 영문 유지)
+- URL, 파일 경로
+- 사람 이름 / 회사명 (단, 첫 출현에 gloss는 OK)
+- figure src
+- frontmatter slug
+- 수치 / 통계
+
+## 4. 비전형 케이스
+
+| 원문 | 대응 |
+|---|---|
+| KR 특유의 이모지 사용 패턴 (`ㅎㅎ`, `^^`) | EN/JP/ZH-TW에서 제거. 톤은 다른 방식으로 표현. |
+| 한자어 농담 | locale 등가 농담 없으면 그냥 의미만 유지하고 농담 톤 표시 |
+| `안녕하세요` 같은 의례 인사 | EN은 informal greeting, JP는 「こんにちは」, ZH-TW는 「大家好」 |
+| Toss/당근 같은 회사명 인지도 차이 | 첫 등장에서 1줄 gloss, 이후 그대로 |
+
+## 5. 출력 형식
+
+```
+content/posts/<slug>/index.ko.md    ← source
+content/posts/<slug>/index.en.md    ← this skill 생성
+content/posts/<slug>/index.ja.md
+content/posts/<slug>/index.zh-tw.md
+```
+
+각 파일 frontmatter에:
+```yaml
+locale: en
+source_locale: ko
+source_revision: <git sha of ko at time of adaptation>
+adapted_at: <ISO date>
+```
+
+## 6. 품질 체크 (self-audit)
+
+각 locale 생성 후 writer가 직접 검증:
+- H2 카운트가 KR과 일치
+- 인용 / 통계 누락 0건
+- figure src 경로 일치
+- 분량이 위 1.x의 비율 범위
+- 첫 출현 회사명 모두 gloss 처리됨
+- 코드 블록 변경 0건
+
+미달 시 동일 locale 재작성 (orchestrator round 카운터 증가).
+
+## 7. KR 갱신 시 staleness
+
+KR이 수정되면 EN/JP/ZH-TW의 `source_revision`이 outdated. orchestrator가 다시 호출. 부분 갱신 가능 (수정된 H2 섹션만 re-adapt).
+
+## 8. Anti-patterns
+
+- ❌ Google Translate 톤 — 직역 흔적
+- ❌ KR-only ref를 그대로 둠 (예: "강남에서 일하는데" → 영어판에 그대로)
+- ❌ 분량 mismatch (EN이 KR과 같은 자수)
+- ❌ 헤더 number 불일치
+- ❌ KR 없이 EN을 먼저 작성 (KR=canonical 원칙 위배)

package/skills/omd-orchestrator/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: omd:orchestrator
+description: "멀티 에이전트 디자인 워크플로우 supervisor. omd-kr-writer, omd-locale-adapter, omd-designer-review, omd-final-qa, omd-codex-image를 routing. 2-round revision cap 유지. 블로그/컴포넌트/아티클 등 multi-role 작업에 트리거 ('블로그 글 작성', 'KR+EN 동시 발행', '디자인 리뷰 받고 다듬어줘')."
+user-invocable: true
+---
+
+# omd:orchestrator
+
+omd v0.2 agent layer의 **supervisor**. 한 글/한 컴포넌트가 여러 specialist를 거쳐야 할 때 routing을 책임진다.
+
+채택 패턴: **Anthropic orchestrator-workers** (Building effective agents, 2024-12) + **LangGraph supervisor**의 revision-cap. 자세한 비교는 `data/research/2026-05-18-agent-landscape.md` §1.
+
+> 런타임 dependency 없음. Claude Code의 subagent 호출 메커니즘이 그대로 orchestrator-workers 토폴로지를 구현한다.
+
+## 0. Worker 카탈로그
+
+| 역할 | subagent | 용도 |
+|---|---|---|
+| Writer | `omd-kr-writer` | 한국어 본문 작성. `preset_id` 인자로 voice 결정. |
+| Localizer | `omd-locale-adapter` | KR → EN/JP/ZH-TW **adaptation** (번역 아님) |
+| Visual reviewer | `omd-designer-review` | DESIGN.md 대비 typo/색/spacing/state 검수 |
+| Critic | `omd-final-qa` | Read-only rubric verdict. 2-round cap 강제. |
+| Image materializer | `omd-codex-image` | `<!-- omd:gen-image -->` 블록을 채널별로 실체화 (Codex native gen / asset-curator fallback / OpenCode user-queue) |
+
+## 1. 입력
+
+사용자 요청. 예:
+- "당근 디자인 시스템 분석 글 작성, KR + EN, 5500자+"
+- "이 컴포넌트 디자인 리뷰 받고 카피 다듬어줘"
+- "이 글 final QA 거쳐서 출간 ready로"
+
+## 2. Routing decision tree
+
+```
+사용자 요청 도착
+├─ "글 작성" 키워드 → Stage 1: omd-kr-writer
+├─ 다국어 요청 ("EN", "영문", "JP") → Stage 3 추가
+├─ artifact 첨부 + "리뷰" → Stage 2부터 진입
+└─ "출간 ready" → Stage 4 final-qa로 직행
+```
+
+## 3. 표준 5-stage 워크플로우 (블로그 글 기준)
+
+```
+Stage 1  WRITE       omd-kr-writer  (preset=toss-tech-design)
+Stage 2  REVIEW      omd-designer-review  (artifact + brand DESIGN.md)
+Stage 2r REVISION    omd-kr-writer  (review feedback 반영)  ← max 2 round
+Stage 3  LOCALIZE    omd-locale-adapter  (KR → EN/JP)
+Stage 4  CRITIC      omd-final-qa  (rubric, read-only)
+Stage 4r REVISION    omd-kr-writer  (final-qa feedback)  ← max 2 round (Stage 2와 별도 카운트)
+Stage 4i IMAGES      omd-codex-image  (`<!-- omd:gen-image -->` 블록 처리, 채널별 분기)
+Stage 5  HANDOFF     사용자에게 최종 artifact + revision log + image manifest
+```
+
+## 4. Revision cap (hard)
+
+각 critic gate (designer-review, final-qa)는 **최대 2 round**.
+
+```
+revision_state = {
+  "designer_review": { "round": 0, "max": 2 },
+  "final_qa":        { "round": 0, "max": 2 }
+}
+```
+
+Round 2 후에도 BLOCK이면:
+1. 사용자에게 escalate ("designer-review가 2회 fail. 강제 통과? 재작성? 폐기?")
+2. 강제 통과 시 known issues 섹션을 artifact frontmatter에 명시
+3. 재작성 시 Stage 1로 회귀, 카운터 리셋
+
+## 5. Handoff 로그 (필수)
+
+각 stage 전후로 `<work_dir>/.orchestrator.log`에 append:
+
+```
+[2026-05-18T10:23:11] STAGE=write  agent=omd-kr-writer  status=ok  artifact=content/posts/karrot/index.ko.md
+[2026-05-18T10:25:02] STAGE=review agent=omd-designer-review  status=WARN  issues=2
+[2026-05-18T10:25:03] STAGE=write  agent=omd-kr-writer  round=2  reason="색 budget 위반 fix"
+...
+```
+
+## 6. State 직렬화
+
+Orchestrator 자체는 stateless. 모든 state는 파일 시스템:
+- artifact: `content/posts/<slug>/index.<locale>.md`
+- review reports: `content/posts/<slug>/.reviews/round-<N>.md`
+- final verdict: `content/posts/<slug>/.reviews/final-qa.md`
+
+## 7. Subagent 호출 규약
+
+Claude Code subagent 호출 시 다음 envelope:
+
+```yaml
+agent: omd-kr-writer
+inputs:
+  task: "당근 디자인 분석 글 작성"
+  preset_id: toss-tech-design
+  brand_design_md: references/karrot/DESIGN.md
+  target_length: 6000
+  output_path: content/posts/karrot/index.ko.md
+revision_round: 0
+prior_review: null  # 또는 review report 경로
+```
+
+응답을 받으면 `.orchestrator.log`에 기록 후 다음 stage 결정.
+
+## 8. Anti-patterns (금지)
+
+- **3+ round revision loop** — cost runaway. Round 2에서 escalate.
+- **Critic의 직접 수정** — final-qa는 read-only. Writer로 round-trip해야.
+- **Stage skip** — designer-review 없이 final-qa 진입 금지 (rubric 불충분).
+- **병렬 stage 같은 artifact 수정** — race condition. writer/locale-adapter는 직렬.
+- **rubber-stamp** — final-qa가 "looks good" 응답 시 orchestrator는 rejected로 처리.
+
+## 9. 병렬화 허용 케이스
+
+- KR이 PASS된 뒤 EN/JP/ZH-TW **localization은 병렬** (각각 다른 파일이라 conflict 없음)
+- DESIGN.md re-read는 stage마다 강제 (Anthropic best practice — memory hallucination 방지)
+
+## 10. 종료 조건
+
+- final-qa verdict = PASS → handoff stage로
+- final-qa round 2 BLOCK → 사용자 escalation
+- 사용자가 명시적으로 abort → `.orchestrator.log`에 ABORT 기록 후 종료

package/web/references/29cm/DESIGN.md

@@ -1,6 +1,15 @@
 ---
-omd: 0.1
-brand: 29CM
+id: "29cm"
+name: "29CM"
+country: KR
+category: ecommerce
+homepage: "https://www.29cm.co.kr"
+primary_color: "#000000"
+logo:
+  type: favicon
+  slug: "https://asset.29cm.co.kr/icon/apple-icon-144x144.png"
+verified: "2026-05-15"
+omd: "0.1"
 ---
 
 # Design System Inspiration of 29CM

package/web/references/ably/DESIGN.md

@@ -1,6 +1,16 @@
 ---
-omd: 0.1
-brand: Ably (에이블리)
+id: ably
+name: Ably
+display_name_kr: Ably (에이블리)
+country: KR
+category: ecommerce
+homepage: "https://m.a-bly.com"
+primary_color: "#fa2e5f"
+logo:
+  type: favicon
+  slug: "https://www.google.com/s2/favicons?domain=a-bly.com&sz=128"
+verified: "2026-05-15"
+omd: "0.1"
 ---
 
 # Design System Inspiration of Ably (에이블리)