← ClaudeAtlas

team-orchestratorlisted

Agent Teams 오케스트레이션 엔진 - 팀 구성, 작업 분배, 의존성 관리, 결과 집계
immacualate/claude-forge · ★ 4 · AI & Automation · score 80
Install: claude install-skill immacualate/claude-forge
## Overview team-orchestrator 스킬은 `/orchestrate` 커맨드의 핵심 엔진으로, Agent Teams를 구성하고 작업을 분배하며 결과를 집계하는 오케스트레이션 로직을 정의한다. ## 전제조건 - `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`를 `1`로 설정해야 동작 - 설정 위치: settings.json의 `env` 또는 셸 환경변수 - 미설정 시 TeamCreate 등 팀 도구 사용 불가 --- ## Team Composition ### 팀 크기 결정 최대 팀원 수: Lead 1 + Teammates 3 (총 4명) | 작업 규모 | 팀원 수 | 구성 | |-----------|---------|------| | 소 (파일 1-3개) | 1-2명 | 구현1 (+테스트1) | | 중 (파일 4-8개) | 2-3명 | 구현1-2 + 테스트1 | | 대 (파일 9개 이상) | 3명 | 구현2 + 테스트1 또는 패턴별 분리 | ### 역할 템플릿 **풀스택 기능 구현:** | 역할 | subagent_type | 담당 | |------|--------------|------| | Frontend Dev | general-purpose | UI 구현, 컴포넌트 | | Backend Dev | general-purpose | API, DB, 로직 | | QA Engineer | general-purpose | 테스트, E2E | **리팩토링:** | 역할 | subagent_type | 담당 | |------|--------------|------| | Analyzer | Explore | 코드 분석/계획 | | Implementer | general-purpose | 리팩토링 실행 | | Verifier | general-purpose | 테스트/검증 | **버그 조사:** | 역할 | subagent_type | 담당 | |------|--------------|------| | Investigator 1 | Explore | 코드 분석 | | Investigator 2 | Explore | 로그/환경 분석 | | Fixer | general-purpose | 수정 구현 | --- ## Task Distribution ### 파일 소유권 분리 (CRITICAL) 같은 파일을 2명이 편집하면 덮어쓰기가 발생한다. 반드시 팀원별로 파일 소유권을 분리한다. ``` 파일 소유권 결정 로직: 1. 변경 예상 파일 목록 생성 2. 파일별 모듈/도메인 분류 3. 도메인 단위로 팀원 배정 4. 공유 파일(types, config)은 한 팀원에게 독점 배정 ``` ### 작업 분해 규칙 팀원당 5-6개 Task를 배정한다. | Task 크기 | 판단 기준 | 설명 | |-----------|----------|------| | 너무 작음 | 조율 오버헤드 > 이점 | 하나로 합치기 | | 적절함 | 명확한 결과물이 있는 자체 포함 단위 | 함수, 테스트