Como usar o PR Summary

Todo mundo já abriu um Pull Request e pensou: “O que mudou aqui afinal?” O PR Summary da Kody resolve exatamente isso — ele escreve um resumo claro e objetivo das mudanças, sem você precisar gastar tempo descrevendo linha por linha. Quando configurado direito, ele ajuda seu time a:

• Ganhar contexto mais rápido
• Reduzir idas e vindas nas revisões
• Padronizar a forma como PRs são descritos

Vamos ver como ativar, personalizar e tirar o máximo proveito dessa funcionalidade.

Ative a geração automática de resumos

Se o seu time abre PRs sem descrição ou com textos genéricos do tipo “fix” ou “update”, essa é a configuração que vai salvar vocês. Para ativar:

1. Vá em Configurações → PR Summary
2. Ligue a opção Enable Automatic Summary Generation

A partir daí, todo PR já nasce com um resumo escrito pela Kody. Isso garante que sempre exista uma descrição inicial — mesmo que depois você ajuste manualmente. 💡 Dica: Se o time já escreve boas descrições, mas quer completá-las com contexto adicional, pule para a seção de modos de comportamento.

Escolha como a Kody lida com descrições existentes

Nem todo PR começa do zero. Às vezes o autor já escreve uma descrição, mas você quer que a Kody complemente ou reorganize. É aí que entram os modos de comportamento: 🔸 Replace (padrão) → Joga fora a descrição original e cria uma do zero. Ideal se o time não tem padrão ou quer uniformizar totalmente o estilo. 🔸 Concatenate → Mantém o que já estava lá e adiciona o resumo da Kody no final. Bom para quando o autor traz contexto humano (ex.: motivo da mudança) e você quer acrescentar um sumário técnico. 🔸 Complement → Mescla os dois textos, mantendo o que já faz sentido e adicionando só informações novas ou relevantes. Ótimo para enriquecer descrições já bem escritas sem deixá-las repetitivas. 💡 Dica prática: Se o seu time já escreve PRs detalhados, mas quer garantir que nada relevante fique de fora, use Complement.

Personalize o foco com instruções

A Kody é boa em escrever resumos, mas fica ainda melhor quando você diz exatamente o que quer. No campo Custom Instructions, você pode guiar o foco da análise. Alguns exemplos:

• “Foque em mudanças que afetam performance e segurança.”
• “Liste APIs públicas modificadas e mudanças de schema no banco.”
• “Destaque alterações que afetam o fluxo de checkout.”

Quanto mais claro você for, mais útil será o resultado. 💡 Pro tip: Se o seu time trabalha em áreas distintas (ex.: backend, frontend, data), é uma boa criar instruções diferentes para cada repositório.

Revise com o Preview do PR Summary

Antes de o resumo ir parar na sua ferramenta de git, você pode ver o Preview diretamente na Kodus. Para isso:

• Vá até a aba de PRs na Kodus
• Clique no PR desejado
• Veja o resumo gerado antes de publicar

Isso é útil para:

• Ajustar o tom e o foco antes que todo mundo leia
• Corrigir eventuais interpretações erradas
• Garantir que as informações críticas estejam lá

O que isso muda no dia a dia

Com o PR Summary configurado, seu time vai gastar menos tempo tentando entender PRs e mais tempo revisando o que realmente importa.