O que Orquestração de Agentes em Equipe faz?
Use esta skill quando os agentes estiverem sendo gerenciados como uma equipe, e não como um assistente único. O objetivo é tornar a orquestração baseada em equipe confiável: itens de trabalho claros, propriedade explícita, estado Kanban do agente, isolamento de branches, visibilidade do painel de controle e portões de merge.
Quando Ativar
- A tarefa abrange múltiplos agentes, ferramentas, harnesses, branches ou worktrees.
- O usuário menciona orquestração de equipe, Kanban de agente, squad, condutor, painel de controle, gerente, aplicativo desktop, Zellij, tmux, Hermes, Devin, Codex, Claude Code ou trabalho multi-agente.
- Um projeto precisa de estado de fluxo de trabalho compartilhado entre pessoas e agentes.
- O fan-out de agentes existente está produzindo saída, mas não um produto mergeável.
Modelo Operacional
Trate cada agente como um colega de equipe com um contrato restrito:
- Proprietário: a pessoa ou agente responsável pelo item de trabalho.
- Escopo: arquivos, branch, superfície de ferramenta e áreas proibidas.
- Estado: backlog, pronto, executando, revisão, bloqueado, mesclado ou arquivado.
- Evidência: testes, capturas de tela, logs, notas de revisão ou relatórios de avaliação.
- Portão de merge: a condição exata que permite a integração.
Kanban de Agente
Use o Kanban de agente quando o trabalho precisar ser visível entre sessões.
| Coluna | Significado | Critério de Saída |
|---|---|---|
| Backlog | Item de trabalho candidato, ainda não moldado | Critérios de aceitação escritos |
| Pronto | Moldado e atribuível | Proprietário e branch/worktree atribuídos |
| Executando | Agente está trabalhando ativamente | Artefato de handoff e arquivos alterados existem |
| Revisão | Trabalho concluído, mas não mesclado | Testes, revisão de diff e verificação de risco aprovados |
| Bloqueado | Precisa de entrada externa ou falhou no portão | Bloqueio tem proprietário e próxima ação |
| Mesclado | Integrado à linha principal | PR mesclado ou main local atualizado |
| Arquivado | Não é mais relevante | Motivo registrado |
Cada cartão deve se encaixar neste esquema:
{
"id": "agent-card-001",
"title": "Construir skill de fluxo de trabalho dinâmico",
"owner": "codex",
"state": "executando",
"branch": "product/dynamic-workflow-team-orchestration",
"worktree": ".",
"acceptance": [
"Skill existe",
"Testes cobrem conceitos necessários",
"Artefato de conteúdo contém ângulos de vídeo e artigo"
],
"merge_gate": "lint, testes focados e verificação de catálogo aprovados",
"handoff": "path/to/handoff.md"
}
Fluxo de Orquestração Baseado em Equipe
- Moldar o quadro: converter ambição difusa em itens de trabalho com proprietários e portões de merge.
- Escolher modo de execução: agente único, modo de fluxo de trabalho dinâmico, dmux/tmux, fan-out de worktree ou orquestrador desktop externo.
- Atribuir limites: um proprietário por cartão, escopo de arquivo claro e sem escritas sobrepostas sem um integrador.
- Executar agentes: cada agente escreve evidências e notas de handoff, não apenas código.
- Revisar em sequência: testes primeiro, depois revisão de diff, depois verificações de segurança/risco, depois polimento de conteúdo/produto.
- Mesclar deliberadamente: um integrador resolve conflitos e atualiza o painel de controle ou artefato de status.
- Extrair skill reutilizável: se o padrão do cartão se repetir, promova-o para
skills/.
Requisitos do Painel de Controle
Um painel de controle útil para orquestração de equipe deve mostrar:
- Itens de trabalho ativos e seu estado Kanban de agente.
- Proprietário, harness, branch, worktree e último heartbeat.
- Links para artefatos de handoff, testes, capturas de tela e PRs.
- Bloqueios agrupados por proprietário e ação de desbloqueio.
- Prontidão para merge por portão, não por intuição.
- Candidatos a fluxo de trabalho reutilizáveis que devem se tornar skills compartilhadas.
Não adicione mais automação até que o operador possa responder: quem é o dono disso, o que mudou, qual portão falhou e o que pode ser mesclado com segurança?
Compatibilidade com Fluxo de Trabalho Dinâmico
Quando um cartão precisar de modo de fluxo de trabalho dinâmico:
- Coloque o harness local da tarefa sob o proprietário do cartão.
- Armazene entradas e saídas no cartão.
- Exija uma avaliação antes de mover de Executando para Revisão.
- Promova o harness a uma skill compartilhada somente após uso repetido.
Modos de Falha a Observar
- Sopa de agentes: muitos agentes executando, sem proprietário ou portão de merge.
- Trabalho invisível: saída útil existe apenas em uma transcrição de chat.
- Teatro de quadro: um quadro Kanban existe, mas os cartões não têm critérios de aceitação.
- Escritas sobrepostas: agentes paralelos editam os mesmos arquivos sem worktrees.
- Nenhum artefato de produto: o processo produz documentos, mas nenhuma superfície executável ou publicável.
Padrão de Saída
Finalize cada passada de orquestração com:
- Alterações no quadro/cartões.
- Branches mesclados ou pendentes.
- Testes e evidências de avaliação.
- Bloqueios com proprietário e próxima ação.
- Novos candidatos a skill compartilhada.