ADR-0010 · Revisor de PRs em três camadas (nos-revisor)

Status: aceito · Data: 2026-10

Contexto

O levantamento de outubro de 2026 encontrou riscos que se repetem por padrão: rotas de escrita sem requireAdmin, segredos em log, webhook sem verificação, comando de desenvolvimento no build de produção, CI chamando script inexistente. Com uma desenvolvedora principal, não há segundo par de olhos em todo PR.

Decisão

Adotar o nos-revisor, ferramenta da Nós Tecnologia reutilizável entre projetos, em três camadas:

1. Regras determinísticas configuradas em .revisor.json: bloqueiam o merge.
2. Modo PR: só linhas alteradas contam. Um problema antigo passa a bloquear quando alguém mexe na linha dele (regra do escoteiro).
3. Revisão com IA (Claude) usando esta documentação (riscos, regras de negócio, requisitos, ADRs) como critério: comenta, nunca bloqueia.

Consequências

• ➕ R-01, R-02, R-03, R-06, R-07 e R-13 viraram regras automáticas: não voltam sem alguém perceber.
• ➕ A documentação passa a ser contrato verificável; doc errada gera revisão errada e é corrigida.
• ➖ Custo de API por PR na camada de IA (opcional; sem chave, só as regras rodam).
• ➖ A política de rotas precisa ser mantida quando surgirem recursos novos.