Start an agent team (3-5 teammates) in tmux panes for parallel collaborative work. Use when tasks can be parallelized across multiple files or concerns like review, testing, refactoring, or analysis. Also trigger when the user asks to work on multiple things at once, speed up a large task, or mentions "팀", "병렬", "parallel", "동시에", "나눠서".
병렬 작업을 위한 에이전트 팀을 생성하고 관리한다.
Input: $ARGUMENTS
팀을 만들기 전에 작업을 어떻게 나눌지 먼저 결정한다. 잘못된 분해는 충돌과 재작업을 유발하므로 이 단계가 가장 중요하다.
분해 전략:
| 전략 | 적합한 상황 | 예시 |
|---|---|---|
| 파일/모듈 기준 | 서로 다른 파일을 독립적으로 수정 | API 리팩토링 → routes, controllers, middleware 각각 |
| 관심사 기준 | 같은 코드를 다른 관점에서 분석 | 코드 리뷰 → security, performance, test-coverage |
| 파이프라인 기준 | 순차 단계를 병렬 준비 | 배포 준비 → lint 수정 + 테스트 작성 + 문서 업데이트 |
핵심 원칙:
기존 팀이 있으면 재사용한다. 없을 때만 TeamCreate로 새 팀을 생성한다 (team_name 지정).
각 teammate에 대해 순서대로:
team_name과 name 파라미터를 반드시 지정해야 tmux pane에 표시된다teammate의 메시지는 자동으로 전달된다. 모든 작업 완료 후 결과를 통합하여 사용자에게 보고한다.
teammate는 현재 대화 이력을 전혀 공유하지 않는다. 방금 합류한 동료에게 브리핑하듯 충분한 컨텍스트를 담아야 한다. 컨텍스트가 부족하면 teammate가 엉뚱한 방향으로 작업하거나 다시 질문하느라 시간을 낭비한다.
포함할 내용:
좋은 예시:
src/api/handlers/ 디렉토리의 Go 핸들러 에러 처리를 개선해줘.
배경: 현재 에러 시 500만 반환하고 로그가 없어 디버깅이 어렵다.
담당 범위: src/api/handlers/*.go 파일만
수정 금지: src/api/middleware/, src/api/routes.go
컨벤션: 에러 로깅은 slog 사용, HTTP 응답은 기존 errorResponse() 헬퍼 사용
완료 조건: 모든 핸들러에서 에러 시 적절한 로그와 HTTP 상태 코드 반환
각 teammate가 독립된 모듈/패키지를 담당한다. 모듈 간 인터페이스가 변경되는 경우, 인터페이스 정의를 먼저 합의한 뒤 각자 구현하도록 프롬프트에 인터페이스 명세를 포함한다.
각자 다른 관점에서 동일 코드베이스를 분석하고, 결과를 종합하여 보고한다.
SendMessage로 추가 컨텍스트를 제공하거나 작업 범위를 조정한다. 새 teammate를 만들지 말고 기존 teammate를 안내한다.
한 teammate의 작업을 먼저 완료시킨 후, 다른 teammate에게 변경된 상태를 SendMessage로 알려준다.
선행 작업이 완료되면 SendMessage로 후속 teammate에게 결과와 필요한 정보를 전달한다.
team_name이 TeamCreate의 team_name과 일치해야 한다