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 - 태스크 보드 및 진행 상태 확인