Pular para o conteúdo principal

​
O que é a aba Kodus Review

A aba Kodus Review responde a uma pergunta: o seu time está agindo com base no que o Kodus diz? Diferente da aba Productivity (que mede métricas gerais de entrega, como frequência de deploy e tempo de ciclo de PR), a Kodus Review trata do próprio Kodus — quantas sugestões são implementadas, quais categorias e regras pegam ou são ignoradas, e onde o time empurra de volta. Todo gráfico e tabela respeita os filtros globais de repositório e intervalo de datas no topo da página. Clique na linha de um repositório, na barra de uma categoria ou em uma regra para detalhar as sugestões por trás dela.

​
Cartões de resumo

​
Implementation rate

A métrica central. Uma sugestão conta como implementada quando seu status final é implemented ou partially_implemented no momento em que o PR fecha.
Regras de escopo — as mesmas em todos os gráficos de implementation rate:
  • Apenas sugestões entregues contam (aquelas de fato postadas como comentários de PR). Rascunhos que o Kodus filtrou antes de comentar nunca são contabilizados.
  • As sugestões são atribuídas à semana em que o PR foi fechado, porque o status de implementação só é definitivo quando o PR é mergeado.

​
Semana a semana

O gráfico semanal mostra a tendência, com um seletor:
  • Overall — uma única linha de implementation rate.
  • By severity — uma linha por severidade (critical / high / medium / low), para você ver se sugestões de severidade mais alta são mais implementadas.

​
Por categoria e por severidade

  • By category — enviadas vs. implementadas por categoria de sugestão. Clique em uma barra para abrir o explorador de sugestões filtrado por aquela categoria.
  • By severity — implementation rate por nível de severidade. O esperado é um gradiente decrescente (critical mais implementada que low). Se parecer plano ou invertido, a severidade não está orientando o time.
O seletor “All / Kodus only” no gráfico de severidade importa. Uma Kody Rule carrega a severidade que você definiu na regra, não uma avaliação de risco feita pelo Kodus. Misturar as duas distorce a leitura de calibração — por exemplo, um monte de Kody Rules medium com alta adoção pode fazer o Kodus parecer que subestima medium. Mude para Kodus only para ver a calibração de severidade do próprio Kodus. Barras construídas sobre pouquíssimas sugestões aparecem esmaecidas e marcadas com * — um 0% ou 100% vindo de um punhado de sugestões não é um sinal real.

​
Feedback negativo

O feedback vem das reações 👍 / 👎 nos comentários de sugestão do Kodus.
  • Negative vote rate (cartão de resumo) — 👎 ÷ (👍 + 👎), com a tendência em relação ao período anterior. Quanto menor, melhor.
  • By category — onde o time mais discorda. Uma categoria com muitos 👎 é candidata a ser reajustada ou desativada.
  • Trend — votos negativos semana a semana.

​
Repositórios — saúde

Uma tabela por repositório: PRs revisados, sugestões enviadas, implementation rate, 👍/👎, e a categoria mais fraca (a categoria com a menor implementation rate naquele repositório, dado um tamanho mínimo de amostra). Mostra onde o Kodus está pegando versus sendo ignorado. Clicar em uma linha foca todo o cockpit naquele repositório (o mesmo que selecioná-lo no filtro de repositório).

​
Kody Rules — saúde

Como cada Kody Rule está performando no período: gatilhos, implementation rate, 👍/👎, e um status. Apenas regras ativas aparecem — regras deletadas ou inativas são excluídas, já que você não pode agir sobre elas. O status é calculado por regra, nesta ordem de prioridade: Noisy e Ignored parecem semelhantes, mas pedem ações diferentes. Ignored é passivo — a regra dispara, mas ninguém implementa, e você não consegue saber se é ruído ou apenas descaso. Noisy é discordância ativa — o time explicitamente vota contra, então você sabe que é ruído. É por isso que uma regra que é as duas coisas aparece como Noisy: os votos negativos são o sinal mais forte e mais acionável. Os limites são padrões sensatos e podem ser ajustados ao longo do tempo.

​
Explorador de sugestões

Todo detalhamento — a barra de uma categoria, a linha de uma regra, o cartão “criticals ignored” — abre o explorador de sugestões: uma lista filtrável e paginada das sugestões reais por trás do número. Filtros: repositório, categoria, severidade, status de implementação, Kody Rule e busca por texto livre. Cada linha expande para mostrar o código existente vs. o sugerido e um link para o comentário do PR.