omo

OMO: oh-mark-openagent

Quick Start (English)

# 1. Register the marketplace
/plugin marketplace add https://github.com/speson/omo

# 2. Install the plugin
/plugin install omo

# 3. Restart Claude Code, then run setup wizard
#sw

After setup, try these commands:

Shortcut	What it does
#ulw <goal>	Plan-execute-verify workflow for large tasks
#rl <goal>	Persistent loop that won't stop until done
#bh <symptom>	Hunt down bugs from symptoms
#dr	Multi-perspective code review on current diff
#rr	Map your repository structure
#ss	Show omo status dashboard

See the full User Guide for details.

---

Claude Code를 위한 멀티 에이전트 오케스트레이션 플러그인입니다.

OMO는 결과물의 품질과 속도를 토큰 효율보다 우선합니다. 더 많은 토큰을 소비하더라도 병렬 에이전트 실행, 다각도 검증, 조기 에스컬레이션을 통해 더 좋은 결과를 더 빠르게 제공합니다.

복잡한 개발 작업을 전문 에이전트 팀에게 위임하여 체계적으로 수행할 수 있게 합니다. 작업 기획, 구현, 디버깅, 검증, 코드 리뷰까지 소프트웨어 개발의 전체 흐름을 커버합니다.

opencode와 oh-my-opencode의 편의 기능을 Claude Code 플러그인으로 그대로 이식하여, 동일한 워크플로우를 플러그인 하나로 사용할 수 있습니다.

전체 기능과 유저 플로우에 대한 상세한 설명은 유저 가이드를 참고하세요.

핵심 원칙

• 적극적 병렬화 — 순차 실행 대신 여러 전문가를 동시에 투입합니다.
• 깊은 조사 후 실행 — deepsearch + repo-librarian을 병렬로 돌려 컨텍스트를 충분히 파악한 후 작업합니다.
• 다각도 검증 — diff-review (5관점 병렬 리뷰) + ship-check + test-commander를 함께 사용합니다.
• 조기 에스컬레이션 — 첫 실패 후 바로 oracle을 투입합니다. 3단계 이상의 계획에는 critic을 사용합니다.
• 전문가 우선 — 인라인 분석 대신 전용 에이전트(bug-hunter, security-auditor, perf-analyst)에게 위임합니다.
• 중복 허용 — 두 에이전트가 같은 코드를 다른 관점에서 검토하면, 그것은 낭비가 아니라 신뢰도 향상입니다.

설치 방법

1. 마켓플레이스 등록

/plugin marketplace add https://github.com/speson/omo

2. 플러그인 설치

/plugin install omo

설치 후 Claude Code를 재시작하세요.

스킬 명령어

OMO는 22개의 스킬 명령어를 제공합니다. 각 명령어는 /omo:명령어 형식으로 사용하거나, #단축키 패턴으로 빠르게 실행할 수 있습니다.

단축키 사용법

모든 스킬은 #단축키 패턴을 통한 자동 인터셉트를 지원합니다. Claude Code 채팅창에 #단축키를 입력하면 해당 스킬이 자동으로 실행됩니다. 긴 명령어를 외울 필요 없이 짧은 단축키만으로 동일한 기능을 사용할 수 있습니다.

# 긴 명령어 대신
/omo:ultrawork 사용자 인증 기능 구현

# 단축키로 동일하게 실행
#ulw 사용자 인증 기능 구현

작업 실행

단축키	명령어	설명
#ulw	/omo:ultrawork <목표>	대규모 작업을 기획-실행-검증 3단계로 체계적으로 수행합니다
#rl	/omo:ralph-loop <목표>	작업이 100% 완료될 때까지 멈추지 않는 실행 루프입니다
#sp	/omo:spawn <목표>	독립적인 여러 작업을 병렬로 에이전트에게 분배합니다

작업 관리

단축키	명령어	설명
#kit	/omo:kickoff-task <목표>	인터뷰 형식으로 작업 범위를 정의하고 태스크 노트를 생성합니다
#rw	/omo:resume-work [목표]	중단된 작업의 컨텍스트를 복구하고 이어서 진행합니다
#ho	/omo:handoff [다음단계]	작업 중단 시 인수인계 노트를 작성합니다

코드 품질

단축키	명령어	설명
#dr	/omo:diff-review [범위]	정확성, 보안, 성능, 유지보수성, 범위 5가지 관점에서 코드를 리뷰합니다
#sc	/omo:ship-check [범위]	배포 전 최종 검증을 수행하고 리스크를 평가합니다
#qa	/omo:qa-loop [테스트명령]	테스트 실패 시 자동으로 수정-재실행을 최대 5회 반복합니다

탐색 및 디버깅

단축키	명령어	설명
#rr	/omo:repo-radar [범위]	저장소 구조, 기술 스택, 컨벤션을 매핑합니다
#ds	/omo:deep-search <쿼리>	심볼, 텍스트, 파일, 임포트, git 이력을 병렬 검색합니다
#bh	/omo:bug-hunt <증상>	버그의 원인을 좁혀가며 재현 경로를 찾습니다

배포

단축키	명령어	설명
#rel	/omo:release <버전>	전체 릴리즈 파이프라인 (커밋, 푸시, 태그, GitHub 릴리즈, 마켓플레이스)
#sync	/omo:docs-sync [범위]	README와 유저 가이드를 현재 프로젝트 상태에 맞게 동기화합니다

설정

단축키	명령어	설명
#sw	/omo:setup-wizard [--full]	훅 등록, MCP 설정, 상태 디렉토리를 자동 감지하고 구성합니다
#st	/omo:self-test	플러그인 구조와 버전 무결성을 검증합니다

모니터링

단축키	명령어	설명
#ss	/omo:status	boulder, ralph-loop, 작업, 팀 상태를 통합 대시보드로 보여줍니다

분석 및 감사

단축키	명령어	설명
#re	/omo:retro	ultrawork/ralph-loop 후 회고 분석 — 에이전트 사용 패턴, 병목, 개선 제안
#pc	/omo:perf-check [범위]	성능 영향 분석 — O(n²) 패턴, 번들 크기, 무한 데이터 구조 감지
#da	/omo:dep-audit [범위]	의존성 보안 감사 — npm audit/pip-audit + 신규 의존성 교차 검증

마이그레이션 및 리뷰

단축키	명령어	설명
#mg	/omo:migrate <대상>	프레임워크/API/언어 버전 마이그레이션 오케스트레이션
#pr	/omo:pr-review [PR번호]	GitHub PR 전체 리뷰 — diff 분석 + CI 상태 + 다각도 코드 리뷰

사용 예시

# 단축키로 빠르게 실행
#ulw 사용자 인증 기능 구현
#bh 로그인 후 세션이 유지되지 않는 문제
#ds getUserProfile 함수 위치
#dr
#rel 1.7.0

# 전체 명령어로 실행
/omo:ultrawork 결제 모듈 리팩토링
/omo:repo-radar --deep
/omo:qa-loop npm test

전문 에이전트

OMO는 16개의 전문 에이전트를 상황에 맞게 자동으로 배치합니다. 스킬을 실행하면 내부적으로 적절한 에이전트가 투입되므로, 사용자가 직접 에이전트를 호출할 필요는 없습니다.

오케스트레이션

에이전트	기본 모델	역할
atlas	Sonnet	복잡한 멀티 스텝 계획의 총괄 지휘. 팀 기반 조율 지원
planner-sisyphus	Sonnet	인터뷰 방식으로 요구사항을 명확히 하고 실행 가능한 계획을 수립합니다
critic	Opus	실행 계획의 실현 가능성을 검증합니다. 3단계 이상 계획에 자동 투입

구현 및 디버깅