원클릭으로 Manus에서 모든 스킬 실행

omd-orchestrator

스타334

포크29

업데이트2026년 5월 26일 07:22

멀티 에이전트 디자인 워크플로우 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 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

kwakseongjae

kwakseongjae/oh-my-design

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

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이면:

사용자에게 escalate ("designer-review가 2회 fail. 강제 통과? 재작성? 폐기?")
강제 통과 시 known issues 섹션을 artifact frontmatter에 명시
재작성 시 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:

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 기록 후 종료

이 저장소의 다른 Skills

같은 저장소

omd-add-reference

kwakseongjae/oh-my-design

URL 또는 brand id 입력 → 3-tier 검증 파이프라인(Tier 1 라이브 + Tier 2 getdesign/refero + Tier 3 reconcile)으로 references/<id>/DESIGN.md를 신규 생성(CREATE)하거나 기존 섹션을 검증·갱신(UPDATE). '레퍼런스 추가/수정', 'X DS 검증', 'X 컴포넌트 다시 뽑아줘' 류에 트리거.

2026-07-14334

omd-add-reference

kwakseongjae/oh-my-design

2026-07-14334

omd-migrate

kwakseongjae/oh-my-design

단일 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' 류에 트리거.

2026-07-14334

omd-reference-capture

kwakseongjae/oh-my-design

선택된 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 책임).

2026-07-14334

omd-feel

kwakseongjae/oh-my-design

디자인·프론트 업계가 '감'으로 쓰던 인터페이스 디테일을 수치화한 규칙으로 적용(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)가 우선.

2026-06-23334

omd-harness

kwakseongjae/oh-my-design

화면 전체나 신규 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.

2026-06-22334

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을 책임진다.

런타임 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이면:

사용자에게 escalate ("designer-review가 2회 fail. 강제 통과? 재작성? 폐기?")
강제 통과 시 known issues 섹션을 artifact frontmatter에 명시
재작성 시 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:

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 기록 후 종료