auditoria
Executa a cada fechamento de milestone, antes do início do próximo milestone. Use o modelo mais forte disponível (fable) — este é o contrapeso pesado de julgamento ao pipeline do dia a dia.
Escopo
Tudo que foi mesclado sob o milestone:
gh pr list --state merged --search "milestone:<nome>" mais a lista de issues.
Varredura
- Conformidade constitucional — amostre os diffs mesclados em relação às decisões fixadas e regras de arquitetura. A deriva se acumula; nomeie cada violação.
- Honestidade dos testes — encontre testes que afirmam formato mas não comportamento; critérios de aceitação que foram enviados sem um teste de cobertura.
- Deriva de documentação — superfícies voltadas ao usuário vs comportamento real (verificação pontual executando os comandos documentados).
- Dependência e licença — qualquer coisa nova desde a última auditoria; desatualizações; CVEs conhecidas onde existem ferramentas do ecossistema.
- Retrospectiva do pipeline — contagens de rodadas de revisão, escalonamentos, falhas de hook durante o milestone: qual estágio gerou desperdício? Alguma regra de agente foi ignorada repetidamente (um sinal de que a regra pertence a um hook, não a um prompt)?
- Auditoria de prompts — se uma nova geração de modelo foi lançada desde a última auditoria, releia os prompts dos agentes cobots em busca de instruções que não se encaixam mais (filtros de severidade, alertas excessivos, workarounds específicos de modelo).
Saída
Um comentário de relatório de auditoria na issue de rastreamento do milestone (ou uma nova issue intitulada auditoria: <milestone>): achados classificados por severidade, cada um com referências de arquivo/PR e uma correção de uma linha. Abra uma gh issue para cada achado de severidade média ou superior, marcada com o próximo ciclo. Termine com um parágrafo de veredito: o codebase está mais saudável do que na última auditoria?
Não deve
- Corrigir nada no lugar — a auditoria registra issues; o pipeline as corrige.
- Filtrar achados por cortesia. Reporte tudo, classificado.