1. 5개 핵심 에이전트 역할

에이전트 모델 역할 언제 호출
explore haiku 코드베이스 탐색, 심볼/파일 매핑 "어디 있는지 찾아줘"
planner opus 작업 분해, 실행 계획, 리스크 식별 "어떻게 할지 계획 짜줘"
executor sonnet 코드 구현, 리팩터, 기능 작성 "구현해줘"
verifier sonnet 완료 증거, 테스트 통과 확인 "진짜 됐는지 증거 모아줘"
code-reviewer opus 종합 코드 리뷰 "리뷰해줘"

OMC 카탈로그에는 더 많은 전문 에이전트가 있음 (debugger, security-reviewer, build-fixer, designer, test-engineer 등). 5종은 가장 자주 쓰는 핵심 라인.


2. 호출 방식 3가지

방식 A — 슬래시 커맨드 (가장 명시적)

프롬프트 창에 그대로 입력.

/oh-my-claudecode:plan 헥토 PG 환불 플로우 추가
/oh-my-claudecode:deepsearch usePayment 호출 경로
/oh-my-claudecode:code-review
/oh-my-claudecode:security-review
/oh-my-claudecode:build-fix
/oh-my-claudecode:tdd 영수증 캐시 유효성 검증
/oh-my-claudecode:analyze 결제 후 주문 데이터 없음 버그

방식 B — 자연어 위임 (가장 자주 사용)

자연어로 시키면 메인 Claude가 적합한 에이전트로 자동 위임 (Task(subagent_type=...)).

자연어 라우팅
"checkout에서 결제 관련 파일 다 찾아줘" explore
"환불 기능 어떻게 추가할지 계획 짜줘" planner
"이 계획대로 구현해줘" executor
"테스트 통과하는지 증거 모아줘" verifier
"방금 변경사항 리뷰해줘" code-reviewer
"이 에러 원인 추적해줘" debugger
"타입 에러 고쳐줘" build-fixer

방식 C — 워크플로우 스킬 (한 번에 묶어 실행)

/oh-my-claudecode:autopilot   환불 기능 추가     ← 아이디어 → 작동 코드까지 자동
/oh-my-claudecode:team        환불 기능 추가     ← 5개 역할 병렬 협업
/oh-my-claudecode:ralph       환불 기능 완성    ← 검증 통과까지 자가 루프
/oh-my-claudecode:ultrawork   대규모 리팩터     ← 최대 병렬화
/oh-my-claudecode:plan --consensus 설계 안     ← planner+architect+critic 합의 도달까지

3. 표준 5단계 워크플로우

기능 1개를 처음부터 끝까지 돌리는 순서.

1. explore       → 코드 위치/구조 매핑
2. planner       → 옵션 비교, 단계 분해, 리스크
3. executor      → 실제 구현
4. verifier      → 테스트/타입체크/시나리오 통과 증거
5. code-reviewer → 최종 품질 점검

실전 예시 — commerce PG race condition 해결