Pular para o conteúdo principal
Menu

Uma boa decisão começa por uma medida que você entende.

O Releezy Guardian transforma o histórico do desenvolvimento em evidências. Conheça a lógica por trás dos indicadores e como usá-los para orientar seu time.

Do comentário ao histórico do código

Do comentário ao histórico do código

Comentário checkout.ts Commit posterior checkout.ts Correspondência no mesmo arquivo Commit posterior profile.ts Sem correspondência no arquivo Sem novo commit Fora deste recorte do cálculo
Uma mudança no mesmo arquivo.

Um commit posterior toca o arquivo comentado. Essa correspondência entra no cálculo da efetividade de revisão.

O PR mudou. O arquivo, não.

Houve um commit posterior, mas em outro arquivo. Esse comentário não recebe a mesma correspondência no cálculo.

Sem continuidade para comparar.

Sem um commit posterior ao comentário, ele fica fora desse recorte do cálculo. Não é tratado como uma revisão sem efeito.

Da atividade registrada à conversa certa.

Três camadas ajudam a entender o indicador antes de agir sobre ele.

O registro

Comentários de revisão, arquivos e commits dão origem ao sinal observado. O histórico permite voltar ao trabalho que está por trás do indicador.

A regra

A efetividade considera comentários elegíveis e a ocorrência de commits posteriores no mesmo arquivo. Os critérios de elegibilidade definem quais comentários entram em cada recorte.

A interpretação

Uma mudança no arquivo é um sinal de atividade, não uma prova de causalidade. Volume, tipo de trabalho e contexto do time completam a leitura.

Leia o sistema. Oriente a melhoria.

O indicador abre uma investigação sobre o trabalho. A decisão acontece quando você entende o contexto.

  1. Escolha um recorte consistente

    Defina projeto, período e tipo de atividade. Compare situações semelhantes para que a variação faça sentido.

  2. Combine sinais

    Observe efetividade de revisão, durabilidade do código e fluxo de entrega. Um indicador isolado não descreve todo o trabalho.

  3. Acompanhe a ação

    Registre o que mudou na prática do time e volte ao mesmo recorte para acompanhar sua evolução.

Entenda a lógica.

Onde entram regras e modelos de IA?

As regras de agregação organizam os registros e calculam os indicadores. Modelos de IA ajudam a classificar e analisar comentários de revisão, acrescentando contexto à leitura.

O que entra na efetividade de revisão?

O recorte considera comentários com arquivo identificado, que não são respostas a outro comentário, em PRs com histórico de arquivos dos commits e ao menos um commit posterior. Para agentes de IA, entram os comentários classificados como bloqueantes; para humanos, a elegibilidade não depende dessa classificação. A correspondência com o arquivo é aplicada antes da agregação.

Como usar esses dados com o time?

Use os sinais para melhorar o processo, distribuir conhecimento e calibrar ferramentas. A conversa é sobre o que ajuda o time a entregar melhor, com espaço para o contexto de cada projeto.

Traga uma pergunta. Explore a evidência.

Veja como a metodologia do Releezy Guardian pode ajudar a interpretar o trabalho da sua engenharia.

Conversar sobre meu time