multi-ai-roundtable

Multi-AI Roundtable

실제 codex / gemini CLI 호출로 다각도 토론 → 합의 로드맵 → 병렬 에이전트 실행

What is this?

복잡한 프로젝트에서 단일 AI의 편향을 극복하기 위해, 실제 외부 AI CLI 바이너리(codex, gemini)를 Bash로 직접 호출하여 서로 다른 관점을 수집하고, 합의된 로드맵을 병렬 에이전트로 실행하는 Claude Code 플러그인입니다.

결정성 보장: Phase 2(토론 단계)는 항상 실제 CLI를 호출합니다. Claude 에이전트로의 폴백은 CLI가 미설치이거나 quota가 소진된 경우에만 발동하며, 발동 시 결과에 명확히 표기됩니다.

Prerequisites

Phase 2에서 실제 CLI 호출을 하려면 다음 중 적어도 하나가 PATH에 있어야 합니다:

• codex — OpenAI Codex CLI (codex --version으로 확인)
• gemini — Google Gemini CLI (gemini --version으로 확인)

둘 다 없으면 사용자 동의하에 Claude 에이전트 폴백으로만 진행됩니다 (이 경우 사실상 단일 모델 토론).

Workflow

Phase 1: 현황 분석 — 기존 프로젝트 구조와 콘텐츠 파악
Phase 2: 다자 토론 — 선택된 CLI(codex / gemini / 둘 다)를 Bash로 호출
         · CLI 사전 점검 (command -v)
         · 실패 시 1회 재시도 (quota 에러는 재시도 없이 즉시 폴백)
         · Claude Agent 폴백은 미설치 / quota / 반복실패 시에만
Phase 3: 로드맵 합성 — 토론 결과를 실행 가능한 계획으로 정리 (폴백 표기 포함)
Phase 4: 병렬 실행 — 최대 12개 에이전트 동시 실행
Phase 5: 검증 정리 — 교차 참조, 포맷 통일, 파일 정리

Use Cases

• 책/콘텐츠 재편성: 10챕터 → 12챕터 구조 개편, 신규 챕터 집필
• API 아키텍처 설계: 보안/성능 vs DX/UX 관점 균형
• 코드 리팩토링: 기술 부채 vs 확장성 트레이드오프
• 커리큘럼 설계: 교육학적 비평 + 학습 경험 최적화

Installation

Claude Code에서:

/install-plugin https://github.com/devncat/multi-ai-roundtable

Usage

/roundtable <프로젝트>                  # 기본: codex CLI만 사용
/roundtable --both <프로젝트>           # codex + gemini 둘 다 병렬
/roundtable --gemini-only <프로젝트>    # gemini CLI만 사용

또는 대화 중에 "3자 토론으로 검토해줘", "라운드테이블 해줘" 등으로 트리거.

슬래시 메뉴 힌트

/만 입력하면 다음 형식의 인자 힌트가 노출됩니다:

/roundtable [--both | --gemini-only] <프로젝트 경로 또는 설명>

Behavior Details

재시도 / 폴백 정책

상황	동작
CLI exit 0	결과 채택
CLI exit ≠ 0 + quota / rate-limit / 429	재시도 없이 즉시 Claude Agent 폴백
CLI exit ≠ 0 + 일반 에러	2~3초 대기 후 1회 재시도, 그래도 실패 시 폴백
CLI 미설치	사용자에게 폴백/중단 선택 요청

폴백된 입장은 결과 파일 헤더와 로드맵 토론 요약 표에 (Claude 폴백)로 명시됩니다.

작업 산출물

토론 단계에서 다음 파일이 .roundtable/ 디렉토리에 생성됩니다:

.roundtable/
├── codex-prompt.md / codex-output.md / codex-stderr.log
└── gemini-prompt.md / gemini-output.md / gemini-stderr.log

Plugin Structure

multi-ai-roundtable/
├── .claude-plugin/
│   └── plugin.json          # 플러그인 메타데이터
├── commands/
│   └── roundtable.md        # /roundtable 슬래시 명령어
├── skills/
│   ├── start-roundtable/
│   │   └── SKILL.md         # 세션 시작 시 스킬 안내
│   └── multi-ai-roundtable/
│       └── SKILL.md         # 메인 워크플로우 스킬
├── rules/
│   └── shared-rules.md      # 토론/실행/품질 + CLI 호출 규약
├── templates/
│   └── roadmap-template.md  # 로드맵 문서 템플릿
└── README.md

Proven Results

아카펠라 입문서 프로젝트:

• Input: 10챕터 초안
• Process: 2라운드 토론 → 12챕터 로드맵 → 13개 에이전트 병렬 실행
• Output: 12챕터 + 부록 완성 (신설 2챕터, 전 챕터 보강)
• Time: ~30분