Claude Code 멀티 에이전트 토론 시스템
여러 전문가 에이전트가 동시에 토픽을 분석하고, 라운드별 토론을 거쳐 CEO 에이전트가 최종 결정을 내리는 의사결정 도구입니다.
Round 1: 시장분석가 ──┐
기술리드 ──┼──→ (병렬 분석)
악마의변호인──┘
Round 2: 각 에이전트가 다른 에이전트 의견을 읽고 반박/수정
Round N: (반복)
↓
최종 종합: CEO가 모든 라운드를 검토 후 결정 내림
- Claude Code CLI 설치 및 인증
- Node.js 18+
- Bash (macOS / Linux)
git clone https://github.com/your-org/round-table.git
cd round-table
# 환경변수 설정
cp .env.example .env
# .env 파일을 열어 CLAUDE_CODE_OAUTH_TOKEN 입력토큰 확인:
claude auth status
# 또는 ~/.zshrc에 이미 CLAUDE_CODE_OAUTH_TOKEN이 있으면 자동 인식./orchestrator.sh "토픽" [라운드수] [에이전트목록] [프로젝트경로]예시:
# 기본 (3명, 2라운드, 현재 디렉토리)
./orchestrator.sh "AI 기능을 추가해야 하는가?"
# 4라운드, 4명 참여
./orchestrator.sh "pub.dev 패키지 공개 전략" 4 "analyst,developer,critic,financial"
# 특정 프로젝트 경로 지정
./orchestrator.sh "아키텍처 개선 방향" 3 "developer,critic,strategist" /path/to/projectcd web
node server.js # 기본 포트 3847
node server.js 8080 # 포트 지정브라우저에서 http://localhost:3847 접속
| ID | 이름 | 역할 |
|---|---|---|
analyst |
시장 분석가 | WebSearch로 시장 데이터·경쟁사 분석 |
developer |
기술 리드 | 코드베이스 확인, 기술적 실현 가능성 평가 |
critic |
악마의 변호인 | 반론·리스크·대안 제시 |
designer |
UX 디자이너 | 사용자 경험·플로우·모바일 UX 분석 |
financial |
재무 분석가 | 비용·수익·ROI·손익분기점 산출 |
strategist |
장기 전략가 | 포지셔닝·경쟁 우위·포트폴리오 영향 분석 |
| 변수 | 필수 | 설명 |
|---|---|---|
CLAUDE_CODE_OAUTH_TOKEN |
✅ | Claude Code 인증 토큰 |
CLAUDE_BIN |
❌ | claude CLI 경로 (자동 탐지) |
PROJECT_DIR |
❌ | 워크스페이스 루트 (기본: round-table 상위) |
PORT |
❌ | 웹 UI 포트 (기본: 3847) |
round-table/
├── orchestrator.sh # 토론 오케스트레이터
├── code-review-orchestrator.sh # 코드 리뷰 오케스트레이터
├── task-orchestrator.sh # 태스크 오케스트레이터
├── .env.example
├── .gitignore / .claudeignore # sessions/, logs/ 모두 제외
├── README.md
├── sessions/ # 모든 세션 산출물 (gitignore)
│ ├── latest -> 20260424_.../ # 최근 토론 세션 심링크
│ ├── 20260324_093318/ # 토론 세션
│ │ ├── meta.json
│ │ ├── SUMMARY.md # 세션 전체 요약 (자동 생성)
│ │ ├── logs/ # 이 세션의 모든 실행 로그
│ │ ├── round-1/*.md
│ │ ├── round-2/...
│ │ ├── final/synthesis.md
│ │ └── conclusion.md
│ ├── code-review/
│ │ ├── latest -> <id>/
│ │ └── <SESSION_ID>/ # MD + JSON + logs/ 통합
│ │ ├── meta.json, agents.json
│ │ ├── SUMMARY.md
│ │ ├── logs/
│ │ ├── round-N/
│ │ └── final/
│ └── tasks/
│ ├── latest -> <id>/
│ └── <SESSION_ID>/...
├── logs/ # 서버 전역 로그만 (server.log 등)
└── web/
├── server.js
├── index.html
└── package.json
한 세션 = 한 폴더: 모든 산출물·로그가 세션 디렉토리 안에 모여 있어서 세션 하나를 통째로 확인·삭제·백업하기 쉽습니다.
sessions/<type>/latest심링크로 가장 최근 세션에 바로 접근할 수 있습니다.
결론 파일(sessions/*/conclusion.md)은 항상 다음 형식으로 출력됩니다:
### 최종 결정: [실행 / 조건부 실행 / 보류 / 기각]
### 핵심 근거
### 채택한 인사이트 (에이전트별 표)
### 실행 액션 플랜 (즉시 / 단기 / 중기)
### 리스크 완화 방안
### 의사결정 번복 조건MIT