다중 모델 협력 계획

언제 쓰나

다중 모델을 협력하여 구현할 때 유용합니다.

---
description: 프로덕션 코드를 수정하지 않고 다중 모델 구현 계획을 생성합니다.
---

# 계획 - 다중 모델 협업 계획

다중 모델 협업 계획 - 컨텍스트 검색 + 듀얼 모델 분석 → 단계별 구현 계획 생성.

$ARGUMENTS

---

## 핵심 프로토콜

- **언어 프로토콜**: 도구/모델과 상호 작용할 때는 **영어를** 사용하고, 사용자 언어로 소통합니다.
- **필수 병렬 처리**: Codex/Gemini 호출은 메인 스레드를 차단하지 않기 위해 `run_in_background: true`를 사용해야 합니다 (단일 모델 호출 포함).
- **코드 주권**: 외부 모델은 파일 시스템 쓰기 액세스가 **전혀 없으며**, 모든 수정은 Claude가 수행합니다.
- **손실 방지 메커니즘**: 현재 단계의 출력이 검증될 때까지 다음 단계로 진행하지 않습니다.
- **계획 전용**: 이 명령어는 컨텍스트를 읽고 `.claude/plan/*` 계획 파일에 쓸 수 있지만, **절대 프로덕션 코드를 수정하지 않습니다**.

---

## 다중 모델 호출 사양

**호출 구문** (병렬: `run_in_background: true` 사용):

```
Bash({
  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend <codex|gemini> {{GEMINI_MODEL_FLAG}}- \"$PWD\" <<'EOF'\nROLE_FILE: <role prompt path>\n<TASK>\nRequirement: <enhanced requirement>\nContext: <retrieved project context>\n</TASK>\nOUTPUT: 의사 코드를 포함한 단계별 구현 계획. 어떤 파일도 수정하지 마세요.\nEOF",
  run_in_background: true,
  timeout: 3600000,
  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` |

**세션 재사용**: 각 호출은 `SESSION_ID: xxx` (일반적으로 래퍼에서 출력됨)를 반환하며, 후속 `/ccg:execute` 사용을 위해 **저장해야 합니다**.

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

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

**중요**: 
- `timeout: 600000`을 지정해야 합니다. 그렇지 않으면 기본 30초로 인해 조기 타임아웃이 발생합니다.
- 10분 후에도 완료되지 않으면 `TaskOutput`으로 계속 폴링하세요. **프로세스를 절대 종료하지 마세요**.
- 타임아웃으로 인해 대기가 건너뛴 경우, **`AskUserQuestion`을 호출하여 사용자에게 계속 기다릴지 또는 작업을 종료할지 물어봐야 합니다**.

---

## 실행 워크플로

**계획 작업**: $ARGUMENTS

### 1단계: 전체 컨텍스트 검색

`[모드: 리서치]`

#### 1.1 프롬프트 강화 (가장 먼저 실행해야 함)

**ace-tool MCP가 사용 가능한 경우**, `mcp__ace-tool__enhance_prompt` 도구를 호출하세요:

```
mcp__ace-tool__enhance_prompt({
  prompt: "$ARGUMENTS",
  conversation_history: "<지난 5-10회 대화 턴>",
  project_root_path: "$PWD"
})
```

강화된 프롬프트를 기다린 후, 후속 모든 단계에 대해 **원본 $ARGUMENTS를 강화된 결과로 대체**하세요.

**ace-tool MCP를 사용할 수 없는 경우**: 이 단계를 건너뛰고 원본 `$ARGUMENTS`를 그대로 모든 후속 단계에 사용합니다.

#### 1.2 컨텍스트 검색

**ace-tool MCP가 사용 가능한 경우**, `mcp__ace-tool__search_context` 도구를 호출하세요:

```
mcp__ace-tool__search_context({
  query: "<강화된 요구사항 기반 의미론적 쿼리>",
  project_root_path: "$PWD"
})
```

- 자연어를 사용하여 의미론적 쿼리를 구축하세요 (어디서/무엇을/어떻게).
- **가정에 기반하여 절대 답변하지 마세요**.

**ace-tool MCP를 사용할 수 없는 경우**, Claude Code 내장 도구를 대체로 사용하세요:
1. **Glob**: 패턴으로 관련 파일을 찾습니다 (예: `Glob("**/*.ts")`, `Glob("src/**/*.py")`).
2. **Grep**: 키 심볼, 함수 이름, 클래스 정의를 검색합니다 (예: `Grep("className|functionName")`).
3. **Read**: 발견된 파일을 읽어 전체 컨텍스트를 수집합니다.
4. **Task (탐색 에이전트)**: 더 깊은 탐색을 위해 `subagent_type: "Explore"`와 함께 `Task`를 사용하여 코드베이스 전체를 검색합니다.

#### 1.3 완전성 확인

- 관련 클래스, 함수, 변수에 대한 **전체 정의 및 시그니처**를 얻어야 합니다.
- 컨텍스트가 불충분하면 **재귀적 검색**을 트리거합니다.
- 출력 우선순위: 진입 파일 + 줄 번호 + 키 심볼 이름; 모호성을 해결하는 데 필요한 경우에만 최소한의 코드 스니펫을 추가합니다.

#### 1.4 요구사항 정렬

- 요구사항에 여전히 모호성이 있다면, 사용자에게 안내 질문을 출력해야 합니다.
- 요구사항 경계가 명확해질 때까지 (누락 없음, 중복 없음).

### 2단계: 다중 모델 협업 분석

`[모드: 분석]`

#### 2.1 입력 분배

Codex와 Gemini를 **병렬로 호출** (`run_in_background: true`):

**원본 요구사항** (사전 설정된 의견 없이)을 두 모델에 분배합니다:

1. **Codex 백엔드 분석**:
   - ROLE_FILE: `~/.claude/.ccg/prompts/codex/analyzer.md`
   - 초점: 기술적 타당성, 아키텍처 영향, 성능 고려 사항, 잠재적 위험
   - 출력: 다각적 솔루션 + 장단점 분석

2. **Gemini 프론트엔드 분석**:
   - ROLE_FILE: `~/.claude/.ccg/prompts/gemini/analyzer.md`
   - 초점: UI/UX 영향, 사용자 경험, 시각 디자인
   - 출력: 다각적 솔루션 + 장단점 분석

`TaskOutput`으로 두 모델의 완료된 결과를 기다립니다. `SESSION_ID` (`CODEX_SESSION` 및 `GEMINI_SESSION`)를 저장합니다.

#### 2.2 교차 검증

관점을 통합하고 최적화를 위해 반복합니다:

1. **합의점 식별** (강한 신호)
2. **차이점 식별** (가중치 필요)
3. **상호 보완적인 강점**: 백엔드 로직은 Codex를 따르고, 프론트엔드 디자인은 Gemini를 따릅니다.
4. **논리적 추론**: 솔루션의 논리적 간극을 제거합니다.

#### 2.3 (선택 사항이지만 권장) 듀얼 모델 계획 초안

Claude의 합성 계획에서 누락 위험을 줄이기 위해, 두 모델이 "계획 초안"을 출력하도록 병렬로 할 수 있습니다 (여전히 파일 수정은 **허용되지 않음**):

1. **Codex 계획 초안** (백엔드 권한):
   - ROLE_FILE: `~/.claude/.ccg/prompts/codex/architect.md`
   - 출력: 단계별 계획 + 의사 코드 (초점: 데이터 흐름/엣지 케이스/오류 처리/테스트 전략)

2. **Gemini 계획 초안** (프론트엔드 권한):
   - ROLE_FILE: `~/.claude/.ccg/prompts/gemini/architect.md`
   - 출력: 단계별 계획 + 의사 코드 (초점: 정보 아키텍처/상호 작용/접근성/시각적 일관성)

`TaskOutput`으로 두 모델의 완료된 결과를 기다리고, 제안의 주요 차이점을 기록합니다.

#### 2.4 구현 계획 생성 (Claude 최종 버전)

두 분석을 종합하여 **단계별 구현 계획**을 생성합니다:

```markdown
## 구현 계획: <작업 이름>

### 작업 유형
- [ ] 프론트엔드 (→ Gemini)
- [ ] 백엔드 (→ Codex)
- [ ] 풀스택 (→ 병렬)

### 기술 솔루션
<Codex + Gemini 분석에서 종합된 최적 솔루션>

### 구현 단계
1. <1단계> - 예상 결과물
2. <2단계> - 예상 결과물
...

### 주요 파일
| 파일 | 작업 | 설명 |
|------|-----------|-------------|
| path/to/file.ts:L10-L50 | 수정 | 설명 |

### 위험 및 완화
| 위험 | 완화 |
|------|------------|

### SESSION_ID (ccg:execute용)
- CODEX_SESSION: <session_id>
- GEMINI_SESSION: <session_id>
```

### 2단계 종료: 계획 전달 (실행 아님)

**`/ccg:plan` 책임은 여기서 종료됩니다. 반드시 다음 작업을 실행해야 합니다**: 

1. 사용자에게 전체 구현 계획을 제시합니다 (의사 코드 포함).
2. 계획을 `.claude/plan/<기능-이름>.md`에 저장합니다 (요구사항에서 기능 이름을 추출하여, 예: `user-auth`, `payment-module`).
3. **굵은 텍스트**로 프롬프트를 출력합니다 (실제 저장된 파일 경로를 사용해야 함):

---
**계획이 생성되어 `.claude/plan/actual-feature-name.md`에 저장되었습니다.**

**위 계획을 검토해 주세요. 다음을 할 수 있습니다:**
- **계획 수정**: 조정할 내용을 알려주시면 계획을 업데이트하겠습니다.
- **계획 실행**: 다음 명령어를 새 세션에 복사하여 붙여넣으세요.

```
/ccg:execute .claude/plan/actual-feature-name.md
```
---

**위의 `actual-feature-name.md`는 실제 저장된 파일 이름으로 반드시 교체해야 합니다!**

4. **현재 응답을 즉시 종료합니다** (여기서 중지. 더 이상 도구 호출 없음).

**절대 금지**: 
- 사용자에게 "Y/N"을 묻고 자동 실행 (실행은 `/ccg:execute`의 책임입니다).
- 프로덕션 코드에 대한 쓰기 작업.
- `/ccg:execute` 또는 모든 구현 작업 자동 호출.
- 사용자가 명시적으로 수정을 요청하지 않았을 때 모델 호출 계속.

---

## 계획 저장

계획이 완료된 후 다음 위치에 저장합니다:

- **최초 계획**: `.claude/plan/<기능-이름>.md`
- **반복 버전**: `.claude/plan/<기능-이름>-v2.md`, `.claude/plan/<기능-이름>-v3.md`...

계획 파일 쓰기는 사용자에게 계획을 제시하기 전에 완료되어야 합니다.

---

## 계획 수정 흐름

사용자가 계획 수정을 요청하는 경우:

1. 사용자 피드백을 기반으로 계획 내용을 조정합니다.
2. `.claude/plan/<기능-이름>.md` 파일을 업데이트합니다.
3. 수정된 계획을 다시 제시합니다.
4. 사용자에게 다시 검토하거나 실행하도록 안내합니다.

---

## 다음 단계

사용자가 승인한 후, **수동으로** 다음을 실행합니다:

```bash
/ccg:execute .claude/plan/<기능-이름>.md
```

---

## 핵심 규칙

1. **계획만, 구현은 없음** – 이 명령어는 코드 변경을 실행하지 않습니다.
2. **Y/N 프롬프트 없음** – 계획만 제시하고 사용자에게 다음 단계를 결정하도록 합니다.
3. **규칙 신뢰** – 백엔드는 Codex를 따르고, 프론트엔드는 Gemini를 따릅니다.
4. 외부 모델은 파일 시스템 쓰기 액세스가 **전혀 없습니다**.
5. **SESSION_ID 전달** – 계획에는 `/ccg:execute resume <SESSION_ID>` 사용을 위해 끝에 `CODEX_SESSION` / `GEMINI_SESSION`이 포함되어야 합니다.

1. 1

   SKILL.md 저장

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

   SKILL.md 복사

   macOSLinuxWindows

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

   호출

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

   예) 다중 모델을 협력하여 구현할 때 유용합니다

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