Documentação

Revisar e mesclar o resultado

O que chega ao pull request, o que verificar e como devolver o trabalho.

O Coroid finaliza abrindo um pull request em seu próprio branch, com base no seu branch principal. Ele não faz o merge. Essa decisão continua sendo sua.

O que vem junto com ele

  • A alteração de código
  • Os testes escritos ou atualizados juntamente com ela
  • O resultado da execução da sua suíte de testes existente
  • O resultado de quaisquer portas de qualidade configuradas pela sua organização
  • Uma revisão do diff, com as descobertas já corrigidas ou listadas

O objetivo não é substituir sua revisão. É garantir que sua revisão não seja a primeira etapa.

O que realmente verificar

As questões mecânicas já foram verificadas. Dedique sua atenção às coisas que só você pode avaliar:

  1. Ele resolve o problema certo? Compare com os critérios de aceitação da especificação, não com sua memória do que solicitou.
  2. Ele se encaixa na base de código? Convenções, nomenclatura, estrutura da abstração. O Coroid lê seu código para inferir isso e acerta na maioria das vezes — mas nem sempre.
  3. O que ele modifica que você não esperava? Veja a lista de arquivos antes do diff.
  4. Os novos testes são significativos? Um teste aprovado que não valida nada é pior do que nenhum teste.

Devolvendo o trabalho

Você tem três opções, em ordem crescente de complexidade:

  • Comentar e solicitar retrabalho — a tarefa volta para o agente desenvolvedor com suas observações, mantendo seu contexto. Ideal para casos de "está correto, mas incompleto".
  • Rejeitar o plano e reiniciar — quando a abordagem está errada, não a execução.
  • Cancelar a tarefa — quando o trabalho não deve ser feito. O cancelamento interrompe a execução e libera a vaga do agente.

Seja específico nos comentários de retrabalho, como faria com um colega. "Isso não lida com o caso de valor vazio em parseRange"produz uma correção; "precisa de ajustes" gera uma suposição.

Fazendo o merge

Faça o merge por meio do seu provedor, usando sua proteção de branch normal, verificações obrigatórias e regras de aprovação. O Coroid abre o pull request; seu processo existente determina o que acontece com ele.

Nada relacionado ao merge é especial — isso é intencional. O pull request é um branch comum, então segue pelo mesmo fluxo de revisão e CI em que você confia.

Próximo

Para onde ir a seguir — direciona ao restante da documentação conforme o que você deseja fazer.