Orquestração Multi-Agente Claude DevFleet

Quando Usar

Use esta habilidade quando precisar despachar múltiplos agentes Claude Code para trabalhar em tarefas de codificação em paralelo. Cada agente roda em um worktree git isolado com ferramentas completas.

Configuração

O servidor DevFleet é um projeto separado, não incluído no ECC. Instale e execute-o a partir de seu repositório primeiro: https://github.com/LEC-AI/claude-devfleet

Em seguida, conecte a instância em execução via MCP:

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

Antes do primeiro uso, verifique se o processo escutando na porta 18801 é o binário DevFleet que você instalou (veja SECURITY.md em servidores MCP locais).

Como Funciona

User → "Build a REST API with auth and tests"
  ↓
plan_project(prompt) → project_id + mission DAG
  ↓
Show plan to user → get approval
  ↓
dispatch_mission(M1) → Agent 1 spawns in worktree
  ↓
M1 completes → auto-merge → auto-dispatch M2 (depends_on M1)
  ↓
M2 completes → auto-merge
  ↓
get_report(M2) → files_changed, what_done, errors, next_steps
  ↓
Report back to user

Ferramentas

Nota sobre wait_for_mission: Isso bloqueia a conversa por até timeout_seconds (padrão 600). Para missões de longa duração, prefira fazer polling com get_mission_status a cada 30–60 segundos, para que o usuário veja atualizações de progresso.

Fluxo de Trabalho: Planejar → Despachar → Monitorar → Relatar

1. Planejar: Chame plan_project(prompt="...") → retorna project_id + lista de missões com cadeias de depends_on e auto_dispatch=true.
2. Mostrar plano: Apresente os títulos das missões, tipos e cadeia de dependência ao usuário.
3. Despachar: Chame dispatch_mission(mission_id=<first_mission_id>) na missão raiz (depends_on vazio). Missões restantes são despachadas automaticamente à medida que suas dependências são concluídas (porque plan_project define auto_dispatch=true nelas).
4. Monitorar: Chame get_mission_status(mission_id=...) ou get_dashboard() para verificar o progresso.
5. Relatar: Chame get_report(mission_id=...) quando as missões forem concluídas. Compartilhe os destaques com o usuário.

Concorrência

O DevFleet executa até 3 agentes simultâneos por padrão (configurável via DEVFLEET_MAX_AGENTS). Quando todos os slots estão preenchidos, missões com auto_dispatch=true são enfileiradas no monitor de missões e despachadas automaticamente à medida que os slots ficam livres. Verifique get_dashboard() para o uso atual dos slots.

Exemplos

Totalmente automático: planejar e lançar

1. plan_project(prompt="...") → mostra o plano com missões e dependências.
2. Despache a primeira missão (aquela com depends_on vazio).
3. Missões restantes são despachadas automaticamente à medida que as dependências são resolvidas (elas têm auto_dispatch=true).
4. Relate de volta com o ID do projeto e a contagem de missões para que o usuário saiba o que foi lançado.
5. Faça polling com get_mission_status ou get_dashboard() periodicamente até que todas as missões atinjam um estado terminal (completed, failed ou cancelled).
6. get_report(mission_id=...) para cada missão terminal — resuma os sucessos e destaque as falhas com erros e próximos passos.

Manual: controle passo a passo

1. create_project(name="My Project") → retorna project_id.
2. create_mission(project_id=project_id, title="...", prompt="...", auto_dispatch=true) para a primeira missão (raiz) → capture root_mission_id. create_mission(project_id=project_id, title="...", prompt="...", auto_dispatch=true, depends_on=["<root_mission_id>"]) para cada tarefa subsequente.

…