Orquestração de Agentes em Equipe

Use esta habilidade quando os agentes estiverem sendo gerenciados como uma equipe, em vez de um único assistente. 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 do painel de controle e portões de merge.

Quando Ativar

• A tarefa abrange vários 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 de desktop, Zellij, tmux, Hermes, Devin, Codex, Claude Code ou trabalho multiagente.
• Um projeto precisa de estado de fluxo de trabalho compartilhado entre pessoas e agentes.
• O fan-out de agente existente está produzindo saída, mas não um produto que possa ser mesclado.

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 da ferramenta e áreas proibidas.
• Estado: backlog, pronto, em execução, 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.

Cada cartão deve se encaixar neste esquema:

{
  "id": "agent-card-001",
  "title": "Build dynamic workflow skill",
  "owner": "codex",
  "state": "running",
  "branch": "product/dynamic-workflow-team-orchestration",
  "worktree": ".",
  "acceptance": [
    "Skill exists",
    "Tests cover required concepts",
    "Content artifact contains video and article angles"
  ],
  "merge_gate": "lint, focused tests, and catalog check pass",
  "handoff": "path/to/handoff.md"
}

Fluxo de Orquestração Baseado em Equipe

1. Moldar o quadro: converter ambição vaga em itens de trabalho com proprietários e portões de merge.
2. Escolher o modo de execução: agente único, modo de fluxo de trabalho dinâmico, dmux/tmux, fan-out de worktree ou orquestrador de desktop externo.
3. Atribuir limites: um proprietário por cartão, escopo de arquivo claro e sem escritas sobrepostas sem um integrador.
4. Executar agentes: cada agente escreve evidências e notas de entrega, não apenas código.
5. Revisar em sequência: primeiro os testes, depois a revisão de diff, depois as verificações de segurança/risco, depois o polimento de conteúdo/produto.
6. Mesclar deliberadamente: um integrador resolve conflitos e atualiza o painel de controle ou artefato de status.
7. Extrair habilidade 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 entrega, testes, capturas de tela e PRs.
• Bloqueadores agrupados por proprietário e ação de desbloqueio.
• Prontidão de merge por portão, não por "vibes".
• Candidatos de fluxo de trabalho reutilizáveis que devem se tornar habilidades compartilhadas.

Não adicione mais automação até que o operador possa responder: quem é o proprietário disso, o que mudou, qual portão falhou e o que pode ser mesclado com segurança?

Compatibilidade de Fluxo de Trabalho Dinâmico

Quando um cartão precisa do 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 passar de Em Execução para Revisão.
• Promova o harness para uma habilidade compartilhada apenas 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 do 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 documentação, mas nenhuma superfície executável ou publicável.

Padrão de Saída

Conclua cada passagem de orquestração com:

• Mudanças no quadro/cartão.
• Branches mesclados ou pendentes.
• Testes e evidências de avaliação.
• Bloqueadores com proprietário e próxima ação.
• Novos candidatos a habilidades compartilhadas.