🎉 0.2.0은 첫 정식 기능 릴리스입니다. 실제 동작하는
skills/discuss/SKILL.md, 에이전트 정의 9종, 라우팅·페르소나 규칙이 부트스트랩 한 번에 깔립니다. 추천안 우선 흐름과 4단계 커스터마이즈 위저드 모두 활성 상태입니다. 다음 마일스톤은 로드맵 참고.
대부분의 Claude Code 다중 에이전트 셋업은 고정된 팀원과 "결국엔 다 합의함" 패턴으로 끝납니다. 이 키트는 그 반대 방향을 택했습니다.
| 제공 | 의미 |
|---|---|
| 에이전트 9종 (researcher / planner / coder / qa / scout / searcher / designer / docs / gitops) | "전문가 N" 같은 추상적 역할이 아니라 명확한 책임 분리 |
| 에이전트당 3종 페르소나 = 총 27가지 조합 | Conservative / Innovative / Balanced — 세션마다, 에이전트마다 개별 선택 |
| 비판 모드 4종 (cooperative / standard / critical / devil's-advocate) | 동의가 필요할 때는 동의, 반대가 필요할 때는 반대 강제 |
| Step 0.6 추천안 우선 흐름 | 키트가 팀 설정을 추천 → 그대로 진행하거나 4단계로 커스터마이즈 |
| SKILL_DEPTH=1 재귀 가드 | 토론 안에서 또 토론이 열리는 무한 중첩 방지 |
| Mem0 T06 / T07 이력 (선택) | 과거 합의·반박이 다음 토론에 자동 주입 |
| 로컬 파일 fallback | Mem0 없어도 동작. 이력은 ~/.claude/discuss-history/ 에 저장 |
💻 플랫폼 요구사항 Linux 또는 macOS, Bash ≥ 4.0. macOS는 기본이 Bash 3.2라 동작 불가 — Homebrew(
brew install bash)로 Bash 4+ 설치 후/opt/homebrew/bin/bash install.sh로 실행하세요. Windows 사용자는 WSL2 권장.
curl -fsSL https://raw.githubusercontent.com/DaeSeokSong/claude-discuss-kit/main/install.sh | bash설치 과정에서 자동 수행:
- Claude Code ≥ 2.0.0 설치 확인
- 선택 의존성(Mem0, tmux) 감지 후 상태 보고
- 충돌하는 기존 파일을
~/.claude.backup-<timestamp>/로 백업 - 키트 파일을
~/.claude/에 복사 - smoke-test 실행
git clone https://github.com/DaeSeokSong/claude-discuss-kit.git
cd claude-discuss-kit
bash install.sh --dry-run # 변경 사항 미리보기 (실제 수정 0)
bash install.sh # 대화형 설치플러그인 시스템 지원 빌드라면:
claude plugin install https://github.com/DaeSeokSong/claude-discuss-kit(매니페스트 형식은 .claude-plugin/marketplace.json 참조)
설치 후 새 Claude Code 세션을 열고 다음과 같이 입력하세요:
/discuss "A 방식과 B 방식 중 어느 쪽을 선택해야 할까?"
키트가 추천안 우선 형태로 응답합니다:
추천 셋업
팀: planner (critical) + qa (devil's-advocate) + coder (standard)
페르소나: conservative / balanced / balanced
라운드: ≤ 2
[1] 이대로 진행
[2] 커스터마이즈 (4단계 위저드)
Stage 1 (pool 선택) → Stage 2 (team 구성) → Stage 3 (에이전트별 persona) → Stage 4 (에이전트별 critique mode).
각 단계는 수 초 안에 끝나며, 모든 결정권은 사용자에게 있습니다.
| 의존 항목 | 필수 여부 | 없을 때 동작 |
|---|---|---|
| Claude Code CLI ≥ 2.0.0 | 필수 | 설치 중단 |
bash ≥ 4.0 |
필수 | 설치 중단. macOS는 brew install bash 필요 |
| Mem0 MCP | 선택 | ~/.claude/discuss-history/ 로컬 파일에 이력 저장 |
| tmux | 선택 | 패널 시각화 비활성, 텍스트 출력만 |
| Tavily MCP | 선택 | searcher 에이전트가 WebFetch / WebSearch로 fallback |
| Atlassian MCP | 선택 | docs 에이전트는 로컬 markdown만 작성 |
설치 시 각 선택 의존성을 자동 감지하고 한 줄 상태로 보고합니다. 조용히 실패하는 경우는 없습니다.
전체 카탈로그는 claude/rules/agent-personas.md 에 있습니다. 핵심 라인업:
| 에이전트 | Conservative | Innovative | Balanced |
|---|---|---|---|
| researcher | citation-strict (인용 엄격) | novelty-seeking (새로움 추구) | tradeoff-mapper (균형 분석) |
| planner | risk-averse (위험 회피) | ambitious-scope (대담한 범위) | phased-rollout (단계 적용) |
| coder | defensive-coding (방어적 코딩) | refactor-eager (적극 리팩토링) | minimal-diff (최소 변경) |
| qa | regression-paranoid (회귀 강박) | edge-case-hunter (엣지 케이스 추적) | coverage-balanced (커버리지 균형) |
| scout | precise-grep (정밀 검색) | wide-search (광범위 탐색) | layered-lookup (단계별 탐색) |
| searcher | high-precision-low-recall (정밀도 우선) | broad-survey (광범위 서베이) | source-diverse (소스 다양성) |
| designer | accessibility-first (접근성 우선) | novel-visual (참신한 시각) | clarity-balanced (명료성 균형) |
| docs | strict-template (엄격 템플릿) | narrative (서사형) | structured-narrative (구조형 서사) |
| gitops | clean-history (히스토리 정돈) | rapid-merge (빠른 머지) | feature-flag-aware (기능 플래그 인지) |
| 모드 | 사용 시점 |
|---|---|
cooperative |
브레인스토밍 — 에이전트들이 서로의 의견을 쌓아 올림 |
standard |
기본값 — 합리적 지점에서 반대하고 가능한 지점에서 수렴 |
critical |
스트레스 테스트 — 라운드마다 위험 요인 최소 1개 노출 강제 |
devil's-advocate |
반대 강제 — 최소 1명이 합의에 무조건 반대. 아키텍처 결정·사전 부검(pre-mortem)에 유용 |
에이전트별로 개별 설정 가능. 혼합 가능 (예: coder=standard, qa=devil's-advocate, planner=critical).
~/.claude/
├── skills/discuss/SKILL.md # ~790줄 — 추천안 우선 흐름 + 4단계 위저드 전체
├── commands/discuss.md # 얇은 wrapper
├── agents/
│ ├── INDEX.md # 10줄 카탈로그
│ ├── researcher.md / planner.md / coder.md / qa.md
│ ├── scout.md / searcher.md / designer.md / docs.md / gitops.md
├── rules/
│ ├── agent-routing.md # TeamCreate vs Agent 결정, SKILL_DEPTH 가드
│ └── agent-personas.md # 페르소나 27종 × 비판 모드 4종
└── rules-lazy/
└── mem0-templates.md # T06 (합의 저장) + T07 (이전 토론 검색) + 로컬 fallback
총 15개 파일, 약 2700줄. 실제 변경 전에 install.sh --dry-run 으로 미리 확인하세요.
bash uninstall.sh # 키트가 깐 파일만 제거
bash uninstall.sh --restore ~/.claude.backup-* # install이 만든 백업 복원uninstall.sh 는 이 키트가 설치한 파일만 건드립니다. ~/.claude/ 의 다른 파일은 그대로 둡니다.
| 버전 | 범위 | 상태 |
|---|---|---|
| 0.1.1 | 스켈레톤, 라이선스, 부트스트랩, manifest, smoke-test, Bash 4+ 가드 | ✅ 출시 |
| 0.2.0 | 실제 SKILL.md, 에이전트 정의 9종, 페르소나 카탈로그, 비판 모드, Mem0 T06/T07 템플릿 |
✅ 출시 |
| 0.3.0 | 예시 갤러리, 이력 뷰어, Mem0 fallback 다듬기, 페르소나 자동 튜닝 | 🚧 진행 예정 |
| 0.4.0 | tmux 패널 모드, 영상 데모, 다국어 prompt 템플릿 | 📋 계획 |
| 0.5.0 | 플러그인 marketplace 등재, Tavily/Atlassian 어댑터 (선택) | 📋 계획 |
| 1.0.0 | 안정성 freeze, semver 보장, 기여 가이드 | 🎯 목표 |
examples/ 폴더에 실전 토론 transcript가 차례로 추가될 예정 (0.3.0):
architecture-discussion.md— baseline 선택 결정 전 토론code-review-discussion.md— qa devil's-advocate vs coder 충돌paper-critique.md— researcher + searcher + qa로 논문 주장 검증hyperparameter-debate.md— planner 단계 적용 vs coder 리팩토링
Issue·PR 환영합니다. 0.2.0 피드백은 feedback-0.2.0 라벨로 issue 등록 부탁드립니다.
git clone https://github.com/DaeSeokSong/claude-discuss-kit.git
cd claude-discuss-kit
bash install.sh --dry-run # 실제 쓰기 0
bash tests/smoke-test.sh /tmp/fake # 임시 디렉터리에 smoke-testApache License 2.0. 표시 의무는 NOTICE 참고.
Claude Code 에이전트 생태계의 패턴들을 토대로 구성했습니다. 영감을 받은 자료:
- Anthropic 엔지니어링 블로그 "Building effective agents"
- CrewAI / AutoGen 의 다중 에이전트 협업 프로토콜
- 소프트웨어 사전 부검(pre-mortem) 의 devil's advocate 관행
추천안 우선 + 4단계 커스터마이즈 흐름은 이 키트 고유 디자인입니다.
Claude Code 로 만든 @DaeSeokSong 의 키트
이 키트가 "정말 모두 합의한 거 맞나?" 고민하는 시간 몇 분이라도 줄여줬다면, ⭐ 별 하나로 알려주세요.