프로젝트 첫 시작

Eugenius1st·2026년 6월 24일

Claude omc

OMC

목록 보기

5/6

프로젝트 첫 시작

새프로젝트에 들어가면 항상 이것부터 해라

/deepinit

OMC가 프로젝트 구조를 분서갛고 AGENTS.md 계층 문서를 자동 생성한다.

모델 라우팅

OMC는 작업 복잡도에 따라 자동으로 모델을 선택한다.

haiku  (저비용, 빠름)
  → 파일 탐색, 구조 분석, 문서 작성, 간단한 검색
  → 예: explore, writer 에이전트
 
sonnet (중간 비용, 균형)
  → 일반 구현, 테스트, 디버깅, 리팩토링
  → 예: executor, test-engineer, debugger 에이전트
 
opus   (고비용, 최고 성능)
  → 아키텍처 설계, 복잡한 분석, 종합 리뷰, 비판적 검토
  → 예: architect, code-reviewer, critic 에이전트

실제로 이렇게 동작한다.
사용자: "autopilot: 인증 시스템 만들어줘"

OMC 내부:

  1. explore    (haiku)  → 현재 코드 구조 파악
  2. planner    (opus)   → 구현 계획 수립
  3. architect  (opus)   → 인터페이스 설계
  4. executor   (sonnet) × 3 → 병렬 구현
  5. test-engineer (sonnet) → 테스트 작성
  6. verifier   (sonnet) → 완료 검증

Autopilot - 완전 자율 실행

복잡한 단일 기능 구현에 최적, 계획부터 검증까지 자동

트리거 키워드: autopilot:, build me, I want a

Phase 1 — 확장 (Expansion)
  "할일 목록"을 구체적 요구사항으로 확장
  → 할일 추가/삭제/완료 토글, 로컬 상태 관리, 반응형 UI
 
Phase 2 — 계획 (Planning)
  planner 에이전트가 작업 분해
  → Todo 타입 정의 → TodoItem 컴포넌트 → TodoList → 페이지 통합
 
Phase 3 — 실행 (Execution)
  executor 에이전트들 병렬 구현
  → src/types/todo.ts 생성
  → src/components/TodoItem.tsx 생성
  → src/components/TodoList.tsx 생성
  → src/app/todos/page.tsx 수정
 
Phase 4 — QA
  qa-tester 가 빌드/린트/테스트 실행
  → npm run build → 통과
  → npm run lint  → 통과
 
Phase 5 — 검증 (Verification)
  verifier 에이전트가 요구사항 체크리스트 확인
  → ✓ 할일 추가 기능
  → ✓ 삭제 기능
  → ✓ 완료 토글
  → "완료 확인됨"

ralph: 끝까지 멈추지 않는 모드

v4.6.0부터 Ralph는 자동으로 prd.json을 생성합니다. 모든 수용 기준이 통과할 때까지 반복합니다.

트리거 키워드: ralph:, don't stop, must complete

사용자: "ralph: 이 앱에 JWT 인증 시스템 전체 구현해줘"
 
자동 생성: .omc/prd.json
  {
    "title": "JWT 인증 시스템",
    "acceptance_criteria": [
      "회원가입 API (/api/auth/register) 동작",
      "로그인 API (/api/auth/login) JWT 발급",
      "보호된 라우트에서 토큰 검증",
      "리프레시 토큰 갱신",
      "모든 에러 케이스 핸들링"
    ]
  }
 
Iteration 1: 기본 구조 + 회원가입 구현
Iteration 2: 로그인 + JWT 발급 구현
Iteration 3: 미들웨어 + 토큰 검증 구현
Iteration 4: 리프레시 토큰 구현
Iteration 5: verifier 검증 → "에러 핸들링 미흡"
Iteration 6: 에러 핸들링 전체 보강
Iteration 7: verifier 검증 → "모든 기준 통과" → 완료

PRD 없이 시작하려면: "ralph --no-prd: 로그인 기능 만들어줘"

Ultrawork — 최대 병렬 실행

5개 이상의 에이전트를 동시에 투입. 독립적인 작업 대량 처리에 최적.

트리거 키워드: ultrawork, ulw

사용자: "ulw: 이 5개 API 엔드포인트 전부 구현해줘
        (users, posts, comments, likes, notifications)"
 
동시 실행:
  executor #1 → /api/users 구현    ─┐
  executor #2 → /api/posts 구현    ─┤
  executor #3 → /api/comments 구현 ─┤ 병렬
  executor #4 → /api/likes 구현    ─┤
  executor #5 → /api/notifications ─┘
 
총 소요 시간 ≈ 단일 작업 시간 × 1.2 (병렬 오버헤드 포함)

Ecomode — 토큰 효율 최대화

비용이 중요할 때. 가능한 한 저렴한 모델 우선 사용.

트리거 키워드: eco

사용자: "eco: 린트 에러 전부 수정해줘"
 
→ haiku 모델로 먼저 시도
→ haiku가 해결 못하면 sonnet으로 에스컬레이션
→ opus는 절대적으로 필요한 경우에만 사용
→ 예상 비용 절감: 30~50%

Team — 네이티브 팀 협업

Claude Code 네이티브 팀 기능을 활용한 조율 방식.

트리거 키워드: team

사용자: "team 3:executor 모든 컴포넌트 테스트 코드 작성"
 
→ executor 에이전트 3개가 팀으로 조율하며 작업
→ 실시간 메시지로 작업 상태 공유
→ 공유 태스크 리스트에서 각자 작업 픽업
 
파이프라인:
  team-plan → team-prd → team-exec → team-verify → team-fix

Deep Interview — 막연한 아이디어 명확화

v4.6.0 신기능. 실행 전 소크라테스식 질문으로 모호함을 제거합니다.

트리거 키워드: /deep-interview

사용자: "/deep-interview '대시보드 만들어줘'"
 
OMC가 수학적 모호성 점수를 계산하고 질문 생성:
 
Q1: "어떤 종류의 데이터를 보여주는 대시보드인가요?
    (a) 사용자 분석  (b) 매출 현황  (c) 시스템 모니터링  (d) 기타"
 
Q2: "실시간 업데이트가 필요한가요?"
 
Q3: "대상 사용자는 누구인가요? 기술적 지식 수준은?"
 
→ 명확성 점수가 임계값 이상이 되면 실행 시작
→ 애매한 요구사항으로 인한 재작업 방지

사용 시점: 요구사항이 추상적이거나 규모가 큰 작업 전

Plan — 전략적 계획 수립

실행 전 계획을 먼저 세우고 승인을 받는 방식.

트리거 키워드: plan this:, plan the

사용자: "plan this: 결제 시스템 연동"
 
→ 현재 코드 분석 (explore)
→ 구현 계획 상세 작성
→ 계획을 사용자에게 제시 → 승인 요청
 
출력 예시:
  구현 계획: 결제 시스템 연동
 
  Step 1: 환경 변수 설정 (5분)
    - .env에 STRIPE_SECRET_KEY, STRIPE_PUBLISHABLE_KEY 추가
 
  Step 2: Stripe SDK 설치 및 클라이언트 설정 (10분)
    - npm install @stripe/stripe-js stripe
    - src/lib/stripe.ts 생성
 
  Step 3: 결제 API 라우트 구현 (20분)
    - POST /api/checkout → Stripe 세션 생성
    - GET /api/checkout/success → 결제 확인
 
  Step 4: 프론트엔드 결제 버튼 구현 (15분)
    - src/components/CheckoutButton.tsx 생성
 
  Step 5: 웹훅 처리 (15분)
    - POST /api/webhooks/stripe → 결제 완료 처리
 
  이 계획으로 진행할까요?

Ralplan — 합의 기반 계획

Planner, Architect, Critic 세 에이전트가 합의에 이를 때까지 반복 검토.

트리거 키워드: ralplan, consensus plan

사용자: "ralplan: 멀티테넌트 SaaS 아키텍처 설계해줘"
 
Round 1:
  planner   → 초안 작성 (마이크로서비스 제안)
  architect → 검토: "데이터 격리 방식 명시 필요"
  critic    → 비판: "배포 복잡성 과소평가됨"
 
Round 2:
  planner   → 수정안 (모놀리스 + 모듈식)
  architect → 수정: "테넌트별 스키마 격리 추가"
  critic    → "허용 가능, 스케일링 계획 보강 필요"
 
Round 3:
  합의 도달 → 최종 아키텍처 문서 생성
 
옵션: "ralplan --deliberate: ..." 
  → 사전 위험 분석 + 확장된 테스트 계획 포함

Claude Code 모드 & 에이전트 완전 정리

Claude Code는 단순히 코드 생성만 하는 것이 아니라, 작업 규모와 목적에 따라 다양한 실행 모드와 전문 에이전트를 활용할 수 있다.

1. 작업 규모별 추천 모드

작업 유형	추천 모드	이유
버그 1개 수정	일반 대화	단순하고 빠르게 해결 가능
컴포넌트 1개 추가	`plan → 직접 구현`	구현 전에 구조를 먼저 정리
기능 1개 개발 (여러 파일 수정)	`autopilot`	계획 → 구현 → 검증까지 자동 수행
대규모 기능 개발	`ralph`	완료될 때까지 반복적으로 작업
풀스택 프로젝트 구축	`team + ralph`	여러 에이전트 협업 + 지속 실행
여러 파일 리팩토링	`ulw`	병렬 처리에 강함
아키텍처 설계	`ralplan`	전문가 관점으로 설계 합의
막연한 아이디어 정리	`/deep-interview`	요구사항을 먼저 명확화
비용 절감 우선	`eco`	저비용 모델 중심으로 실행

2. 빌드 & 분석 에이전트

프로젝트를 이해하고 구현하기 위한 핵심 에이전트들이다.

에이전트	모델	역할	활용 예시
explore	Haiku	코드 탐색, 파일 구조 분석	"인증 관련 파일 찾아줘"
analyst	Opus	요구사항 분석, 엣지케이스 정리	"이 기능의 예외 상황 정리해줘"
planner	Opus	작업 순서 계획 수립	"마이그레이션 순서 알려줘"
architect	Opus	시스템 설계 및 인터페이스 정의	"확장 가능한 API 구조 설계해줘"
debugger	Sonnet	버그 원인 분석	"이 에러가 왜 발생하는지 찾아줘"
executor	Sonnet	구현 및 리팩토링	"이 코드를 TypeScript로 변환해줘"
deep-executor	Opus	복잡한 다중 파일 구현	대규모 기능 개발
verifier	Sonnet	구현 결과 검증	"정말 모든 기능이 동작하는지 확인해줘"

3. 리뷰 에이전트

코드 품질과 안정성을 검토하는 역할을 담당한다.

에이전트	모델	역할
quality-reviewer	Sonnet	로직 결함, 성능 문제, 안티패턴 점검
security-reviewer	Sonnet	보안 취약점 분석
code-reviewer	Opus	종합 코드 리뷰 및 API 계약 검토

사용 예시

review code

→ code-reviewer 실행

security review

→ security-reviewer 실행

4. 도메인 전문가 에이전트

특정 분야에 특화된 전문가 역할을 수행한다.

에이전트	모델	역할	활용 예시
test-engineer	Sonnet	테스트 전략 및 TDD	"단위 테스트 작성해줘"
build-fixer	Sonnet	빌드 및 타입 에러 해결	"타입 에러 전부 수정해줘"
designer	Sonnet	UI/UX 설계	"폼 UX 개선해줘"
writer	Haiku	문서 작성	README, API 문서 작성
qa-tester	Sonnet	E2E 및 런타임 검증	"실제로 테스트해봐"
scientist	Sonnet	데이터 분석	로그 분석, 통계 분석
document-specialist	Sonnet	공식 문서 조사	Next.js, React 문서 확인
git-master	Sonnet	Git 관리	커밋 정리, PR 작성
code-simplifier	Opus	복잡한 코드 단순화	중복 제거, 리팩토링

5. 조율 에이전트

다른 에이전트가 만든 결과를 비판적으로 검토한다.

에이전트	모델	역할	활용 예시
critic	Opus	설계 및 계획 검토	"이 아키텍처의 문제점을 찾아줘"

한 줄 요약

작은 작업 → 일반 대화
기능 개발 → autopilot
대규모 개발 → ralph
설계 → architect / ralplan
리뷰 → code-reviewer
보안 → security-reviewer
테스트 → test-engineer
Git 작업 → git-master

작업 규모가 커질수록 "계획 → 구현 → 검증"을 자동으로 반복하는 모드가 효율적이다.

6. 매직 키워드 & 슬래시 명령어 레퍼런스

Claude Code는 특정 키워드나 슬래시 명령어를 입력하면 자동으로 적절한 실행 모드와 에이전트를 활성화할 수 있다.

매직 키워드(Magic Keywords)

프롬프트에 특정 키워드를 포함하면 자동으로 해당 모드가 활성화된다.

자율 실행 계열

키워드	실행 모드	사용 예시
`autopilot:`	완전 자율 실행	`autopilot: 검색 기능 추가해줘`
`build me`	완전 자율 실행	`build me a REST API`
`ralph:`	완료까지 반복 실행	`ralph: 인증 시스템 전체 구현`
`don't stop`	완료 시까지 반복	`don't stop until all tests pass`

언제 사용할까?

여러 파일 수정이 필요한 기능 개발
구현 → 테스트 → 수정 과정을 자동으로 돌리고 싶을 때
중간 승인 없이 끝까지 진행시키고 싶을 때

병렬 작업 계열

키워드	실행 모드	사용 예시
`ulw`	최대 병렬 처리	`ulw 이 10개 컴포넌트 전부 리팩토링`
`ultrawork`	최대 병렬 처리	`ultrawork: API 5개 동시 구현`

언제 사용할까?

많은 파일을 동시에 수정해야 할 때
독립적인 작업을 병렬로 처리할 수 있을 때
대규모 리팩토링 작업

계획 수립 계열

키워드	실행 모드	사용 예시
`plan this:`	작업 계획 수립	`plan this: 결제 시스템 연동`
`ralplan`	전문가 합의 기반 설계	`ralplan: DB 스키마 설계`

언제 사용할까?

구현 전에 설계를 검토하고 싶을 때
시스템 구조를 먼저 정의해야 할 때
대규모 기능 개발 전

분석 및 디버깅 계열

키워드	실행 모드	사용 예시
`analyze`	분석 및 원인 추적	`analyze: 메모리 누수 원인 찾아줘`
`debug`	디버깅 모드	`debug: API 500 에러 원인 분석`

언제 사용할까?

에러의 근본 원인을 찾고 싶을 때
성능 저하나 메모리 문제 분석
복잡한 버그 조사

리뷰 및 품질 관리 계열

키워드	실행 모드	사용 예시
`review code`	종합 코드 리뷰	`review code`
`security review`	보안 리뷰	`security review`
`fix build`	빌드 오류 수정	`fix build`
`type errors`	타입 오류 수정	`fix all type errors`
`tdd`	테스트 주도 개발	`tdd: 로그인 기능 구현`

언제 사용할까?

PR 생성 전
배포 직전 점검
TypeScript 마이그레이션
테스트 코드 작성

슬래시 명령어(Slash Commands)

직접 입력하여 사용할 수 있는 명령어들이다.

핵심 워크플로우

명령어	설명
`/deepinit`	프로젝트용 AGENTS.md 계층 구조 생성
`/deep-interview`	요구사항 명확화 인터뷰
`/autopilot`	자율 실행 모드
`/ralph`	완료 시까지 반복 실행
`/ultrawork`	최대 병렬 작업
`/team`	여러 에이전트 협업
`/plan`	작업 계획 수립
`/ralplan`	합의 기반 설계
`/analyze`	분석 및 디버깅

코드 품질 관리

명령어	설명
`/code-review`	종합 코드 리뷰
`/security-review`	보안 취약점 점검
`/build-fix`	빌드 오류 수정
`/tdd`	테스트 주도 개발
`/sciomc`	데이터 분석 및 통계 작업

멀티 AI 협업

명령어	설명
`/omc-teams`	Codex, Gemini 등 외부 AI 협업
`/ccg`	Claude + Codex + Gemini 동시 활용

유틸리티

명령어	설명
`/note`	메모 저장
`/cancel`	현재 작업 취소
`/cancel --force`	모든 상태 초기화
`/trace`	에이전트 실행 로그 확인
`/hud`	HUD 상태바 설정
`/learner`	재사용 가능한 패턴 추출
`/skill`	커스텀 스킬 관리
`/configure-notifications`	알림 설정
`/omc-setup`	OMC 재설정
`/omc-doctor`	설치 진단
`/omc-help`	도움말

한 줄 요약

Claude Code를 제대로 활용하려면 단순히 "코드 작성"을 요청하는 것이 아니라,

설계는 plan, ralplan
구현은 autopilot, ralph
병렬 작업은 ultrawork
리뷰는 review code
보안은 security review

처럼 작업 목적에 맞는 모드와 에이전트를 선택하는 것이 핵심이다.

Eugenius1st

자신만의 속도로

이전 포스트

OMC 멀티 에이전트의 오케스트레이션

다음 포스트

프로젝트 첫 시작

OMC

프로젝트 첫 시작

모델 라우팅

Autopilot - 완전 자율 실행

ralph: 끝까지 멈추지 않는 모드

Ultrawork — 최대 병렬 실행

Ecomode — 토큰 효율 최대화

Team — 네이티브 팀 협업

Deep Interview — 막연한 아이디어 명확화

Plan — 전략적 계획 수립

Ralplan — 합의 기반 계획

Claude Code 모드 & 에이전트 완전 정리

1. 작업 규모별 추천 모드

2. 빌드 & 분석 에이전트

3. 리뷰 에이전트

사용 예시

4. 도메인 전문가 에이전트

5. 조율 에이전트

추천 활용 패턴

한 줄 요약

6. 매직 키워드 & 슬래시 명령어 레퍼런스

매직 키워드(Magic Keywords)

자율 실행 계열

언제 사용할까?

병렬 작업 계열

언제 사용할까?

계획 수립 계열

언제 사용할까?

분석 및 디버깅 계열

언제 사용할까?

리뷰 및 품질 관리 계열

언제 사용할까?

슬래시 명령어(Slash Commands)

핵심 워크플로우

코드 품질 관리

멀티 AI 협업

유틸리티

추천 사용 흐름

기능 개발

버그 수정

대규모 프로젝트

배포 전 점검

한 줄 요약

OMC 멀티 에이전트의 오케스트레이션

OMC 빠른 참조 카드

0개의 댓글