菜单
멀티 에이전트 디자인 워크플로우 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 동시 발행', '디자인 리뷰 받고 다듬어줘').
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| 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 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 토폴로지를 구현한다.
| 역할 | 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) |
사용자 요청. 예:
사용자 요청 도착
├─ "글 작성" 키워드 → Stage 1: omd-kr-writer
├─ 다국어 요청 ("EN", "영문", "JP") → Stage 3 추가
├─ artifact 첨부 + "리뷰" → Stage 2부터 진입
└─ "출간 ready" → Stage 4 final-qa로 직행
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
각 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이면:
각 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"
...
Orchestrator 자체는 stateless. 모든 state는 파일 시스템:
content/posts/<slug>/index.<locale>.mdcontent/posts/<slug>/.reviews/round-<N>.mdcontent/posts/<slug>/.reviews/final-qa.mdClaude Code subagent 호출 시 다음 envelope:
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 결정.
.orchestrator.log에 ABORT 기록 후 종료URL 또는 brand id 입력 → 3-tier 검증 파이프라인(Tier 1 라이브 + Tier 2 getdesign/refero + Tier 3 reconcile)으로 references/<id>/DESIGN.md를 신규 생성(CREATE)하거나 기존 섹션을 검증·갱신(UPDATE). '레퍼런스 추가/수정', 'X DS 검증', 'X 컴포넌트 다시 뽑아줘' 류에 트리거.
URL 또는 brand id 입력 → 3-tier 검증 파이프라인(Tier 1 라이브 + Tier 2 getdesign/refero + Tier 3 reconcile)으로 references/<id>/DESIGN.md를 신규 생성(CREATE)하거나 기존 섹션을 검증·갱신(UPDATE). '레퍼런스 추가/수정', 'X DS 검증', 'X 컴포넌트 다시 뽑아줘' 류에 트리거.
단일 brand의 references/<id>/DESIGN.md를 Apple-tier 깊이로 풀 마이그레이션. 9 quality gate 전부 통과 — §4 canonical schema + ≥2 surface live inspect + Tier 2 cross-check + .verification.md conflict matrix + 검증된 §10-15 philosophy + footer + tests + visual smoke. 'X 마이그레이션', 'X apple 깊이로', 'X 풀 검증', 'omd:migrate stripe' 류에 트리거.
선택된 reference brand의 라이브 사이트에서 디자인 컨텍스트(토큰·구조·visual reference)를 캡쳐. brand homepage 패칭, 컴퓨티드 스타일 inspect, 로고/스크린샷을 assets/_reference/<id>/ 로 가져와 attribution.md + LICENSE-NOTE.md와 함께 저장. '뱅크샐러드 에셋 가져와줘', 'X 사이트 패칭', 'X reference 캡쳐', 'X 라이브 스타일 추출', '브랜드 자료 받아와' 류 요청에 트리거. omd:init 직후 또는 omd:harness 중간에 호출 가능. DESIGN.md는 이 스킬이 만들지 않음 (omd:init 책임).
디자인·프론트 업계가 '감'으로 쓰던 인터페이스 디테일을 수치화한 규칙으로 적용(APPLY)하거나 감사(AUDIT)한다. Jakub Krehel의 make-interfaces-feel-better 철학을 계승 + HIG/Material/WCAG/DS 토큰/실무자 리서치로 확장한 17축·113규칙(provenance 등급별). 모션 타이밍·이징·동심원 radius·tabular-nums·44px 타깃·focus ring·prefers-reduced-motion 등. 'feel 좋게 다듬어줘', '인터페이스 디테일 적용', 'feel 점검', '마이크로 인터랙션 손봐줘', 'make this feel better', 'polish the interactions', 「インターフェースの細部を詰めて」, 「介面細節打磨」 류에 트리거. 브랜드 토큰은 DESIGN.md(omd:apply)가 우선.
화면 전체나 신규 surface를 처음부터 디자인할 때의 진입점 — Discovery→Wireframe→Components→Microcopy→Validation 파이프라인을 omd-master 오케스트레이터로 실행. 트리거: '랜딩페이지', '랜딩 페이지', '랜딩 만들어줘', '홈 화면', '첫 화면', '프로토타입', '그럴싸한', '구색 갖춰', 'first screen', 'first impression', 'landing page', 'landing', 'prototype', 'MVP UI', 'home', 'production-ready', 'wireframe to production', '랜딩 처음부터', 'production-ready', '一からデザイン', '從頭設計'. 자연어 발화('그럴싸한 랜딩 만들어줘', 'MVP UI 잡아줘', '프로토타입이라도 구색 갖춰서')에도 자동 트리거. 단일 컴포넌트 수정은 omd:apply.