claude-devfleet

name	claude-devfleet
description	Claude DevFleet를 통해 멀티 에이전트 코딩 작업을 오케스트레이션합니다. 프로젝트를 계획하고, 격리된 worktree에 병렬 에이전트를 dispatch하고, 진행 상황을 모니터링하고, 구조화된 리포트를 읽습니다.
origin	community

Claude DevFleet 멀티 에이전트 오케스트레이션

사용 시점

여러 Claude Code 에이전트를 병렬로 돌려 코딩 작업을 처리해야 할 때 이 스킬을 사용합니다. 각 에이전트는 전체 도구 세트를 갖춘 격리된 git worktree에서 실행됩니다.

MCP로 연결된 Claude DevFleet 인스턴스가 실행 중이어야 합니다.

claude mcp add devfleet --transport http http://localhost:18801/mcp

동작 방식

사용자 → "인증과 테스트가 있는 REST API를 만들어줘"
  ↓
plan_project(prompt) → project_id + mission DAG
  ↓
계획을 사용자에게 보여주고 승인 받기
  ↓
dispatch_mission(M1) → Agent 1이 worktree에서 시작
  ↓
M1 완료 → 자동 머지 → M2 자동 dispatch (M1 의존)
  ↓
M2 완료 → 자동 머지
  ↓
get_report(M2) → files_changed, what_done, errors, next_steps
  ↓
사용자에게 보고

도구

Tool	Purpose
plan_project(prompt)	설명을 연쇄 mission이 있는 프로젝트로 분해
create_project(name, path?, description?)	수동으로 프로젝트 생성, project_id 반환
create_mission(project_id, title, prompt, depends_on?, auto_dispatch?)	mission 추가
dispatch_mission(mission_id, model?, max_turns?)	mission에 에이전트 시작
cancel_mission(mission_id)	실행 중 mission 중지
wait_for_mission(mission_id, timeout_seconds?)	mission 완료까지 대기
get_mission_status(mission_id)	블로킹 없이 진행 상황 확인
get_report(mission_id)	구조화된 리포트 읽기
get_dashboard()	실행 중 에이전트, 통계, 최근 활동 개요
list_projects()	전체 프로젝트 목록
list_missions(project_id, status?)	프로젝트 내 mission 목록

wait_for_mission은 대화를 길게 막을 수 있으므로, 장기 실행 mission은 30~60초 간격의 get_mission_status 폴링을 우선합니다.

워크플로: 계획 → 실행 → 모니터링 → 보고

1. 계획: plan_project(prompt="...") 호출
2. 계획 공유: mission 제목, 유형, 의존 체인을 사용자에게 보여줌
3. 실행: 루트 mission을 dispatch_mission으로 시작
4. 모니터링: get_mission_status() 또는 get_dashboard()로 진행 확인
5. 보고: 완료 후 get_report()를 읽고 핵심 내용을 사용자에게 공유

동시성

DevFleet는 기본적으로 최대 3개 동시 에이전트를 실행합니다. 슬롯이 가득 차면 auto_dispatch=true mission은 대기열에 들어가고 슬롯이 비면 자동 실행됩니다.

예시

전체 자동: 계획 후 실행

1. plan_project(prompt="...") 실행
2. 의존성이 없는 첫 mission을 dispatch
3. 나머지는 의존성이 풀리면 자동 dispatch
4. 프로젝트 ID와 mission 수를 사용자에게 알려줌
5. 모든 mission이 종료 상태가 될 때까지 상태를 폴링
6. 각 종료 mission의 get_report()를 읽고 성공/실패와 다음 단계를 요약

수동: 단계별 제어

1. create_project(name="My Project")
2. create_mission(...)으로 루트 mission과 후속 mission 작성
3. 첫 mission에 dispatch_mission(...)
4. 완료 후 get_report(...)

순차 + 리뷰

1. create_project(name="...")
2. 구현 mission 생성
3. dispatch_mission(...) 후 완료까지 폴링
4. get_report(...)로 결과 검토
5. 구현 mission을 의존하는 리뷰 mission 생성

가이드라인

• 사용자가 바로 진행하라고 하지 않은 한 dispatch 전에 계획을 확인받습니다.
• 상태 보고 시 mission 제목과 ID를 함께 제공합니다.
• mission이 실패하면 재시도 전에 반드시 리포트를 읽습니다.
• 대량 dispatch 전에 get_dashboard()로 슬롯 사용량을 확인합니다.
• mission 의존성은 DAG여야 하며 순환을 만들지 않습니다.
• 각 에이전트는 격리된 git worktree에서 실행되고 완료 시 자동 머지됩니다. 충돌이 나면 변경은 에이전트 worktree 브랜치에 남아 수동 해결 대상이 됩니다.