Como funciona
Um pull request (PR) é uma solicitação para integrar mudanças de uma branch em outra, geralmente da branch de trabalho para a branch principal. Ao abrir um PR, você apresenta as mudanças, descreve o motivo e convida outros desenvolvedores a revisar o código.
A revisão pode incluir comentários, sugestões de alteração e aprovações. Ferramentas de CI/CD rodam testes automaticamente no PR. Somente após aprovação e testes passando, o PR é mesclado (merge) na branch principal.
Boas práticas incluem manter PRs pequenos e focados, escrever descrições claras e responder aos comentários de revisão. PRs grandes e misturados aumentam o risco de bugs passarem despercebidos e dificultam a revisão.
Exemplo prático
Você corrige um bug no cálculo de imposto em uma branch chamada fix/imposto-pj. Abre um PR para main com a descrição do problema, a solução e os testes adicionados. Um colega revisa, sugere uma melhoria de legibilidade, você ajusta e o PR é aprovado e mesclado.
Para que serve
Pull requests organizam a colaboração e garantem qualidade. São o ponto onde código é revisado, discutido e validado antes de entrar em produção.
Agentes de IA que programam, como Claude Code e Codex, também abrem PRs ao finalizar tarefas. No bridgecode, cada agente pode trabalhar em sua branch e abrir PRs separados, facilitando a revisão humana.