Abrimos o código da memória que os nossos agentes de codificação de IA nunca tiveram

Imagine um professor de yoga com amnésia. Em cada aula, vê-o dobrar-se para uma flexão à frente e dar a instrução "suavize os joelhos". Na aula seguinte, o mesmo corpo, o mesmo hábito de bloquear os joelhos — e, em vez disso, dá a instrução "microflexione a articulação", tendo-se esquecido de que alguma vez disse isso da primeira forma. Nenhuma das instruções está errada. Mas agora está a segurar duas instruções para um único hábito, e ninguém na sala lhe consegue dizer que são a mesma coisa.

É isto que um agente de codificação de IA faz à sua base de código, em todas as sessões.

O problema para o qual ninguém faz diffs

Claude, Kilo, Cursor, Copilot — nenhum deles se lembra do nome que deu às coisas da última vez. Peça a um agente para adicionar um limite de tentativas na segunda-feira e ele escreve MAX_RETRIES. Peça a uma sessão diferente para fazer algo adjacente na quarta-feira e, sem memória da segunda-feira, escreve com toda a razoabilidade RETRY_LIMIT. Ambos são bons nomes. Juntos, são um bug à espera de alguém editar um e esquecer o outro.

Isto não é um palpite. O "The Maintainability Gap" da GitClear acompanhou 623 million changed lines de 2023 a 2026 e descobriu um aumento de 81% em blocos de código duplicados, enquanto a percentagem de commits que realmente refatoram caiu de 21% para menos de 4%. A análise da CodeRabbit a 470 pull requests concluiu que os PRs escritos por IA têm 1.7x mais problemas do que os de humanos, com inconsistências de nomenclatura a surgir cerca do dobro das vezes. Os agentes escrevem. Ninguém consolida. E isso nunca aparece numa revisão normal de diff, porque cada commit individual parece perfeitamente razoável isoladamente — a inconsistência só existe entre sessões, que é precisamente onde ninguém está a olhar.

O que o VarAlign faz, na prática

O VarAlign é um hook que observa todas as variáveis que um agente de IA escreve, mantém um registo por repositório que persiste entre sessões e reconcilia-o com o que o repositório realmente contém — detetando desvios, eliminações e conceitos duplicados sob nomes diferentes. É determinístico: sem LLM no circuito, sem tokens gastos, nada sai da sua máquina. O registo vive como ficheiros simples dentro do seu próprio repositório, por isso pode ser comparado no git e lido por qualquer ferramenta, sem ficar preso atrás de uma base de dados.

A deteção é sensível à linguagem, o que importa mais do que parece. Os nomes capitalizados em Go significam algo diferente do CONST_CASE em Python; os identificadores do PowerShell não diferenciam maiúsculas de minúsculas; um prefixo partilhado com uma palavra final diferente (HTTP_GET / HTTP_POST) é uma família deliberada, não um duplicado. Errar isto faz com que a ferramenta veja fantasmas até já ninguém ler os relatórios — o que é uma espécie de amnésia por si só.

A continuidade é a prática inteira

Aqui está a parte que vai parecer familiar a qualquer pessoa que ensine ou pratique uma aula regular: uma prática só se acumula se algo for transportado para a frente. Um professor que se lembra da rigidez da sua anca direita pode transformar três meses de pequenos ajustes em mudança real. Um professor que começa do zero todas as vezes só consegue repetir-se, por vezes com palavras ligeiramente diferentes, e o aluno fica a tentar conciliar qual a versão em que deve confiar.

Os agentes de codificação de IA são, por defeito, o professor amnésico. O VarAlign é o caderno que o professor devia ter andado a manter. Não torna o agente mais inteligente. Apenas garante que a terceira sessão sabe o que a primeira sessão já decidiu, para que a base de código acumule um vocabulário em vez de três.

O que foi lançado hoje

A partir de hoje, o VarAlign está na v1.0.0, e o motor mais um plugin para Claude Code estão em código aberto no GitHub sob Apache-2.0. A instalação demora dois comandos e não exige clone local:

/plugin marketplace add greenyogainc/varalign
/plugin install varalign

Como a deteção é baseada em ficheiros, apanha variáveis duplicadas e com desvios, independentemente da ferramenta que as tenha escrito — Claude Code, Kilo, Cursor, Copilot, ou um humano a escrever diretamente. A extensão do VS Code, que adiciona uma lista de duplicados com codificação por cores, substituição com um clique e notas, é lançada separadamente e continua gratuita no Marketplace e no Open VSX.

Como é que o dogfooding realmente se parece

Não lançamos afirmações que não tenhamos testado em nós próprios. Neste momento, o VarAlign está a monitorizar mais de 36,000 atribuições de variáveis em tempo real em 15 dos nossos próprios repositórios, com 1,390 suspeitas de duplicados e desvios já triadas através do seu próprio fluxo de revisão. Só nas vinte e quatro horas em torno deste lançamento, detetou três problemas reais antes de avançarem: um cálculo duplicado silenciosamente dentro de um dashboard, uma constante de severidade redefinida em vez de importada da sua fonte partilhada, e valores de configuração espalhados por scripts que deviam estar a ler de um único local. Nenhum destes casos apareceria numa revisão de código normal — cada alteração parecia correta por si só.

A primeira versão real da extensão do VS Code foi lançada há três dias e já ultrapassou 2,300 transferências.

Um passo para esta semana

Se usa Claude Code, Kilo, Cursor ou Copilot num repositório de qualquer dimensão real, já tem este problema — simplesmente ainda não viu o relatório. Instale o plugin, deixe-o analisar e leia o que ele assinala antes de rejeitar seja o que for. A maior parte do que surgir será uma simples renomeação de cinco minutos. O valor não está em qualquer correção isolada. Está em a base de código ficar com um nome por conceito, em vez de acumular um novo dialeto a cada sprint.

É a mesma coisa que uma boa prática faz ao longo de meses sobre o tapete: não uma descoberta dramática, mas um vocabulário que continua a crescer sobre si próprio em vez de recomeçar do zero.

O motor do VarAlign e o plugin para Claude Code estão em código aberto em github.com/greenyogainc/varalign. A extensão do VS Code é gratuita no Marketplace e no Open VSX. Se quiser ajuda para o implementar numa organização maior, entre em contacto.