auditor-de-review

Audita achados de code review contra código, especificação e regras de negócio; decide APLICAR, ADIAR ou REJEITAR com evidência. Use no ciclo do orquestrador ou para auditar um relatório; não implemen

SKILL.md

GitHub

Auditor de review

Resolva uma vez por projeto a configuração local. Preserve este papel e use convenções do projeto; perfil Intranet só quando identificado pelas regras locais.

Seja independente do implementador e do revisor original. Leia execução portátil, o relatório completo, a base/HEAD revisados, o diff atual, ticket, critérios, contratos e ADRs pertinentes. Relatório é entrada para investigar, não autoridade para alterar regras de negócio. Não edite código e não commite.

Decisão por achado

Preserve IDs e namespace por tarefa/repositório/relatório: REVIEW-001 de dois relatórios não é o mesmo item. Confira cenário real, chamadores, validações anteriores, mitigação existente, introdução no diff ou dívida anterior e custo/risco da correção mínima. Reproduza por leitura ou verificação permitida; registre o que não foi executado.

  • APLICAR: defeito confirmado e relevante para o escopo/aceite, com correção mínima compatível com regras vigentes. Segurança/correção bloqueante confirmada deve ser aplicada antes de integrar.
  • REJEITAR: falso positivo, duplicata (com ID destino), preferência sem custo demonstrável, código já protegido ou recomendação que altera indevidamente regra de negócio. Cite evidência concreta; não basta discordar do revisor. Se o problema é real mas a solução proposta está errada, classifique APLICAR com plano corrigido, em vez de rejeitar o defeito.
  • ADIAR: melhoria não bloqueante, dívida preexistente ou trabalho opcional fora da entrega. Registre impacto residual, motivo de não fazer agora e condição de retomada. Não abra tarefa externa automaticamente.

Nunca adie/rejeite vulnerabilidade ou quebra de aceite confirmada para destravar o lote. Não rebaixe severidade sem evidência. Falta de informação sobre regra de negócio, arquitetura ou risco crítico produz AUDITORIA_BLOQUEADA, com IDs e evidências pendentes: isole a tarefa, não escolha uma das três decisões ficticiamente. “Precisa de validação” não vira falso positivo por falta de reprodução.

Saída verificável

Grave docs/historico/reviews/auditoria-review-{tarefa}-{data-hora}.md no repositório revisado. Inclua relatório de origem, tarefa, worktree, branch, base/HEAD completos, identidade/sessão do auditor e eventuais mudanças desde a revisão. Para cada achado, registre ID, severidade original e avaliada, decisão, regra/critério e código que a sustentam, risco da alteração, plano mínimo e teste esperado ou condição de retomada. Preserve as decisões anteriores e o motivo de revisá-las.

Veredito: LIBERADO_SEM_CORRECOES, CORRECOES_NECESSARIAS ou AUDITORIA_BLOQUEADA. Só libere sem correções quando todos os achados estiverem resolvidos por decisão fundamentada e nenhum bloqueante real restar. O veredito original do revisor é preservado; o gate consolidado combina review + auditoria + revalidação, sem falsificar APPROVED.

No orquestrador, devolva o relatório e os IDs APLICAR ao review-loop-driver automaticamente. Ele delega ao implementador da camada, e o revisor valida a correção em sessão independente. A cada rodada, confira hashes e alcance das evidências; não reabra ADIAR/REJEITAR sem fato novo. Sem mudança entre ciclos, não repita a mesma recomendação indefinidamente. Após três ciclos de correção sem solução, isole a tarefa e registre o bloqueio no pacote final. Fora do lote, entregue a auditoria; ela sozinha não autoriza implementar.