Debate

Debate Skill

> 중요 기술 결정 시 다각도 검증을 위한 교차 모델 토론 스킬. > 3가지 모드 중 환경에 맞는 방식을 자동 선택하여 최대 3라운드 진행 후 합의 도출.

---

목적

| 목적 | 설명 | |------|------| | 다각도 검증 | 단일 관점의 맹점 제거 | | 설계 결정 강화 | 아키텍처 선택의 근거 명확화 | | 리스크 사전 발견 | 반론을 통한 잠재 문제 탐지 | | 팀 합의 촉진 | 토론 요약으로 의사결정 공유 |

---

모드 (3가지)

Mode 1: agent-teams (최상위)

Agent Teams로 팀원을 spawn하여 실시간 병렬 토론. Claude Max + CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 필요.

TeamCreate("debate-team")
  → Agent("advocate", team_name="debate-team")   # 찬성
  → Agent("critic", team_name="debate-team")     # 반대/비평
  → codex exec (Bash)                             # Codex 외부 관점
  ↓
라운드 1~3: SendMessage로 팀원 간 공방
  ↓
팀 리더(Claude)가 합의 도출
  ↓
TeamDelete("debate-team")

팀 구성:

| 팀원 | 역할 | 모델 | subagent_type | |------|------|------|---------------| | advocate | 입장 A 지지, 근거 제시 | sonnet | general-purpose 또는 code-forge:architect | | critic | 입장 B 반론, 가혹한 비평 | sonnet | code-forge:critic | | codex | 외부 모델 관점 (Bash로 실행) | gpt-5.4 | Codex CLI |

팀 리더 역할 (Claude 본체):

• 주제 정의 및 입장 배분
• 각 라운드 SendMessage로 상대 주장 전달
• 3라운드 후 합의 도출 및 최종 판정

---

Mode 2: cross-model (Codex CLI)

Agent Teams 없이 Claude + Codex CLI headless 토론.

Claude (입장 A) ↔ Codex CLI (입장 B)
  ↓
라운드 1: 초기 주장
  ↓
라운드 2: 반론
  ↓
라운드 3: 재반론 + 합의 탐색
  ↓
합의 도출

Codex CLI 실행:

codex exec -s read-only "{프롬프트}"

---

Mode 3: self-debate (폴백)

Codex 미설정 시 Claude 내부 찬반 토론.

Claude (입장 A: 지지) ↔ Claude (입장 B: 반론)
  ↓
라운드 진행 (최대 3)
  ↓
메타 분석: 어떤 주장이 더 강한가?
  ↓
합의 도출

---

모드 선택

사용자에게 먼저 묻는다. 자동 선택하지 않는다.

"토론 모드를 선택해주세요:

1. agent-teams — Agent Teams로 팀원 병렬 토론 (Claude Max + 환경변수 필요)
2. cross-model — Codex CLI와 1:1 토론 (Codex 설치 필요)
3. self-debate — Claude 내부 찬반 토론 (별도 설정 불필요)

또는 /debate --mode {모드명}으로 바로 시작할 수 있습니다."

--mode 옵션이 있으면 질문 없이 해당 모드로 즉시 진행.

/debate --mode agent-teams  → Mode 1 즉시
/debate --mode cross-model  → Mode 2 즉시
/debate --mode self-debate  → Mode 3 즉시

선택된 모드의 사전 조건 미충족 시 안내 후 다른 모드 제안.

---

트리거 조건

| 트리거 | 반응 | |--------|------| | "debate", "토론", "검토" | 스킬 활성화 | | 아키텍처 선택이 2개 이상 | 자동 제안 | | thinking-model GROUND (복잡도 L) | 자동 호출 | | thinking-model ADAPT (2회 실패) | 대안 탐색용 호출 |

---

ARGUMENT 확인

$ARGUMENTS 없음 → 즉시 질문:

"어떤 기술적 결정을 토론할까요?

예시:
- 아키텍처 선택 (예: REST vs GraphQL)
- 상태 관리 전략 (예: Jotai vs Zustand)
- 설계 패턴 (예: 컨테이너/뷰 vs hooks 전용)
- 라이브러리 선택"

$ARGUMENTS 있음 → 모드 선택 후 진행

---

동작 흐름

Phase 1: 주제 정의

## 토론 주제

**결정 사항:** {기술적 결정 내용}
**맥락:** {현재 프로젝트 상황, 제약 조건}
**평가 기준:** {성능, 유지보수성, 팀 역량, 일정 등}

**입장 A:** {옵션 1 지지}
**입장 B:** {옵션 2 지지 / 반론}

---

Phase 2: 라운드 진행

각 라운드는 주장 → 반론 → 재반론 구조로 진행.

Agent Teams 모드 라운드 흐름

라운드 N:
  1. 팀 리더 → SendMessage(to="advocate", "라운드 N 주장을 제시해줘: {주제}")
  2. advocate 응답 수신
  3. 팀 리더 → SendMessage(to="critic", "다음 주장에 반론해줘: {advocate 주장}")
  4. critic 응답 수신
  5. 팀 리더 → codex exec (Bash)로 Codex 외부 관점 수집
  6. 다음 라운드에 이전 결과 전달

라운드 1: 초기 주장

### [입장 A] 주장

**핵심 주장:** {주요 근거}
**기술적 이점:** {구체적 장점}
**위험 완화:** {예상 단점 대응}

---

### [입장 B] 주장

**핵심 주장:** {주요 근거}
**기술적 이점:** {구체적 장점}
**위험 완화:** {예상 단점 대응}

라운드 2: 반론

### [입장 A] 반론

**[입장 B] 주장의 약점:** {구체적 지적}
**추가 근거:** {새로운 데이터/사례}

---

### [입장 B] 반론

**[입장 A] 주장의 약점:** {구체적 지적}
**추가 근거:** {새로운 데이터/사례}

라운드 3: 재반론 + 합의 탐색

### [입장 A] 재반론

**인정하는 부분:** {상대 주장 중 수용 가능한 부분}
**유지하는 핵심:** {양보 불가 근거}
**합의 가능 지점:** {절충안 제안}

---

### [입장 B] 재반론

**인정하는 부분:** {상대 주장 중 수용 가능한 부분}
**유지하는 핵심:** {양보 불가 근거}
**합의 가능 지점:** {절충안 제안}

---

Phase 3: 합의 도출

## 토론 결과

### 합의점

{양측이 동의한 핵심 사항}

### 미해결 논점

| 논점 | 입장 A | 입장 B | 해결 방법 |
|------|--------|--------|-----------|
| {논점 1} | {A 견해} | {B 견해} | {후속 조치} |

### 권장 결정

**결정:** {선택된 옵션}
**근거:** {주요 이유}
**조건:** {이 결정이 유효한 전제 조건}
**후속 조치:** {모니터링, 재검토 시점}

---

thinking-model 연계

| 상황 | 연계 방식 | |------|----------| | GROUND (복잡도 L) | 단순 분석으로 결론이 나지 않을 때 debate 호출 | | ADAPT (2회 실패) | 기존 접근 실패 시 debate로 대안 탐색 | | 설계 분기점 | 2개 이상 동등한 옵션 존재 시 자동 제안 |

---

출력 형식

토론 완료 후 반드시 아래 형식으로 요약 출력:

## Debate Summary

**주제:** {토론 주제}
**모드:** agent-teams / cross-model / self-debate
**라운드:** {실행된 라운드 수}/3
**참가자:** {참가 모델/에이전트 목록}

### 토론 요약

| 항목 | 입장 A | 입장 B |
|------|--------|--------|
| 핵심 주장 | ... | ... |
| 주요 근거 | ... | ... |
| 양보한 부분 | ... | ... |

### 합의점

- {합의 1}
- {합의 2}

### 미해결 논점

- {논점 1}: {간략 설명}

### 권장 결정

**{선택된 옵션}** - {핵심 근거 1-2문장}

---

금지 패턴

| 금지 | 이유 | |------|------| | 3라운드 초과 | 무한 토론 방지 | | 합의 없이 종료 | 반드시 권장 결정 도출 | | Codex 미설정 상태에서 cross-model 시도 | 폴백(self-debate) 사용 | | 편향된 입장 A 우대 | 공정한 토론 원칙 | | 주제 없이 시작 | Phase 1 완료 후 진행 |

---

참조 문서

| 문서 | 용도 | |------|------| | rules/thinking-model.md | GROUND/ADAPT 연계 | | instructions/multi-agent/coordination-guide.md | 멀티에이전트 협업 | | instructions/validation/forbidden-patterns.md | 금지 패턴 | | skills/codex/SKILL.md | Codex CLI 설정 | | skills/setup-agent-teams/SKILL.md | Agent Teams 환경 설정 |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ggombee
• Source: ggombee/code-forge
• License: MIT

Install and usage instructions live in the source repository linked above.