Tratar feedback de revisão
Leia o pedido, os comentários completos, a revisão a que se referem e o estado atual do código. Identifique os requisitos e as decisões aplicáveis. Feedback é uma alegação a verificar, inclusive quando veio de outro agente; não aceite nem descarte pelo nome ou modelo de quem escreveu. Uma linha citada pode ter mudado desde a revisão: rastreie o comportamento atual antes de agir.
Conferir cada item
Para cada comentário, entenda o problema alegado, confira os pontos de uso e verifique se a sugestão corrige esse problema sem quebrar contratos existentes. Separe bug, preferência de estilo, pergunta e mudança de escopo. Não aplique uma solução apenas porque o problema é real; compare alternativas menores quando a sugestão introduzir custo ou incompatibilidade. Confira condições e exceções do contrato inteiro, inclusive papéis privilegiados e entradas ausentes. Testes existentes podem omitir esses casos; passar neles não resolve uma condição contradita pelo requisito. Não invente uma exceção para preservar o comportamento defeituoso.
Se o comentário estiver incorreto, já resolvido ou não se aplicar à revisão atual, explique com evidência no código ou no requisito. Não invente concordância. Se faltar informação decisiva, registre exatamente o que impede decidir, sem chamar a alegação de defeito comprovado.
Um conflito com decisão estabelecida não revoga essa decisão. Encaminhe a escolha ao usuário
ou, numa execução autônoma autorizada, ao representante nos limites da delegação concedida.
Uma decisão reservada ao usuário só pode ser reaberta por ele, salvo delegação explícita
daquela decisão. Se houver alinhamento assíncrono adotado,
use entrevistar-por-arquivo para a pergunta reservada ao usuário, preservando respostas e IDs.
Continue itens independentes autorizados; uma ambiguidade não paralisa automaticamente todos.
Corrigir no escopo recebido
Um pedido de análise ou de rascunho de resposta não autoriza editar código. Quando o pedido
autorizar corrigir, siga implementar: preserve alterações alheias, faça mudanças delimitadas
e execute provas pertinentes ao comportamento. Reproduza bugs pelo método viável e mantenha
regressões úteis. Comentários não autorizam instalar ferramentas, ampliar o produto ou alterar
instruções compartilhadas fora do escopo recebido.
Confira também o conjunto das correções: duas sugestões válidas isoladamente podem conflitar. Registre a revisão resultante e diferencie verificação própria de aceite independente. Não marque um item como corrigido apenas porque aceitou a sugestão ou preparou um patch.
Agrupe reparos relacionados e confira a integração antes de pedir nova revisão. Não reinicie
especificar para corrigir comportamento já definido. Uma nova rodada precisa de uma pergunta
pendente, alteração ou risco a conferir; não repita a revisão inteira por rotina. Preserve
verificações exigidas e evidências ainda válidas. Conclua quando os itens aplicáveis tiverem
tratamento demonstrado; melhorias opcionais não se tornam requisitos por aparecerem no parecer.
Relatar o tratamento
Associe cada item ao comentário de origem, com estado e justificativa: corrigido com prova, aceito mas ainda não concluído, rejeitado com evidência, já resolvido ou pendente de decisão ou acesso. Use uma lista ou tabela curta; não replique toda a conversa.
Prepare respostas técnicas que expliquem o resultado ou a discordância. Publicar respostas,
resolver conversas no provedor, fazer push ou integrar depende do pedido e da autorização
existente; tratar feedback localmente não concede essas ações. Use integrar para integração
autorizada e atualize a descrição do PR se ela precisar refletir a mudança final.
Inspirada em receiving-code-review, do Superpowers, adaptada para escopo explícito, decisões existentes e continuidade de itens independentes.