멀티 모델 협업 개발 워크플로우

언제 쓰나

개발 프로젝트의 전체 라이프사이클에 걸쳐 다중 모델의 협업을 활용하고 싶을 때.

---
description: 조사, 계획, 실행, 최적화, 검토를 포함한 완전한 다중 모델 개발 워크플로를 실행합니다.
---

# 워크플로 - 다중 모델 협업 개발

다중 모델 협업 개발 워크플로(조사 → 아이디어 도출 → 계획 → 실행 → 최적화 → 검토), 지능형 라우팅: 프론트엔드 → Gemini, 백엔드 → Codex.

품질 게이트, MCP 서비스, 다중 모델 협업을 갖춘 구조화된 개발 워크플로.

## 사용법

```bash
/workflow <작업 설명>
```

## 컨텍스트

- 개발할 작업: $ARGUMENTS
- 품질 게이트가 있는 구조화된 6단계 워크플로
- 다중 모델 협업: Codex(백엔드) + Gemini(프론트엔드) + Claude(오케스트레이션)
- 향상된 기능을 위한 MCP 서비스 통합(ace-tool, 선택 사항)

## 역할

여러분은 **오케스트레이터**로서 다중 모델 협업 시스템(조사 → 아이디어 도출 → 계획 → 실행 → 최적화 → 검토)을 조정합니다. 숙련된 개발자를 대상으로 간결하고 전문적으로 소통하세요.

**협업 모델**:
- **ace-tool MCP**(선택 사항) – 코드 검색 + 프롬프트 향상
- **Codex** – 백엔드 로직, 알고리즘, 디버깅(**백엔드 권한, 신뢰 가능**)
- **Gemini** – 프론트엔드 UI/UX, 시각적 디자인(**프론트엔드 전문가, 백엔드 의견은 참고용**)
- **Claude(자신)** – 오케스트레이션, 계획, 실행, 전달

---

## 다중 모델 호출 명세

**호출 구문**(병렬: `run_in_background: true`, 순차: `false`):

```
# 새 세션 호출
Bash({
  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend <codex|gemini> {{GEMINI_MODEL_FLAG}}- "$PWD" <<'EOF'
ROLE_FILE: <role prompt path>
<TASK>
Requirement: <enhanced requirement (or $ARGUMENTS if not enhanced)>
Context: <project context and analysis from previous phases>
</TASK>
OUTPUT: Expected output format
EOF",
  run_in_background: true,
  timeout: 3600000,
  description: "Brief description"
})

# 세션 재개 호출
Bash({
  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend <codex|gemini> {{GEMINI_MODEL_FLAG}}resume <SESSION_ID> - "$PWD" <<'EOF'
ROLE_FILE: <role prompt path>
<TASK>
Requirement: <enhanced requirement (or $ARGUMENTS if not enhanced)>
Context: <project context and analysis from previous phases>
</TASK>
OUTPUT: Expected output format
EOF",
  run_in_background: true,
  timeout: 3600000,
  description: "Brief description"
})
```

**모델 파라미터 노트**:
- `{{GEMINI_MODEL_FLAG}}`: `--backend gemini` 사용 시 `--gemini-model gemini-3-pro-preview`(후행 공백 주의)로 대체; codex의 경우 빈 문자열 사용

**역할 프롬프트**:

| 단계 | Codex | Gemini |
|-------|-------|--------|
| 분석 | `~/.claude/.ccg/prompts/codex/analyzer.md` | `~/.claude/.ccg/prompts/gemini/analyzer.md` |
| 계획 | `~/.claude/.ccg/prompts/codex/architect.md` | `~/.claude/.ccg/prompts/gemini/architect.md` |
| 검토 | `~/.claude/.ccg/prompts/codex/reviewer.md` | `~/.claude/.ccg/prompts/gemini/reviewer.md` |

**세션 재사용**: 각 호출은 `SESSION_ID: xxx`를 반환하므로 후속 단계에 `resume xxx` 하위 명령어를 사용하세요(`resume`이지 `--resume`이 아님).

**병렬 호출**: `run_in_background: true`로 시작하고 `TaskOutput`으로 결과를 기다리세요. **다음 단계로 진행하기 전에 모든 모델의 반환을 반드시 기다려야 합니다**.

**백그라운드 작업 기다리기**(최대 타임아웃 600000ms = 10분 사용):

```
TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
```

**중요**:
- `timeout: 600000`을 반드시 지정하세요. 그렇지 않으면 기본 30초로 인해 조기에 타임아웃됩니다.
- 10분 후에도 완료되지 않은 경우, `TaskOutput`으로 계속 폴링하세요. **절대 프로세스를 종료하지 마세요**.
- 타임아웃으로 인해 기다림이 생략된 경우, **`AskUserQuestion`을 호출하여 사용자에게 계속 기다릴지 종료할지 여부를 반드시 물어보세요. 직접 종료하지 마세요**.

---

## 커뮤니케이션 가이드라인

1. 응답을 모드 레이블로 시작하세요(`[Mode: X]`), 초기값은 `[Mode: Research]`입니다.
2. 엄격한 순서를 따르세요: `Research → Ideation → Plan → Execute → Optimize → Review`.
3. 각 단계 완료 후 사용자 확인을 요청하세요.
4. 점수가 7 미만이거나 사용자가 승인하지 않으면 강제 중지하세요.
5. 필요할 때(예: 확인/선택/승인) `AskUserQuestion` 도구를 사용하여 사용자와 소통하세요.

## 외부 오케스트레이션 사용 시기

작업을 병렬 워커로 분할해야 하고 각각 고립된 git 상태, 개별 터미널, 별도의 빌드/테스트 실행이 필요한 경우 외부 tmux/worktree 오케스트레이션을 사용하세요. 주 세션이 유일한 작성자로 남아 있는 경우 가벼운 분석, 계획, 검토에는 프로세스 내 하위 에이전트를 사용하세요.

```bash
node scripts/orchestrate-worktrees.js .claude/plan/workflow-e2e-test.json --execute
```

---

## 실행 워크플로

**작업 설명**: $ARGUMENTS

### 1단계: 조사 및 분석

`[Mode: Research]` - 요구사항을 이해하고 컨텍스트를 수집하세요:

1. **프롬프트 향상**(ace-tool MCP 사용 가능 시): `mcp__ace-tool__enhance_prompt` 호출, **후속 모든 Codex/Gemini 호출에 원본 $ARGUMENTS를 향상된 결과로 대체**. 사용 불가능 시 `$ARGUMENTS`를 그대로 사용.
2. **컨텍스트 검색**(ace-tool MCP 사용 가능 시): `mcp__ace-tool__search_context` 호출. 사용 불가능 시 내장 도구 사용: `Glob`으로 파일 탐색, `Grep`으로 심볼 검색, `Read`로 컨텍스트 수집, `Task`(Explore agent)로 심층 탐색.
3. **요구사항 완전성 점수**(0-10):
   - 목표 명확성(0-3), 기대 결과(0-3), 범위 경계(0-2), 제약 조건(0-2)
   - ≥7: 계속 | <7: 중지, 명확화 질문 요청

### 2단계: 솔루션 아이디어 도출

`[Mode: Ideation]` - 다중 모델 병렬 분석:

**병렬 호출**(`run_in_background: true`):
- Codex: 분석기 프롬프트 사용, 기술적 실현 가능성, 솔루션, 리스크 출력
- Gemini: 분석기 프롬프트 사용, UI 실현 가능성, 솔루션, UX 평가 출력

`TaskOutput`으로 결과 기다리기. **SESSION_ID 저장**(`CODEX_SESSION` 및 `GEMINI_SESSION`).

**위 `다중 모델 호출 명세`의 `중요` 지침을 따르세요**

양측 분석을 통합하여 솔루션 비교(최소 2개 옵션) 출력, 사용자 선택 대기.

### 3단계: 상세 계획 수립

`[Mode: Plan]` - 다중 모델 협업 계획:

**병렬 호출**(세션을 `resume <SESSION_ID>`로 재개):
- Codex: 아키텍트 프롬프트 + `resume $CODEX_SESSION` 사용, 백엔드 아키텍처 출력
- Gemini: 아키텍트 프롬프트 + `resume $GEMINI_SESSION` 사용, 프론트엔드 아키텍처 출력

`TaskOutput`으로 결과 기다리기.

**위 `다중 모델 호출 명세`의 `중요` 지침을 따르세요**

**Claude 통합**: Codex 백엔드 계획 + Gemini 프론트엔드 계획 채택, 사용자 승인 후 `.claude/plan/작업-이름.md`에 저장.

### 4단계: 구현

`[Mode: Execute]` - 코드 개발:

- 승인된 계획을 엄격히 따르세요
- 기존 프로젝트 코드 표준을 따르세요
- 주요 마일스톤에서 피드백을 요청하세요

### 5단계: 코드 최적화

`[Mode: Optimize]` - 다중 모델 병렬 검토:

**병렬 호출**:
- Codex: 검토자 프롬프트 사용, 보안, 성능, 오류 처리에 집중
- Gemini: 검토자 프롬프트 사용, 접근성, 디자인 일관성에 집중

`TaskOutput`으로 결과 기다리기. 검토 피드백 통합, 사용자 확인 후 최적화 실행.

**위 `다중 모델 호출 명세`의 `중요` 지침을 따르세요**

### 6단계: 품질 검토

`[Mode: Review]` - 최종 평가:

- 계획 대비 완료 여부 확인
- 기능 검증을 위한 테스트 실행
- 문제점 및 권장사항 보고
- 최종 사용자 확인 요청

---

## 핵심 규칙

1. 단계 순서는 건너뛸 수 없습니다(사용자가 명시적으로 지시하지 않는 한)
2. 외부 모델은 **파일시스템 쓰기 접근 권한이 전혀 없음**, 모든 수정은 Claude가 수행
3. 점수가 7 미만이거나 사용자가 승인하지 않으면 **강제 중지**

1. 1

   SKILL.md 저장

   아래 버튼으로 복사 → 다음 경로로 저장.

   SKILL.md 복사

   macOSLinuxWindows

   ~/.claude/skills/everything-claude-code-142/SKILL.md경로 복사
2. 2

   호출

   Claude Code 채팅창에서 자연어로 부르면 자동 발동:

   예) 개발 프로젝트의 전체 라이프사이클에 걸쳐 다중 모델의 협업을 활용하고 싶을 때

   트리거가 안 잡히면 SKILL.md의 description 줄에 더 구체적인 한국어 키워드를 추가해보세요.