---
description: Gemini(리서치) + Codex(설계 검토) + Claude(작성) 3자 협업 워크플로우를 시작합니다
argument-hint: "<작업 내용 설명>"
---

# 협업 — Multi-Agent 오케스트레이션

Claude Code(오케스트레이터) + Codex CLI(설계 추론) + Gemini CLI(리서치)를 협업시킵니다.
사용자는 이 명령어 하나로 3개 AI의 강점을 동시에 활용할 수 있습니다.

## 워크플로우

$ARGUMENTS에서 작업 내용을 파악한 뒤 아래 순서로 진행하세요.

---

### Phase 1. 작업 분석
요청을 분석해 필요한 단계를 판단:
- 리서치가 필요한가? (새 기술, 공식 문서, 최신 정보 포함 여부)
- 설계 판단이 필요한가? (구조, 아키텍처, 목차, 트레이드오프 포함 여부)

사용자에게 분석 결과를 한 줄로 알림:
> "작업 분석 완료: [리서치 필요 여부] / [설계 검토 필요 여부]"

---

### Phase 2. Gemini 리서치 (리서치 필요 시)
**gemini-system 스킬을 호출**해 수행하거나, 직접 실행:

```bash
npx @google/gemini-cli -p "다음 주제를 조사해줘: [주제]. 공식 문서 기반으로 초보자 관점에서 중요한 포인트, 자주 막히는 부분, 최신 변경사항을 정리해줘. 한국어로 답변해줘."
```

사용자에게 알림: "Gemini가 [주제] 리서치 중..."
결과를 `~/.claude/docs/research/YYYY-MM-DD-<주제>.md`에 저장.

---

### Phase 3. Claude 계획 수립
Gemini 리서치 결과를 반영해 작업 계획 초안 작성.
계획을 사용자에게 보여주고 피드백 수렴.

---

### Phase 4. Codex 설계 검토
**codex-system 스킬을 호출**해 수행하거나, 직접 실행:

```bash
npx @openai/codex exec "다음 계획을 검토해줘: [계획 내용]. 구조적 문제, 누락된 부분, 개선 제안을 구체적으로 알려줘. 한국어로 답변해줘."
```

사용자에게 알림: "Codex가 설계 검토 중..."
결과를 `~/.claude/docs/DESIGN.md`에 추가.

---

### Phase 5. Claude 본문/코드 작성
Gemini 리서치 + Codex 설계 검토 결과를 모두 반영해 작성.
진행 중 주요 결정사항을 사용자에게 알림.

---

### Phase 6. Codex 최종 리뷰
작성 완료 후 Codex에 최종 리뷰 요청:

```bash
npx @openai/codex exec "다음 결과물을 리뷰해줘: [결과물 요약]. 품질, 완성도, 개선 제안을 알려줘. 한국어로 답변해줘."
```

사용자에게 알림: "Codex가 최종 리뷰 중..."

---

### Phase 7. 완료 보고
전체 과정 요약:
- Gemini 리서치 결과 파일 경로
- Codex 설계 검토 핵심 내용
- 최종 결과물 요약

---

## 주의사항

- 각 Phase 시작 시 반드시 사용자에게 진행 상황 알림
- Codex/Gemini 호출 시 한국어로 응답하도록 프롬프트에 명시
- 결과는 항상 `~/.claude/docs/`에 저장해 다음 세션에서도 재사용 가능하게 유지
- 리서치나 설계 검토가 불필요한 단순 작업은 Phase를 건너뛰고 바로 작성 진행