Revisão em Enxame (Swarm Review)

Quando Usar

Use esta habilidade quando precisar de uma revisão paralela somente leitura por múltiplos agentes de um diff git atual ou escopo explícito de arquivos para encontrar regressões comportamentais, riscos de segurança ou privacidade, problemas de desempenho ou confiabilidade, e lacunas de cobertura de contrato ou testes. Use quando o usuário pedir por uma revisão em enxame, revisão paralela, revisão de diff, etc.

Revise um diff com quatro sub-agentes somente leitura em paralelo, e então peça ao agente principal para filtrar, ordenar e resumir apenas os problemas que importam. Esta habilidade é apenas para revisão: sub-agentes não editam arquivos, e o agente principal não aplica correções como parte deste fluxo de trabalho.

Passo 1: Determinar Escopo e Intenção

Prefira esta ordem de escopo:

1. Arquivos ou caminhos explicitamente nomeados pelo usuário
2. Mudanças atuais do git
3. Um diff explícito de branch, commit ou PR solicitado pelo usuário
4. Arquivos rastreados modificados mais recentemente, apenas se o usuário pediu uma revisão e não houver um diff mais claro

Se não houver um escopo de revisão claro, pare e diga isso brevemente.

Ao usar mudanças do git, escolha o comando de diff correto e menor:

• trabalho não preparado (unstaged): git diff
• trabalho preparado (staged): git diff --cached
• trabalho misto preparado e não preparado: revise ambos
• comparação explícita de branch ou commit: use exatamente o que o usuário solicitou

Antes de iniciar os revisores, leia as instruções locais mais próximas e quaisquer documentos relevantes do projeto para a área tocada, como:

• AGENTS.md
• documentos do fluxo de trabalho do repositório
• documentos de arquitetura ou contrato para o módulo tocado

Construa um pequeno pacote de intenção para os revisores:

1. Qual comportamento se destina a mudar
2. Qual comportamento deve permanecer inalterado
3. Quaisquer restrições declaradas ou inferidas, como expectativas de compatibilidade, implantação, segurança ou migração

Se o usuário não declarou a intenção claramente, infira-a do diff e diga que a inferência pode ser incompleta.

Passo 2: Iniciar Quatro Revisores Somente Leitura em Paralelo

Inicie quatro sub-agentes quando o escopo for grande o suficiente para que a revisão paralela ajude. Para um diff minúsculo ou um arquivo muito pequeno, é aceitável revisar localmente em vez disso.

Para cada sub-agente:

• dê o mesmo escopo e o mesmo pacote de intenção
• declare que o sub-agente é somente leitura
• não permita que o sub-agente edite arquivos, execute apply_patch, prepare mudanças, comite ou realize qualquer outra ação que modifique o estado
• peça apenas por descobertas concisas
• peça por: arquivo e linha ou símbolo, problema, por que importa, acompanhamento recomendado e confiança
• diga ao sub-agente para evitar detalhes triviais, preferências de estilo e preocupações especulativas sem impacto concreto
• diga ao sub-agente para enviar as descobertas de volta ao agente principal apenas

Use estas quatro funções de revisão.

Sub-Agente 1: Revisão de Intenção e Regressão

Revise se o diff corresponde à mudança de comportamento pretendida sem introduzir desvios de comportamento extras.

Verifique:

1. Mudanças de comportamento não intencionais fora do escopo declarado
2. Casos extremos quebrados ou caminhos de fallback
3. Desvio de contrato entre chamadores e chamados
4. Atualizações ausentes em fluxos adjacentes que deveriam mudar juntos

Este sub-agente é somente leitura. Ele não deve editar arquivos, aplicar patches ou fazer quaisquer outras mudanças no espaço de trabalho.

Função recomendada do sub-agente: reviewer

Sub-Agente 2: Revisão de Segurança e Privacidade

Revise o diff em busca de regressões de segurança, riscos de privacidade e erros na fronteira de confiança.

Verifique:

1. Verificações de autenticação ou autorização ausentes ou enfraquecidas
2. Tratamento de entrada inseguro, riscos de injeção ou lacunas de validação
3. Exposição de segredos, tokens ou dados sensíveis
4. Padrões arriscados, expansão de permissões ou confiança em dados não verificados

Este sub-agente é somente leitura. Ele não deve editar arquivos, aplicar patches ou fazer quaisquer outras mudanças no espaço de trabalho.

Função recomendada do sub-agente: reviewer

Sub-Agente 3: Revisão de Desempenho e Confiabilidade

Revise o diff em busca de novos custos, fragilidades ou riscos operacionais.

Verifique:

1. Trabalho duplicado, E/S redundante ou recálculo desnecessário
2. Trabalho adicionado na inicialização, renderização, requisição ou outros caminhos críticos
3. Vazamentos, limpeza ausente, tempestades de retentativas ou desvio de assinatura
4. Problemas de ordenação, corrida ou tratamento de falhas que tornam a mudança frágil

Este sub-agente é somente leitura. Ele não deve editar arquivos, aplicar patches ou fazer quaisquer outras mudanças no espaço de trabalho.

Função recomendada do sub-agente: reviewer

Sub-Agente 4: Revisão de Contratos e Cobertura

Revise o diff em busca de lacunas de compatibilidade e redes de segurança ausentes.

Verifique:

1. Incompatibilidades de API, esquema, tipo, configuração ou feature flag
2. Consequências de migração ou compatibilidade retroativa
3. Testes ausentes ou fracos para o comportamento alterado

…