Abbiamo reso open source la memoria che i nostri agenti di coding AI non hanno mai avuto

Immagina un'insegnante di yoga con amnesia. A ogni lezione, ti vede piegarti in avanti e suggerisce "ammorbidisci le ginocchia". La lezione dopo, stesso corpo, stessa abitudine di bloccare le ginocchia — e invece suggerisce "micro-flessione dell'articolazione", avendo dimenticato di averlo mai detto nel primo modo. Nessuno dei due suggerimenti è sbagliato. Ma ora stai tenendo due istruzioni per una sola abitudine, e nessuno nella stanza può dirti che si tratta della stessa cosa.

Questo è ciò che un agente di coding AI fa alla tua codebase, a ogni singola sessione.

Il problema che nessuno mette a diff

Claude, Kilo, Cursor, Copilot — nessuno di loro ricorda come ha chiamato le cose l'ultima volta. Chiedi a un agente di aggiungere un limite ai tentativi di ritentativo il lunedì e scrive MAX_RETRIES. Chiedi a una sessione diversa di fare qualcosa di vicino il mercoledì e, non avendo memoria del lunedì, scrive altrettanto ragionevolmente RETRY_LIMIT. Entrambi sono ottimi nomi. Insieme sono un bug in attesa che qualcuno modifichi uno e dimentichi l'altro.

Non è un'intuizione. "The Maintainability Gap" di GitClear ha tracciato 623 million di righe modificate dal 2023 al 2026 e ha rilevato blocchi di codice duplicati in aumento dell'81%, mentre la quota di commit che refactorano davvero è crollata dal 21% a meno del 4%. La review di 470 pull request di CodeRabbit ha rilevato che le PR scritte da AI hanno 1.7x più problemi di quelle umane, con incoerenze nei nomi che compaiono circa il doppio delle volte. Gli agenti scrivono. Nessuno consolida. E non emerge mai in una normale revisione del diff, perché ogni singolo commit, preso da solo, sembra del tutto ragionevole — l'incoerenza esiste solo tra sessioni, ed è esattamente lì che nessuno sta guardando.

Cosa fa davvero VarAlign

VarAlign è un hook che osserva ogni variabile scritta da un agente AI, mantiene un registro per-repo che sopravvive tra una sessione e l'altra, e lo riconcilia con ciò che il repo contiene davvero — intercettando deriva, eliminazioni e concetti duplicati con nomi diversi. È deterministico: nessun LLM nel loop, nessun token speso, niente lascia la tua macchina. Il registro vive come semplici file all'interno del tuo repo, quindi è confrontabile in git e leggibile da qualsiasi strumento, senza essere vincolato a un database.

Il rilevamento è consapevole del linguaggio, e conta più di quanto sembri. I nomi capitalizzati di Go significano qualcosa di diverso dal CONST_CASE di Python; gli identificatori di PowerShell non fanno distinzione tra maiuscole e minuscole; un prefisso condiviso con una parola finale diversa (HTTP_GET / HTTP_POST) è una famiglia deliberata, non un duplicato. Sbagliare qui significa far gridare al lupo lo strumento finché nessuno leggerà più i suoi report — che è una forma di amnesia a sé.

La continuità è tutta la pratica

Ecco la parte che suonerà familiare a chiunque insegni o frequenti regolarmente una classe: una pratica si accumula solo se qualcosa viene portato avanti. Un'insegnante che ricorda la tua anca destra rigida può costruire tre mesi di piccoli aggiustamenti fino a un cambiamento reale. Un'insegnante che ricomincia da zero ogni volta può solo ripetersi, a volte con parole leggermente diverse, e lo studente resta a dover capire quale versione fidarsi.

Gli agenti di coding AI sono, per impostazione predefinita, l'insegnante smemorato. VarAlign è il quaderno che l'insegnante avrebbe dovuto tenere. Non rende l'agente più intelligente. Si limita a fare in modo che la terza sessione sappia già ciò che la prima sessione aveva deciso, così la codebase accumula un solo vocabolario invece di tre.

Cosa è stato rilasciato oggi

Da oggi, VarAlign è v1.0.0, e il motore più un plugin per Claude Code sono open source su GitHub sotto Apache-2.0. Installarlo richiede due comandi e nessun clone locale:

/plugin marketplace add greenyogainc/varalign
/plugin install varalign

Poiché il rilevamento è basato su file, intercetta variabili duplicate e derivate anche se sono state scritte da strumenti diversi — Claude Code, Kilo, Cursor, Copilot o un essere umano che digita direttamente. L'estensione per VS Code, che aggiunge un elenco di duplicati con codice colore, override con un clic e note, viene distribuita separatamente e resta gratuita su Marketplace e Open VSX.

Che aspetto ha davvero il dogfooding

Non pubblichiamo affermazioni che non abbiamo testato su noi stessi. Al momento VarAlign sta monitorando in tempo reale più di 36,000 assegnazioni di variabili in 15 dei nostri repo, con 1,390 sospetti di duplicati e deriva già presi in carico tramite il suo flusso di revisione. Nelle ventiquattro ore attorno a questo rilascio, da solo, ha intercettato tre problemi reali prima che andassero oltre: un calcolo duplicato in silenzio dentro una dashboard, una costante di severità ridefinita invece di essere importata dalla sua sorgente condivisa, e valori di configurazione sparsi tra script che avrebbero dovuto leggere da un unico punto. Nessuno di questi sarebbe emerso in una normale code review — ogni modifica, presa da sola, sembrava corretta.

La prima vera release dell'estensione per VS Code è uscita tre giorni fa e ha già superato 2,300 download.

Una mossa per questa settimana

Se usi Claude Code, Kilo, Cursor o Copilot su un repo di dimensioni anche solo un po' reali, hai già questo problema — semplicemente non hai ancora visto il report. Installa il plugin, lascialo eseguire la scansione e leggi ciò che segnala prima di scartare qualsiasi cosa. La maggior parte di ciò che emerge sarà una facile rinomina da cinque minuti. Il valore non sta in una singola correzione. Sta nel fatto che la codebase si stabilizza su un solo nome per concetto invece di accumulare un nuovo dialetto a ogni sprint.

È la stessa cosa che una buona pratica fa per mesi sul tappetino: non una svolta clamorosa, ma un vocabolario che continua a costruirsi su se stesso invece di ricominciare da capo.

Il motore di VarAlign e il plugin per Claude Code sono open source su github.com/greenyogainc/varalign. L'estensione per VS Code è gratuita su Marketplace e Open VSX. Se vuoi aiuto per distribuirlo su un'organizzazione più grande, contattaci.