Teams — Agent Teams 자동 구성 및 실행
Overview
사용자가 제시한 문제를 분석하여 적절한 Agent Teams를 자동으로 구성하고, 4가지 조율 패턴 중 최적 패턴을 선택하여 결과를 도출하는 편의 스킬이다. 단순 문제는 Agent Teams 없이 직접 해결하고, 복합 문제만 팀을 구성한다.
When to Use
- 사용자가
/teams {문제 설명}을 입력했을 때 /teams --pattern {패턴} {문제 설명}으로 조율 패턴을 지정할 수도 있다- 멀티 관점 분석, 대규모 구현, 설계 의사결정 등 여러 전문가의 협업이 필요한 문제에 적합
Prerequisites
- 특별한 전제조건 없음
- 코드 관련 작업 시 해당 프로젝트의 소스 코드 접근 가능 상태
Error Handling
- 팀 생성 실패 (TeamCreate 에러): 메인 세션에서 단독으로 문제를 해결한다. "Agent Teams 구성에 실패하여 단독으로 처리합니다" 안내
- Lead 생성 실패: 팀 생성 실패와 동일하게 단독 처리
- Teammate 무응답 (10분 이상): 해당 역할을 제외하고 나머지 결과로 진행, 결과에 제외된 역할 명시
- Lead 무응답: 메인 세션에서 단독으로 처리하며 fallback 사유 안내
Instructions
1단계: 문제 분석 및 복잡도 판정
사용자가 제시한 문제를 분석하여 복잡도를 판정한다.
단순 (Agent Teams 불필요) — 다음 조건을 모두 만족:
- 단일 관점으로 충분 (교차 검증 불필요)
- 변경/분석 범위가 1~2개 파일 이내
- 명확한 정답이 존재 (설계 트레이드오프 없음)
→ 메인 세션에서 직접 해결하고 결과를 출력한다. 이하 단계를 건너뛴다.
복합 (Agent Teams 필요) — 위 조건 중 하나라도 불충족:
- 다관점 분석/교차 검증이 유의미
- 넓은 범위 또는 병렬 작업 가능
- 트레이드오프가 존재하여 토론이 가치 있음
→ 2단계로 진행한다.
2단계: 조율 패턴 결정
--pattern 옵션이 지정되면 해당 패턴을 사용한다. 미지정 시 문제 유형에서 자동 추론한다.
4가지 조율 패턴
이 패턴은 BF Workflow의 Lead 스킬들과 공유한다. Canonical definition: CLAUDE.md — 조율 패턴
| 패턴 | 핵심 동작 | 적합한 문제 유형 | BF Lead |
|---|---|---|---|
| distribute | Lead가 작업을 분배 → 각 agent가 독립 수행 → Lead가 취합 | 병렬 구현, 대규모 리서치, 문서 생성 | bf-lead-plan |
| monitor | Lead가 agent를 스폰하고 진행 상황 모니터링 + 에스컬레이션 처리 | TDD 구현, 장시간 작업, 단계적 빌드 | bf-lead-implement |
| discourse | 독립 분석 → 교차 검증 → 합의/미합의 분리 | 코드 리뷰, 설계 의사결정, 아키텍처 분석 | bf-lead-review |
| sequence | Lead가 단계별로 순차 트리거, 분기만 수행 | 멀티 페이즈 파이프라인, 의존성 체인 | bf-lead-orchestrate |
자동 추론 규칙:
| 문제 유형 | 기본 패턴 |
|---|---|
| 코드 리뷰/분석 | discourse |
| 설계 의사결정 | discourse |
| 디버깅/조사 | discourse |
| 구현 (대규모, 병렬 가능) | distribute |
| 구현 (순차 의존성 있음) | monitor |
| 리서치/비교 | distribute |
| 멀티 페이즈 작업 | sequence |
3단계: 팀 구성 결정
조율 패턴과 문제 유형에 따라 역할, 인원, 모델을 결정한다. 아래 테이블은 가이드라인이며, 문제 특성에 따라 조정한다.
| 유형 | 인원 | 모델 배당 | 역할 예시 |
|---|---|---|---|
| 코드 리뷰/분석 | 2~3명 | 전원 opus | Reviewer-A, Reviewer-B, (Convention Guard) |
| 설계 의사결정 | 2~3명 | 전원 opus | Architect-A, Architect-B, (Domain Expert) |
| 디버깅/조사 | 2~3명 | opus + sonnet | Investigator(sonnet), Analyst(opus), (Reproducer(sonnet)) |
| 구현 (대규모) | 3~4명 | Lead opus, Impl sonnet | Lead, Implementer-A, Implementer-B, (Integrator) |
| 리서치/비교 | 2~4명 | 조사 sonnet, 종합 opus | Researcher-A(sonnet), Researcher-B(sonnet), Synthesizer(opus) |
제약:
- 최대 teammate 수: 5명 (Lead 포함)
- 분석/리뷰/설계 유형은 교차 검증 품질을 위해 opus 우선
- 구현/리서치 유형은 비용 효율을 위해 sonnet 작업자 + opus 종합자 패턴
4단계: 팀 생성 및 작업 배분
- TeamCreate로 팀을 생성한다 (team_name:
teams-{timestamp}형식). - Lead 에이전트를 생성한다:
- Task tool로 Lead 생성 (model: opus, subagent_type: general-purpose) - team_name 파라미터로 팀에 합류시킨다 - Lead에게 전달할 정보: - 원본 문제 설명 - 결정된 팀 구성 (역할, 인원, 모델) - 각 teammate에게 할당할 작업 내용 - Discourse 진행 지침 (아래 4단계 참조)
- Lead가 teammate를 생성한다:
- 각 역할에 맞는 모델로 teammate 생성 (Task tool의 model 파라미터 사용) - 모든 teammate에게 team_name 파라미터로 동일 팀에 합류시킨다 - TaskCreate로 각 teammate에게 작업을 할당한다
- 메인 세션은 Lead의 최종 결과만 수신한다 (컨텍스트 보존).
5단계: 조율 패턴 실행
선택된 조율 패턴에 따라 Lead가 다른 절차로 진행한다.
Discourse 패턴 (리뷰, 설계, 분석)
- 독립 작업: 각 teammate가 자신의 할당 작업을 독립적으로 수행한다.
- 결과 공유: Lead가 각 teammate의 결과를 수집한다.
- 교차 검증: Lead가 결과를 종합하여 teammate들에게 공유하고, teammate끼리 SendMessage로 직접 challenge/agree/보완한다.
- 합의 판정: Lead가 합의된 사항과 미합의 쟁점을 분리한다.
- 최종 종합: Lead가 결과를 정리하여 메인 세션에 전달한다.
Distribute 패턴 (병렬 구현, 리서치)
- 작업 분배: Lead가 문제를 독립 단위로 분할하여 각 teammate에게 할당한다.
- 병렬 실행: 각 teammate가 독립적으로 작업을 수행한다. (파일 겹침이 없도록 분배)
- "done" 수집: Lead가 각 teammate로부터 완료 신호를 수신한다.
- 취합 및 통합: Lead가 결과를 통합하고 불일치가 있으면 조정한다.
- 최종 결과: Lead가 통합 결과를 메인 세션에 전달한다.
Monitor 패턴 (TDD 구현, 장시간 작업)
- agent 스폰: Lead가 작업 agent를 스폰한다.
- 진행 모니터링: 각 agent로부터 "done" 또는 "stuck" 신호를 수신한다.
- 에스컬레이션 처리: "stuck" 수신 시 Lead가 판단하여 재시도 또는 접근 전환을 지시한다.
- 상태 업데이트: Lead가 진행 상태를 관리한다.
- 최종 보고: 모든 agent 완료 후 결과를 메인 세션에 전달한다.
Sequence 패턴 (멀티 페이즈 파이프라인)
- 단계 정의: Lead가 전체 작업을 순차 단계로 분해한다.
- 순차 트리거: 각 단계의 agent를 순서대로 스폰한다.
- 분기 판단: 각 단계 완료 신호에 따라 다음 단계를 결정한다.
- 파이프라인 완료: 모든 단계 완료 후 결과를 메인 세션에 전달한다.
공통: 쟁점 해소 프로토콜
모든 패턴에서 teammate 간 의견 충돌 시 동일한 프로토콜을 따른다:
- Teammate 직접 대화: SendMessage로 직접 challenge/agree/보완 → 합의 시 Lead에 결론만 보고
- 미합의 시 Lead 중재: 프로젝트 방향성 기준으로 판단 → Lead 결정으로 확정
- 그래도 미합의 → 버린다 (기록): 최종 결과에 "미합의 쟁점"으로 포함, 더 이상 토큰을 쓰지 않음
6단계: 결과 제시
메인 세션은 Lead로부터 받은 결과를 다음 구조로 사용자에게 출력한다:
## 결과 요약
{문제에 대한 핵심 결론 1~3줄}
## 합의 사항
- {팀원 전원이 동의한 결론/권장사항}
- ...
## 미합의 쟁점 (있는 경우)
| 쟁점 | 입장 A | 입장 B | 근거 |
|------|--------|--------|------|
| ... | ... | ... | ... |
## 권장 액션
1. {사용자가 취해야 할 구체적 다음 단계}
2. ...- 합의 사항이 명확하면 미합의 섹션은 생략한다.
- 구현 유형인 경우 코드 변경 사항을 직접 포함한다.
7단계: 정리
- Lead에게 shutdown_request를 보낸다 (Lead가 teammate들을 먼저 shutdown한 뒤 자신도 종료).
- 모든 teammate 종료를 확인한 뒤 TeamDelete로 팀을 삭제한다.
Fallback
- 팀 생성 실패 (TeamCreate 또는 Lead 생성 에러): 메인 세션에서 단독으로 문제를 해결한다. 사용자에게 "Agent Teams 구성에 실패하여 단독으로 처리합니다"를 알린다.
- Teammate 무응답 (10분 이상 미응답): 해당 역할을 제외하고 나머지 teammate 결과로 진행한다. 결과에 제외된 역할을 명시한다.
- Lead 무응답: 메인 세션에서 단독으로 처리하며 fallback 사유를 알린다.
Output Format
대화 출력만 생성한다. 별도 파일을 생성하지 않는다.