Amp ordena os arquivos do diff por importância e calcula a ordem em 0,1 s, em vez de 3,5 s

O Amp, assistente de desenvolvimento da Sourcegraph, atualizou o painel Changes. Agora ele organiza automaticamente os arquivos do diff em uma ordem que faz sentido: lê as alterações, encontra os arquivos sem os quais a mudança fica incompreensível e os coloca primeiro. Antes, essa ordenação exigia um acionamento manual e levava um tempo perceptível. Na demonstração dos desenvolvedores, com um diff de oito arquivos, o método antigo gastava 3,5 segundos, e o novo leva 0,1 segundo. Isso representa uma aceleração de cerca de 35 vezes.

O que muda no painel Changes

Na maioria das ferramentas, o diff padrão mostra os arquivos em ordem alfabética. Isso atrapalha a revisão: uma migração de banco de dados pode ficar no fim da lista, com os testes e as configurações aparecendo antes dela. O revisor lê as consequências antes da causa e precisa montar o quadro aos poucos.

O Amp propõe outra abordagem. O sistema analisa o próprio diff, destaca os arquivos que definem a essência da mudança e os coloca no topo. No exemplo do anúncio, com um diff de oito arquivos, tanto o método antigo quanto o novo puseram a migração do banco de dados em primeiro lugar. O resultado não mudou; mudou apenas a velocidade para obtê-lo.

O anúncio não revela qual modelo é responsável pelo ranqueamento nem por quais critérios um arquivo é considerado "essencial". Sabe-se apenas que a ordem é construída com base no conteúdo do diff, e não nos nomes dos arquivos.

Uma ordem que não atrapalha a revisão

O ponto mais interessante é o comportamento quando o diff é atualizado. Quando o agente continua trabalhando e as alterações no repositório mudam, a nova ordem calculada não é aplicada sozinha. Os arquivos ficam onde estão enquanto você os lê. Em vez disso, um ponto azul se acende no botão de ordenação inteligente. Um clique nele aplica a ordem atualizada.

A solução é pequena, mas bem pensada. Reordenar automaticamente no meio da leitura faria o revisor perder a posição, e com um agente ativo isso aconteceria o tempo todo. O Amp separa o cálculo da aplicação: a conta roda em segundo plano, e a decisão de reorganizar fica com a pessoa.

Velocidade como condição para a automação

Uma ordenação que leva 3,5 segundos precisa ser acionada manualmente, porque esperar toda vez é desagradável. Uma ordenação de 0,1 segundo funciona sem espera e, por isso, pode virar o comportamento padrão. Aqui, a velocidade elimina a necessidade de um botão separado para iniciar o processo.

Principais parâmetros da atualização:

• A ordem dos arquivos no painel Changes é montada automaticamente, sem acionamento manual.
• Tempo de cálculo em um diff de oito arquivos: 0,1 s contra 3,5 s antes.
• Têm prioridade os arquivos que definem a essência da mudança, como as migrações de banco de dados.
• Quando o diff muda, a ordem é recalculada, mas não é aplicada sem confirmação.
• Aviso de atualização: um ponto azul no botão de ordenação inteligente.
• Para voltar à ordem alfabética, basta clicar no mesmo botão.

Como usar e o que ainda não dá para ver

A técnica em si é universal: comece a revisão pelos arquivos que dão sentido à alteração e só depois passe às consequências. Para mudanças criadas por agentes, isso é ainda mais importante. Esses diffs costumam ser maiores e mais abrangentes que as alterações feitas por uma pessoa, e a atenção do revisor continua sendo um recurso limitado.

Uma dica prática para equipes que já usam o Amp: mantenha a ordem automática ativada por algumas semanas e compare a rapidez com que os revisores chegam aos pontos problemáticos. Se a lógica de ranqueamento não servir em um repositório específico, por exemplo um monorepo com muitos arquivos gerados, a ordem alfabética volta com um único clique.

As dúvidas em aberto dizem respeito à escala. A demonstração mostra oito arquivos, mas o anúncio não deixa claro como o método se comporta em diffs de centenas de arquivos nem quão estável é a escolha dos arquivos "principais". Vale testar isso com os seus próprios dados.