Claude DevFleet

Orquestração Multiagente 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 executa 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 ouvindo na porta 18801 é o binário DevFleet que você instalou (veja SECURITY.md sobre servidores MCP em localhost).

Como Funciona

Usuário → "Crie uma API REST com autenticação e testes"
  ↓
plan_project(prompt) → project_id + DAG de missões
  ↓
Mostrar plano ao usuário → obter aprovação
  ↓
dispatch_mission(M1) → Agente 1 é iniciado no worktree
  ↓
M1 conclui → auto-merge → auto-despacho de M2 (depends_on M1)
  ↓
M2 conclui → auto-merge
  ↓
get_report(M2) → arquivos alterados, o que foi feito, erros, próximos passos
  ↓
Relatar ao usuário

Ferramentas

Ferramenta	Propósito
plan_project(prompt)	A IA divide uma descrição em um projeto com missões encadeadas
create_project(name, path?, description?)	Cria um projeto manualmente, retorna project_id
create_mission(project_id, title, prompt, depends_on?, auto_dispatch?)	Adiciona uma missão. depends_on é uma lista de IDs de missão (ex.: ["abc-123"]). Defina auto_dispatch=true para iniciar automaticamente quando as dependências forem atendidas.
dispatch_mission(mission_id, model?, max_turns?)	Inicia um agente em uma missão
cancel_mission(mission_id)	Para um agente em execução
wait_for_mission(mission_id, timeout_seconds?)	Bloqueia até que uma missão termine (veja nota abaixo)
get_mission_status(mission_id)	Verifica o progresso da missão sem bloquear
get_report(mission_id)	Lê o relatório estruturado (arquivos alterados, testados, erros, próximos passos)
get_dashboard()	Visão geral do sistema: agentes em execução, estatísticas, atividade recente
list_projects()	Lista todos os projetos
list_missions(project_id, status?)	Lista missões em um projeto

Nota sobre wait_for_mission: Isso bloqueia a conversa por até timeout_seconds (padrão 600). Para missões longas, 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 depends_on e auto_dispatch=true.
2. Mostrar plano: Apresente títulos, tipos e a cadeia de dependências das missões ao usuário.
3. Despachar: Chame dispatch_mission(mission_id=<id_da_primeira_missao>) na missão raiz (com depends_on vazio). As demais missões são despachadas automaticamente conforme 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 concorrentes por padrão (configurável via DEVFLEET_MAX_AGENTS). Quando todos os slots estão ocupados, missões com auto_dispatch=true entram em fila no watcher de missões e são despachadas automaticamente conforme os slots são liberados. Verifique get_dashboard() para o uso atual de slots.

Exemplos

Automático completo: planejar e lançar

1. plan_project(prompt="...") → mostra plano com missões e dependências.
2. Despache a primeira missão (aquela com depends_on vazio).
3. As missões restantes são despachadas automaticamente conforme as dependências são resolvidas (elas têm auto_dispatch=true).
4. Relate 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 sucessos e destaque falhas com erros e próximos passos.

Manual: controle passo a passo

1. create_project(name="Meu Projeto") → 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.
3. dispatch_mission(mission_id=...) na primeira missão para iniciar a cadeia.
4. get_report(mission_id=...) quando concluído.

Sequencial com revisão

1. create_project(name="...") → obtenha project_id.
2. create_mission(project_id=project_id, title="Implementar funcionalidade", prompt="...") → obtenha impl_mission_id.
3. dispatch_mission(mission_id=impl_mission_id), depois faça polling com get_mission_status até concluir.
4. get_report(mission_id=impl_mission_id) para revisar os resultados.
5. create_mission(project_id=project_id, title="Revisão", prompt="...", depends_on=[impl_mission_id], auto_dispatch=true) — inicia automaticamente, pois a dependência já foi atendida.

Diretrizes

• Sempre confirme o plano com o usuário antes de despachar, a menos que ele tenha dito para prosseguir.
• Inclua títulos e IDs das missões ao relatar o status.
• Se uma missão falhar, leia seu relatório antes de tentar novamente.
• Verifique get_dashboard() para disponibilidade de slots de agentes antes de despachar em lote.
• As dependências de missão formam um DAG — não crie dependências circulares.
• Cada agente executa em um worktree git isolado e faz auto-merge ao concluir. Se ocorrer um conflito de merge, as alterações permanecem no branch do worktree do agente para resolução manual.
• Ao criar missões manualmente, sempre defina auto_dispatch=true se quiser que elas sejam acionadas automaticamente quando as dependências forem concluídas. Sem essa flag, as missões permanecem no status draft.