1exploreHaiku
내부 코드베이스 탐색, 심볼/파일 매핑
📌 언제? 특정 기능 위치 파악, 코드 관계 탐색, 파일 검색이 필요할 때
Oh My Claude Code 에이전트 가이드
22개 전문 AI 에이전트 + 20개 스킬 + 10개 Hooks - 4개 레인 구성의 멀티 에이전트 시스템
· 인터랙티브 학습 가이드
🏢 usefullabs(쓸모랩) 교육자료Build / Analysis Lane
코드를 탐색, 설계, 구현, 검증하는 핵심 AI 에이전트들. 개발 파이프라인의 중추를 담당합니다.
2analystOpus
요구사항 명확화, 인수 기준 도출, 숨겨진 제약조건 및 위험 발견
📌 언제? 요구사항 분석, 누락된 엣지 케이스 파악, 잠재적 위험 사전 식별
3plannerOpus
작업 순서 결정, 실행 계획 수립, 리스크 플래그 식별
📌 언제? 복잡한 기능 구현 전 계획 수립, 요구사항 구체화
4architectOpus
시스템 설계, 경계 정의, 인터페이스 설계, 장기적 트레이드오프
📌 언제? 버그 근본 원인 파악, 아키텍처 검토, 코드베이스 탐색
5debuggerSonnet
근본 원인 분석(root-cause analysis), 회귀 격리, 장애 진단
📌 언제? 복잡한 버그 진단, 스택 트레이스 분석, 재현 어려운 버그 해결
6executorSonnet
코드 구현, 리팩토링, 기능 개발 - OMC의 핵심 일꾼
📌 언제? 명확한 스펙이 있는 기능 구현, 기존 파일 수정 및 새 파일 생성
7deep-executorOpus
복잡한 다중 파일 변경을 처음부터 끝까지 자율적으로 탐색, 계획 및 구현
📌 언제? 대규모 기능 구현, 코드베이스 전반에 걸친 리팩토링
8verifierSonnet
완료 증거 수집, 주장 검증, 테스트 적절성 확인
📌 언제? 작업이 정말 완료되었는지 실제 증거로 확인할 때
Review Lane
코드 품질, 보안, 유지보수성을 체계적으로 검토하는 코드 리뷰 전문 에이전트들
1quality-reviewerOpus
논리적 결함, 안티패턴, 유지보수성 문제 및 SOLID 원칙 준수 여부 검토
📌 언제? 논리적 결함 감지, 안티패턴 식별, 오류 처리 완전성 검토
2security-reviewerOpus
프로덕션 도달 전 보안 취약점(OWASP Top 10 등) 식별 및 우선순위 지정
📌 언제? 보안 감사, 하드코딩된 비밀 탐지, 입력 유효성 검사 검토
3code-reviewerOpus
코드 품질과 보안을 체계적으로 검토하고 심각도 등급이 매겨진 피드백 제공
📌 언제? PR 병합 전 코드 리뷰, 보안 취약점 점검, 코드 품질 향상
Domain Specialists
테스트, 빌드, UI/UX, 문서화, 데이터 분석, Git 등 특정 도메인별 전문 에이전트
1test-engineerSonnet
테스트 전략 설계, 단위/통합/E2E 테스트 작성, TDD 워크플로우 안내
📌 언제? 테스트 커버리지 향상, 불안정한 테스트(Flaky test) 수정, TDD 적용
2build-fixerSonnet
최소한의 변경으로 타입 에러, 컴파일 실패, 의존성 문제 해결
📌 언제? 빌드 오류 해결, TypeScript 타입 에러 수정
3designerSonnet
시각적으로 뛰어난 프로덕션 수준의 UI를 구현하는 UI/UX 디자이너 겸 개발자
📌 언제? 반응형 웹 UI 제작, 프레임워크 관용적인 컴포넌트 구현
4document-specialistSonnet
공식 문서, GitHub 저장소 등 외부 소스에서 정보를 찾아 종합
📌 언제? API 참조 연구, 패키지 평가, 외부 문서 기반 문제 해결
5writerHaiku
문서, 마이그레이션 노트, 사용자 가이드 작성
📌 언제? README, API 문서, 변경 로그 등 문서화
6qa-testerSonnet
tmux 세션을 사용하여 대화형 CLI 테스트를 통해 애플리케이션 동작 검증
📌 언제? 실제 애플리케이션 통합 테스트, API 서버 동작 검증
7scientistSonnet
Python을 사용하여 데이터 분석 및 연구 작업 수행, 증거 기반 결과 도출
📌 언제? 통계 분석, 가설 검정, 데이터 시각화 및 보고서 생성
8git-masterSonnet
깔끔하고 원자적인 Git 히스토리 생성, 커밋 메시지 스타일 관리
📌 언제? 커밋 분할, 리베이스, 브랜치 관리, 프로젝트 스타일 커밋 메시지 작성
Coordination
비판적 도전, 코드 간소화 등 교차 역할을 수행하며 팀 전체의 품질을 보완하는 에이전트
1criticOpus
실행자가 구현을 시작하기 전에 작업 계획이 명확하고 실행 가능한지 검토
📌 언제? 작업 계획 검증, 구현 전 잠재적 문제점 식별
2harsh-criticOpus
최종 품질 검수자로서 구조화된 조사를 통해 결함, 간극, 의심스러운 가정 발견
📌 언제? 중요 작업의 최종 검토, 숨겨진 위험 식별, 작업 완성도 향상
3code-simplifierOpus
기능은 유지하면서 코드의 명확성, 일관성 및 유지보수성 향상
📌 언제? 코드 리팩토링, 가독성 개선, 프로젝트 코딩 컨벤션 적용
⚡ Skills — 행동을 주입하는 워크플로 모듈
에이전트의 행동 방식을 변경하거나 워크플로를 활성화하는 37개+ 모듈
!에이전트 vs 스킬 — 핵심 차이
| 에이전트 | 스킬 | |
|---|---|---|
| 정체 | 독립적 전문 역할 서브에이전트 | 행동 방식 변경 주입 모듈 |
| 실행 | Task 도구로 위임·독립 실행 | 메인 Claude 행동 수정/강화 |
| 모델 | 에이전트별 기본 모델 지정 | 실행 모드에 따라 결정 |
| 조합 | 스킬에 의해 오케스트레이션 | 여러 스킬 레이어 합성 가능 |
Workflow Skills (워크플로 스킬)
| 스킬 | 호출 방법 | 기능 |
|---|---|---|
| autopilot | /oh-my-claudecode:autopilot | 아이디어부터 작동하는 코드까지 완전 자율적으로 실행 |
| ralph | /ralph | 사용자 스토리가 완료되고 검증될 때까지 지속하는 PRD 기반 반복 루프 |
| ultrawork | ultrawork: <Task> | 고처리량 작업 완료를 위한 병렬 실행 엔진 |
| team | /oh-my-claudecode:team | 공유 작업 목록에서 여러 조정된 에이전트를 생성하여 협업 |
| omc-teams | omc team <N>:<type> "<task>" | tmux 패널에서 여러 CLI 워커 프로세스 병렬 실행 |
| pipeline | pipeline | 에이전트 순차 체이닝 (데이터 전달) |
| ultraqa | ultraqa | 테스트->검증->수정 반복 사이클 (QA cycling) |
Planning Skills (계획 스킬)
| 스킬 | 호출 방법 | 기능 |
|---|---|---|
| plan | /plan | 지능적인 상호작용을 통해 포괄적이고 실행 가능한 작업 계획 생성 |
| ralplan | /oh-my-claudecode:ralplan | Planner+Architect+Critic 합의 반복 (--consensus 모드) |
| deep-interview | deep-interview: <아이디어> | 소크라테스식 질문을 통해 모호한 아이디어를 명확한 사양으로 전환 |
Analysis Skills (분석 스킬)
| 스킬 | 호출 방법 | 기능 |
|---|---|---|
| analyze | analyze: <분석 내용> | 아키텍처, 버그, 성능 문제에 대한 심층 조사 및 구조화된 결과 반환 |
| deepinit | deepinit: [경로] | 계층적 AGENTS.md 문서를 생성하여 코드베이스를 심층적으로 초기화 |
| external-context | /oh-my-claudecode:external-context | 외부 웹 검색 및 문서 조회를 위해 병렬 에이전트 호출 |
| ccg | omc ask codex ... | Claude, Codex, Gemini 세 모델을 오케스트레이션하여 결과 종합 |
Development Workflow Skills (개발 워크플로 스킬)
| 스킬 | 호출 방법 | 기능 |
|---|---|---|
| code-review | /code-review | 코드 품질, 보안, 유지보수성에 대한 포괄적인 리뷰 수행 |
| build-fix | build-fix: <작업> | 빌드 및 TypeScript 오류를 최소한의 변경으로 신속하게 수정 |
| tdd | tdd: ... | 테스트 주도 개발(TDD) 원칙을 적용하여 테스트를 먼저 작성 |
| learner | /oh-my-claudecode:learner | 현재 대화에서 유용한 문제 해결 방법이나 지식을 추출하여 스킬로 저장 |
| web-clone | /web-clone <URL> | 주어진 URL을 복제하여 최신 프런트엔드 기술로 똑같은 웹사이트 생성 |
Utility Skills (유틸리티 스킬)
| 스킬 | 호출 방법 | 기능 |
|---|---|---|
| cancel | /oh-my-claudecode:cancel | 활성 OMC 모드를 감지하고 지능적으로 취소하거나 작업 공간 초기화 |
| omc-setup | /omc-setup | oh-my-claudecode 환경 설정 및 구성 |
| mcp-setup | /oh-my-claudecode:mcp-setup | 외부 도구 연동을 위한 인기 있는 MCP 서버 구성 |
| hud | /oh-my-claudecode:hud | Heads-Up Display(HUD)의 레이아웃 및 표시 옵션 설정 |
Hooks - Claude Code 생명주기 이벤트 제어
Claude Code의 생명주기 이벤트에 개입하여 자동화된 동작을 수행하는 스크립트들
!Hooks란?
Hooks는 hooks.json 파일에 정의되어 Claude Code의 특정 이벤트(세션 시작, 도구 실행, 세션 종료 등)에 자동으로 실행되는 스크립트입니다. 컨텍스트 보호, 프로젝트 메모리 관리, 스킬 자동 주입 등을 담당합니다.
| Hook 이벤트 | 실행 스크립트 | 주요 기능 |
|---|---|---|
| UserPromptSubmit | keyword-detector.mjs, skill-injector.mjs | 사용자 입력에서 키워드를 감지하여 관련 스킬을 자동 호출하고 컨텍스트에 주입. 명시적 스킬 검색 없이 작업 효율성 향상. |
| SessionStart | session-start.mjs, project-memory-session.mjs, setup-init.mjs | 세션 시작 시 영구 모드 복원, 프로젝트 환경 감지 및 컨텍스트 주입. 안정적인 초기 환경 자동 구성. |
| PreToolUse | pre-tool-enforcer.mjs, context-safety.mjs | 도구 실행 전 컨텍스트 사용량 점검. 임계값 초과 시 작업 차단하여 무한 루프나 과부하 방지. |
| PermissionRequest | permission-handler.mjs | 권한 요청을 가로채어 커스텀 로직에 따라 처리. 유연한 보안 정책 적용 가능. |
| PostToolUse | post-tool-verifier.mjs, project-memory-posttool.mjs | 도구 실행 후 결과 검증 및 프로젝트 메모리 업데이트. 도구 사용 기록 학습으로 향후 작업 정확성 향상. |
| PostToolUseFailure | post-tool-use-failure.mjs | 도구 사용 실패 시 오류 기록 및 재시도 전략 안내. 반복적인 실패 방지 및 디버깅 지원. |
| SubagentStart/Stop | subagent-tracker.mjs, verify-deliverables.mjs | 서브 에이전트 생명주기 추적. 작업 완료 시 결과물이 필수 기준을 충족하는지 검증하여 품질 보장. |
| PreCompact | pre-compact.mjs, project-memory-precompact.mjs | 컨텍스트 압축 전 전처리 수행. 중요한 프로젝트 메모리와 지시사항이 유실되지 않도록 보호. |
| Stop | context-guard-stop.mjs, persistent-mode.cjs, code-simplifier.mjs | 에이전트 중지 시 컨텍스트 초과 경고, 세션 지속성 관리, 수정된 코드 자동 간소화 트리거. |
| SessionEnd | session-end.mjs | 세션 종료 시 필요한 데이터 처리 및 로깅 수행. 시스템 안정성 유지. |
📋 빠른 선택 가이드 — 작업별 추천 에이전트
프로젝트 구조 파악explore
기능 구현executor
대규모 자율 리팩토링deep-executor
버그 디버깅debugger
시스템 아키텍처 설계architect
종합 코드 리뷰code-reviewer
보안 감사security-reviewer
테스트 작성test-engineer
UI/UX 작업designer
문서화writer
외부 문서/API 조사document-specialist
데이터 분석scientist
빌드 오류 수정build-fixer
코드 간소화code-simplifier
!Model Routing - 비용 vs 성능
| 모델 | Model ID | 특성 | 용도 |
|---|---|---|---|
| Haiku | claude-haiku-4-5 | 저렴/빠름 | 단순 탐색, 문서 작성, 가벼운 작업 |
| Sonnet | claude-sonnet-4-6 | 균형 | 표준 구현, 디버깅, 리뷰, 도메인 전문 작업 |
| Opus | claude-opus-4-6 | 강력 | 아키텍처, 복잡한 추론, 종합 분석, 비판적 검토 |
!Team Compositions - 일반적인 에이전트 조합
| 시나리오 | 에이전트 플로우 |
|---|---|
| Feature Development 기능 개발 전체 사이클 | analyst -> planner -> executor -> test-engineer -> quality-reviewer -> verifier |
| Bug Investigation 버그 조사 및 수정 | explore + debugger + executor + test-engineer + verifier |
| Code Review 종합 코드 리뷰 | quality-reviewer + security-reviewer + code-reviewer |
!Team Pipeline Stages
Team 모드의 기본 파이프라인: team-plan → team-prd → team-exec → team-verify → team-fix (loop)
| Stage | 주요 에이전트 | 선택적 에이전트 |
|---|---|---|
| team-plan | explore (haiku) + planner (opus) | analyst/architect |
| team-prd | analyst (opus) | critic |
| team-exec | executor (sonnet) + specialists | designer, build-fixer, writer, test-engineer, deep-executor |
| team-verify | verifier (sonnet) | security-reviewer, code-reviewer, quality-reviewer |
| team-fix | executor/build-fixer/debugger | 결함 유형에 따라 선택 |