Quando o time trabalha com muitos PRs pequenos, é normal começarem as reclamações de que até pra mudar um comentário a Kody está trazendo sugestão. Isso acontece porque, por padrão, ela analisa qualquer PR aberto, independente do tamanho ou tipo de mudança.
Se a ideia é deixar as revisões mais leves e focadas só nos pontos que realmente trazem risco técnico, alguns ajustes simples nas configurações já ajudam a reduzir bastante o volume de sugestões nesses casos.
Como ajustar a Kody pra esse tipo de fluxo
1. Suba o nível mínimo de severidade
Se quiser reduzir o número de sugestões que a Kody faz por PR, uma boa saída é aumentar o nível mínimo de severidade.
Isso faz com que ela só aponte os pontos classificados como High ou Critical, deixando de lado sugestões mais superficiais, como ajustes de estilo ou legibilidade.
Pra configurar isso:
Vá em Settings → Global Settings → Suggestion Control e ajuste o campo Minimum Severity Level para High.
Se quiser ser ainda mais restritivo, dá pra subir pra Critical.
Isso reduz o volume de sugestões nos PRs pequenos e faz a Kody focar só no que pode realmente causar problema (ex.: segurança, performance crítica, arquitetura quebrada).
2. Limite o número máximo de sugestões por PR
Outra forma de deixar as revisões mais focadas é limitar o número máximo de sugestões por PR.
Mesmo que a Kody encontre vários pontos de melhoria, ela só vai comentar os mais importantes — priorizando o que realmente tem impacto.
Essa configuração fica em Global Settings, no campo Max Suggestions per PR.
Um bom ponto de partida: limitar pra 6 sugestões por PR.
Isso ajuda a evitar que PRs pequenos fiquem poluídos com muitos comentários de uma vez.
3. Desative regras de baixo impacto
Também vale desativar as regras que geram sugestões de baixo impacto e que o time não considera relevantes em PRs pequenos.
Revisem a lista de regras ativas e identifiquem quais estão trazendo esse tipo de sugestão.
Por exemplo: regras relacionadas a estilo, organização de imports ou naming.
Se o time decidir que não faz sentido manter essas regras ativas, é só desativar direto na tela de Kody Rules.
4. Mantenha só as regras mais críticas
Se o objetivo for deixar a Kody ainda mais seletiva, o time pode optar por manter ativas apenas as regras que indicam risco técnico real — como falhas de segurança, problemas de performance ou questões arquiteturais graves.
Vale revisar a lista de regras e analisar, uma a uma, quais realmente apontam problemas críticos. Além de desativar o que não faz sentido, também dá pra adicionar outras regras importantes que ainda não estejam ativas.
As categorias mais relevantes pra esse cenário geralmente são:
✅ Security
✅ Performance
✅ Architecture
Não precisa fazer todas as mudanças de uma vez. O time pode ir ajustando conforme for vendo o que realmente agrega nas revisões.
5. Aproveite as regras que a Kody aprende com o seu time
Além das regras da biblioteca, a Kody também aprende com o histórico de revisões do time. Sempre que ela identifica um padrão de correção recorrente nos PRs, ela sugere a criação de uma nova regra personalizada.
Essas sugestões aparecem direto na tela de Kody Rules.
Vale a pena revisar essas sugestões de tempos em tempos. Muitas delas refletem o tipo de cuidado que o time já aplica manualmente nas revisões. Transformar esses padrões em regra ajuda a automatizar o processo e evita que os mesmos problemas continuem aparecendo.
Quando fizer sentido, é só adicionar a regra. A partir daí, ela passa a ser aplicada automaticamente nos próximos PRs.
