Como Configurar e Aprimorar as Sugestões da Kody

Quando a Kody começa a revisar seus PRs, ela traz um pacote completo de sugestões, de ajustes simples até problemas críticos. Isso garante cobertura, mas, sem configuração, o review pode ficar poluído e perder foco.

O segredo é ajustar para que a Kody fale menos, mas com mais impacto. Veja como.

Ajuste o limite e a severidade das sugestões

Um bom ponto de partida é limitar a Kody a 6 sugestões por PR — já ajuda a cortar o ruído sem deixar passar o que realmente importa. 📌 Um bom ponto de partida é limitar a Kody a 6 sugestões por PR — já ajuda a cortar o ruído sem deixar passar o que realmente importa. Mas só limitar a quantidade não garante que os comentários mais importantes vão ser priorizados. Por isso, também é essencial ajustar o nível mínimo de severidade. Essa configuração mostra pra Kody o que vale a pena comentar — pulando sugestões mais superficiais, como dicas de formatação ou ajustes de legibilidade.

Use filtros que combinem diferentes níveis de severidade

O ajuste anterior é mais geral. Se quiser algo mais preciso, vá além e defina quantas sugestões mostrar de cada severidade. Isso permite calibrar com mais precisão a frequência de cada tipo de comentário, sem precisar abrir mão completamente das sugestões mais leves, por exemplo. Assim, você garante que problemas mais sérios sempre tenham espaço, mas ainda captura melhorias de contexto que podem ser úteis, sem deixar que comentários de baixa prioridade ocupem demais.

Use o feedback nos comentários para treinar a Kody

O jeito mais rápido de melhorar as sugestões é reagir aos comentários da Kody na sua ferramenta de Git (no GitHub, por exemplo, isso é feito diretamente no comentário).

• 👍 quando a sugestão é relevante e alinhada ao padrão do time

• 👎 quando a sugestão é irrelevante ou fora de contexto

💡 Esses sinais são processados automaticamente e a Kody aprende rápido: em poucas semanas, a quantidade de comentários inúteis despenca.

Gere regras com base no comportamento do time

Se você perceber que a Kody faz sempre a mesma sugestão e o time sempre aplica, isso é um sinal de que vale transformar essa prática em uma Kody Rule.

A Kody também aprende com esse comportamento. Quanto mais ela entende o que é aceitável ou não para o seu time, mais ela consegue propor regras automáticas baseadas no seu contexto real.
Essas sugestões de regras são geradas toda sexta-feira no seu painel. Você pode revisá-las e, com um clique, implementar para que o padrão seja aplicado automaticamente nas próximas reviews.

Como fazer:

1. Vá até Kody Rules no painel da Kodus.

2. Procure pelas regras sugeridas automaticamente na última sexta-feira.

3. Revise, ajuste se necessário e ative.

💡 Assim, a Kody deixa de apenas comentar e passa a garantir que padrões importantes sejam aplicados de forma consistente, sem precisar repetir o alerta em todo PR.

🎁 Dica Extra

Depois de calibrar a quantidade e o tipo de sugestão que a Kody deve fazer, o próximo passo é garantir que os pontos mais importantes não fiquem esquecidos caso não sejam aplicados de imediato. Pra isso, você pode usar o Kody Issues — um painel que mostra todas as sugestões não implementadas ao fechar um PR. 📌 Toda sugestão ignorada em PRs fechados é registrada automaticamente e pode ser consultada depois.