O que Orquestração de Agentes em Equipe faz?
Use esta skill quando os agentes estão 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 branch, visibilidade no 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, esquadrão, condutor, painel de controle, gerente, aplicativo desktop, Zellij, tmux, Hermes, Devin, Codex, Claude Code ou trabalho multiagente.
- Um projeto precisa de estado de workflow compartilhado entre pessoas e agentes.
- O fan-out de agentes existente está produzindo saída, mas não um produto que possa ser mergeado.
Modelo Operacional
Trate cada agente como um colega de equipe com um contrato estreito:
- Proprietário: a pessoa ou agente responsável pelo item de trabalho.
- Escopo: arquivos, branch, superfície da ferramenta e áreas proibidas.
- Estado: backlog, pronto, executando, revisão, bloqueado, mergeado ou arquivado.
- Evidência: testes, screenshots, 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 do Agente
Use o Kanban do agente quando o trabalho precisa ser visível entre sessões.
| Coluna | Significado | Critérios de Saída |
|---|---|---|
| Backlog | Item de trabalho candidato, ainda não modelado | Critérios de aceitação escritos |
| Pronto | Modelado e atribuível | Proprietário e branch/worktree atribuídos |
| Executando | Agente está trabalhando ativamente | Artefato de transferência e arquivos alterados existem |
| Revisão | Trabalho completo, mas não mergeado | Testes, revisão de diff e verificação de risco aprovados |
| Bloqueado | Precisa de entrada externa ou falhou no portão | Bloqueador tem proprietário e próxima ação |
| Mergeado | Integrado ao tronco principal | PR mergeado ou main local atualizada |
| Arquivado | Não é mais relevante | Motivo registrado |
Cada cartão deve se encaixar neste esquema:
{
"id": "agent-card-001",
"title": "Construir skill de workflow dinâmico",
"proprietario": "codex",
"estado": "executando",
"branch": "product/dynamic-workflow-team-orchestration",
"worktree": ".",
"aceitacao": [
"Skill existe",
"Testes cobrem conceitos necessários",
"Artefato de conteúdo contém ângulos de vídeo e artigo"
],
"portao_merge": "lint, testes focados e verificação de catálogo passam",
"transferencia": "caminho/para/handoff.md"
}
Fluxo de Orquestração Baseada em Equipe
- Modelar o quadro: converter ambição difusa em itens de trabalho com proprietários e portões de merge.
- Escolher o modo de execução: agente único, modo de workflow 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 transferência, 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.
- Fazer merge 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 transferência, testes, screenshots e PRs.
- Bloqueadores agrupados por proprietário e ação de desbloqueio.
- Prontidão para merge por portão, não por intuição.
- Candidatos a workflow reutilizáveis que devem se tornar skills compartilhadas.
Não adicione mais automação até que o operador possa responder: quem é o proprietário disso, o que mudou, que portão falhou e o que pode ser mergeado com segurança?
Compatibilidade com Workflow Dinâmico
Quando um cartão precisar do modo de workflow 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 passar de Executando para Revisão.
- Promova o harness para uma skill compartilhada somente após uso repetido.
Modos de Falha a Observar
- Sopa de agentes: muitos agentes em execução, 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.
- Sem 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 mergeados ou pendentes.
- Testes e evidências de avaliação.
- Bloqueadores com proprietário e próxima ação.
- Novos candidatos a skill compartilhada.