adamsreview: Um Plugin de Revisão de PR em Múltiplos Estágios para Claude Code com Agentes Paralelos e Loop de Correção Automática

adamsreview é um plugin de seis comandos para o Claude Code que implementa um pipeline de revisão de código com múltiplas lentes. Ele usa subagentes paralelos (até sete lentes cobrindo correção, segurança, UX, etc.), uma passagem de deduplicação, um portão de validação do tipo barato-depois-profundo e uma passagem holística opcional de corte transversal com Opus. O autor relata que, em PRs pessoais, ele captura dramaticamente mais bugs reais do que o /review e /ultrareview nativos do Claude, CodeRabbit, Greptile e a revisão nativa do Codex, com menos falsos positivos.

Instalação

/plugin marketplace add adamjgmiller/adamsreview
/plugin install adamsreview@adamsreview

Os Seis Comandos

• /adamsreview:review — revisão de código com múltiplas lentes de um branch ou PR. Até sete lentes de subagentes paralelos, deduplicação, portão de validação, passagem opcional de corte transversal com Opus. Use --ensemble para adicionar uma passagem do Codex CLI e coleta de comentários de bots no PR.
• /adamsreview:codex-review — revisão por pares do Codex CLI. Mesma forma de artefato, substituível nos comandos posteriores. Esforço ajustável via --effort low|medium|high|xhigh (padrão high).
• /adamsreview:add — injeta descobertas de fontes externas (ex.: uma colagem de /ultrareview da nuvem, uma revisão do Opus, uma nota de colega) no artefato de revisão mais recente. Deduplicado e validado.
• /adamsreview:walkthrough — driver interativo para descobertas incertas. Usa a interface AskUserQuestion para percorrer itens um por um. Aceita em lote propostas de correção automática pré-computadas e, em seguida, apresenta um briefing por descoberta + opções + recomendação. Publica um registro de decisões no PR.
• /adamsreview:fix — loop de correção automatizado. Dispara subagentes por grupo de correção em paralelo, re-revisa o trabalho com Opus, reverte regressões e confirma os sobreviventes (um commit combinado por padrão; --granular-commits para um por grupo).
• /adamsreview:promote — sobreposição humana que promove uma única descoberta para automaticamente corrigível, ignorando o filtro de categoria e o limite de pontuação.

Arquitetura

O plugin armazena estado em artefatos JSON no disco, permitindo que o contexto seja limpo entre os estágios. Os arquivos de comando ficam em commands/ em caminhos sem extensão; fragmentos de fase e referências de prompt ficam em fragments/; scripts auxiliares e o esquema do artefato ficam em bin/. O runtime do plugin adiciona automaticamente bin/ ao $PATH ao carregar — sem symlinks ou scripts de instalação.

Fluxo Recomendado

1. Execute /adamsreview:review (ou /adamsreview:review --ensemble para maior custo de tokens, mas mais lentes).
2. Opcionalmente, execute /adamsreview:add <colar...> para injetar descobertas de revisões paralelas.
3. Opcionalmente, execute /adamsreview:walkthrough [threshold] para revisar manualmente descobertas incertas (threshold padrão 60).
4. Execute /adamsreview:fix para corrigir automaticamente descobertas validadas com reversão de regressões.

Nota de Preço

adamsreview é executado contra sua assinatura regular do Claude Code (plano Max recomendado). Diferente do /ultrareview, ele não cobra do seu pool de Uso Extra.