/fireauto-team-guide

name: fireauto-team-guide
description: >
  "팀 에이전트", "team agent", "병렬 작업", "parallel work", "워크스트림",
  "workstream", "여러 에이전트", "동시에 작업", "에이전트 팀",
  "에이전트 간 대화", "team chat", "컴퍼니", "company model" 등
  멀티 에이전트 병렬 작업이나 에이전트 간 협업 시 사용하세요.

컴퍼니 모델 팀 시스템

Claude Code 빌트인 팀 기능을 활용한 멀티 에이전트 협업 패턴.

핵심 개념: 컴퍼니 모델

회사처럼 동작하는 에이전트 조직:

• **CEO (메인 에이전트)**: 방향 설정, 태스크 분배, 승인/반려, 최종 검토
• **팀원 (서브 에이전트)**: 각자 담당 업무 수행, **서로 SendMessage로 실시간 논의**
• **공유 태스크 보드**: TaskCreate/TaskUpdate로 진행 상황 관리

빌트인 도구

| 도구 | 역할 | |------|------| | `TeamCreate` | 팀 생성, 공유 태스크 보드 초기화 | | `TeamDelete` | 팀 삭제 및 리소스 정리 | | `TaskCreate` | 태스크 등록 (담당자 지정) | | `TaskUpdate` | 태스크 상태 변경 | | `TaskList` | 전체 태스크 조회 | | `TaskGet` | 개별 태스크 상세 조회 | | `SendMessage` | 에이전트 간 DM (자동 전달, 유휴 에이전트도 깨움) | | `Agent` | 팀원 에이전트 스폰 (`team_name` 파라미터 필수) |

Git Worktree 격리

`Agent` 호출 시 `isolation: "worktree"` 옵션을 사용하면:

• 각 에이전트가 **독립된 git 브랜치 + 작업 디렉토리**에서 작업
• 서로의 코드 변경이 충돌하지 않음
• 완료 후 메인 브랜치에 순차적으로 병합
• 마치 각 개발자가 자기 PC에서 독립적으로 개발하는 것과 같음

에이전트 간 대화 (SendMessage)

핵심 차별점: 에이전트들이 **파일이 아닌 SendMessage로 직접 대화**합니다.

frontend-dev -> backend-dev:
  "UserProfile에 avatarUrl 필드 추가해줄 수 있어?"

backend-dev -> frontend-dev:
  "추가했어. nullable이니 fallback 처리 부탁."

frontend-dev -> CEO:
  "pagination 방식을 결정해주세요. offset vs cursor."

CEO -> all:
  "offset으로 가겠습니다."

병렬 vs 순차 판단

병렬 (컴퍼니 모델 적합)

• 독립적인 기능/페이지/API 개발
• 프론트엔드/백엔드 분리
• 대규모 리팩토링 (모듈별)

순차 (단일 에이전트 적합)

• 강한 의존성 (앞선 작업 결과가 다음 입력)
• 동일 파일 집중 수정
• 분할 오버헤드 > 작업 자체

팀 구성 가이드

| 시나리오 | 팀원 | 분할 기준 | |---------|------|----------| | API + 프론트 | 2명 | backend-dev, frontend-dev | | 풀스택 기능 | 3명 | backend, frontend, tester | | 대규모 리팩토링 | 4명 | type-lead, core, ui, test |

커맨드

• `/fireauto-team` - 팀 구성, 실행, 대화 관리 (대화 기능 통합)
• `/fireauto-team-status` - 태스크 보드 및 진행 상태 확인