| 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 폴링을 우선합니다.
워크플로: 계획 → 실행 → 모니터링 → 보고
- 계획:
plan_project(prompt="...") 호출
- 계획 공유: mission 제목, 유형, 의존 체인을 사용자에게 보여줌
- 실행: 루트 mission을
dispatch_mission으로 시작
- 모니터링:
get_mission_status() 또는 get_dashboard()로 진행 확인
- 보고: 완료 후
get_report()를 읽고 핵심 내용을 사용자에게 공유
동시성
DevFleet는 기본적으로 최대 3개 동시 에이전트를 실행합니다. 슬롯이 가득 차면 auto_dispatch=true mission은 대기열에 들어가고 슬롯이 비면 자동 실행됩니다.
예시
전체 자동: 계획 후 실행
plan_project(prompt="...") 실행- 의존성이 없는 첫 mission을 dispatch
- 나머지는 의존성이 풀리면 자동 dispatch
- 프로젝트 ID와 mission 수를 사용자에게 알려줌
- 모든 mission이 종료 상태가 될 때까지 상태를 폴링
- 각 종료 mission의
get_report()를 읽고 성공/실패와 다음 단계를 요약
수동: 단계별 제어
create_project(name="My Project")create_mission(...)으로 루트 mission과 후속 mission 작성- 첫 mission에
dispatch_mission(...)
- 완료 후
get_report(...)
순차 + 리뷰
create_project(name="...")- 구현 mission 생성
dispatch_mission(...) 후 완료까지 폴링get_report(...)로 결과 검토- 구현 mission을 의존하는 리뷰 mission 생성
가이드라인
- 사용자가 바로 진행하라고 하지 않은 한 dispatch 전에 계획을 확인받습니다.
- 상태 보고 시 mission 제목과 ID를 함께 제공합니다.
- mission이 실패하면 재시도 전에 반드시 리포트를 읽습니다.
- 대량 dispatch 전에
get_dashboard()로 슬롯 사용량을 확인합니다.
- mission 의존성은 DAG여야 하며 순환을 만들지 않습니다.
- 각 에이전트는 격리된 git worktree에서 실행되고 완료 시 자동 머지됩니다. 충돌이 나면 변경은 에이전트 worktree 브랜치에 남아 수동 해결 대상이 됩니다.
