Copertina: Atlas: source control per coding agent AI

Atlas: source control per coding agent AI

Checkpoint, memoria condivisa e confronto parallelo per capire quale agente ha fatto cosa e perché.

30 settembre 20267 min di lettura
Atlascoding agentsource controlsviluppo softwareClaude CodeCodexmemoria condivisaopen source

Quando un programmatore scrive codice a mano, la storia del lavoro è relativamente chiara: commit Git, messaggi, pull request, revisioni. Quando a scrivere è un agente AI che esegue decine di azioni in pochi minuti — legge file, lancia comandi, riscrive interi moduli — quella storia si perde. Restano solo i file finali, senza il contesto che li ha generati. Atlas nasce per colmare questa lacuna: un archivio locale che registra le sessioni di lavoro degli agenti di programmazione, le rende ispezionabili e confrontabili e consente di far collaborare o competere più agenti sullo stesso compito.

Cos'è Atlas e quale problema affronta

Atlas è un'applicazione open source distribuita con licenza Apache-2.0 e pubblicata su GitHub dall'account pacifio. Non è un modello linguistico né un nuovo coding assistant: è un'infrastruttura che si affianca agli assistenti esistenti, come Claude Code, Codex e altri agenti da terminale già diffusi tra sviluppatori. L'idea di fondo si spiega con un paragone: se Git è il diario dei file, Atlas vuole essere il diario del lavoro degli agenti.

Oggi chi usa un agente per programmare incontra tre difficoltà ricorrenti. La prima è la tracciabilità: dopo una sessione lunga è difficile sapere quale prompt ha generato quale modifica, quali file sono stati letti, quali comandi sono stati eseguiti e quali ragionamenti intermedi hanno portato a una scelta. La seconda è la continuità: cambiando agente a metà progetto, il contesto va perso e bisogna rispiegare tutto da capo. La terza è la valutazione: per un titolare di agenzia o un responsabile tecnico è complicato confrontare in modo oggettivo due agenti diversi sullo stesso problema.

Atlas propone di registrare per ogni sessione il prompt iniziale, le chiamate agli strumenti, le tracce di ragionamento rese disponibili dall'agente, le differenze sui file e i checkpoint di avanzamento, conservando tutto in locale secondo un'impostazione local-by-default.

A cosa serve in pratica

Per un founder senza background tecnico, per una piccola software house o per un reparto IT di una PMI manifatturiera o di servizi, Atlas non scrive codice al posto delle persone: aiuta a governare chi lo scrive. Il primo uso concreto è l'audit delle sessioni. Ogni esecuzione diventa un fascicolo consultabile: cosa è stato chiesto, cosa ha fatto l'agente, quali file ha toccato, in quale ordine. In caso di errore, si può tornare a un checkpoint precedente e capire dove è nata la regressione, invece di ricominciare da zero.

Il secondo uso è la continuità operativa. Se un progetto inizia con un agente e prosegue con un altro, la memoria condivisa evita di perdere decisioni, vincoli e preferenze già espresse. Per un'agenzia che gestisce siti o gestionali per clienti diversi, questo significa meno rilavorazioni e meno dipendenza dal singolo strumento del momento.

Il terzo uso è la sperimentazione controllata. Atlas consente di lanciare due o più agenti in parallelo sullo stesso compito — per esempio rifattorizzare un modulo di fatturazione o generare test per una API — e osservare fianco a fianco approcci, tempi e qualità. Non è una classifica automatica di merito, ma un banco di prova che rende visibili differenze altrimenti impressionistiche.

Come funziona: checkpoint e archiviazione locale

Dal punto di vista tecnico, Atlas si colloca tra l'utente e i coding agent. L'utente continua a usare i propri assistenti da terminale, spesso legati ad abbonamenti esistenti, senza dover necessariamente acquistare token API aggiuntivi per ogni prova — aspetto indicato dalla documentazione come obiettivo, da verificare sul campo caso per caso. Atlas intercetta l'avvio della sessione, ne registra i metadati e crea checkpoint man mano che il lavoro avanza.

Ogni checkpoint contiene, secondo la descrizione degli autori, quattro tipi di informazioni: il prompt che ha avviato la fase, la sequenza di chiamate agli strumenti come lettura e scrittura file ed esecuzione comandi, le tracce di ragionamento esposte dall'agente e le modifiche effettive ai file. Questo pacchetto viene salvato in locale e indicizzato per la ricerca. Un'interfaccia consente di sfogliare la cronologia, filtrare per sessione, agente o file, ripristinare uno stato precedente e confrontare due stati con viste differenziali simili a quelle dei sistemi di controllo versione tradizionali.

La distribuzione avviene come applicazione desktop costruita con Tauri, con pacchetti per macOS e Windows pubblicati nelle release, oltre alla compilazione dai sorgenti. L'architettura punta a mantenere i dati sul dispositivo dell'utente, senza invio obbligatorio a server esterni, scelta rilevante per chi tratta codice proprietario o dati soggetti a riservatezza. Il supporto per Linux risulta indicato dagli stessi autori come non ancora verificato in modo completo, e le prestazioni su repository molto grandi restano da misurare con prove indipendenti.

Memoria condivisa e confronto fianco a fianco

Due funzioni distinguono Atlas dai semplici plugin di cronologia. La prima è la memoria condivisa tra agenti. In un flusso normale ogni agente mantiene il proprio contesto in modo isolato: passando da uno strumento a un altro, istruzioni, convenzioni di codice e decisioni architetturali vanno reinserite manualmente. Atlas propone un livello comune dove prompt, note e checkpoint restano disponibili a prescindere dall'agente utilizzato. Nella pratica si può iniziare un'attività con un agente e farla proseguire o revisionare da un secondo agente che ritrova lo stesso fascicolo di lavoro, riducendo l'effetto di perdita di contesto tipico dei cambi di strumento.

La seconda funzione è l'esecuzione fianco a fianco. Invece di provare gli agenti in sequenza, l'utente avvia sessioni parallele dallo stesso punto di partenza e osserva come ciascuno interpreta le istruzioni, quali file esplora, quanti passaggi compie e quale soluzione consegna. Per una PMI che deve scegliere su quale abbonamento investire o per un'agenzia che vuole standardizzare test e documentazione, questa comparabilità sposta la scelta da sensazioni a evidenze e mostra i punti di forza di ciascuno: sintesi, prudenza nelle modifiche, copertura dei test.

Perché conta per founder, PMI e agenzie italiane

Per il contesto italiano, dove molte imprese hanno team tecnici piccoli e forte ricorso a fornitori esterni, il valore non è nella potenza del singolo modello, ma nel governo del processo. Un titolare che commissiona un gestionale, un sito e-commerce o un'integrazione con fatturazione elettronica ha bisogno di sapere come il software è stato prodotto, di poterlo mantenere nel tempo e di non restare legato a un solo fornitore o strumento. La tracciabilità delle sessioni risponde a esigenze concrete: documentare il lavoro per la manutenzione, mostrare a un cliente cosa è stato fatto e perché, gestire passaggi di consegne tra collaboratori.

C'è poi il tema della riservatezza. Codice sorgente, listini, anagrafiche clienti e processi interni non possono circolare liberamente. Un approccio che conserva checkpoint e memoria sul dispositivo, senza centralizzazione obbligatoria, è più compatibile con le politiche di molte PMI rispetto a servizi che impongono l'invio di tutto nel cloud. Resta inteso che locale non significa automaticamente sicuro: permessi, cifratura del disco, backup e gestione degli accessi restano responsabilità dell'impresa.

Infine, la possibilità di confrontare agenti aiuta a evitare investimenti impulsivi. Prima di standardizzare la produzione su un unico assistente, un'agenzia può misurare su progetti copia, con dati fittizi, quale strumento produce codice più manutenibile e test più utili.

Licenza, limiti e dove trovarlo

Atlas è pubblicato su GitHub all'indirizzo github.com/pacifio/atlas con licenza Apache-2.0, che consente uso, modifica e integrazione anche in contesti commerciali, con obblighi di conservazione delle note di licenza. Il progetto è giovane e in evoluzione: la documentazione non copre ancora tutti i casi e alcune affermazioni su prestazioni, sincronizzazione tra postazioni e consumi non risultano verificate da prove indipendenti.

Per chi vuole valutarlo, la strada prudente è provarlo in una macchina di laboratorio, su una copia del codice e senza credenziali reali: installazione dai pacchetti delle release per macOS e Windows o compilazione dai sorgenti, avvio di una sessione di prova con un solo agente, ispezione dei checkpoint e verifica di dove i dati vengono salvati. Solo dopo questa verifica ha senso pensare a un uso su progetti reali, definendo regole interne su cosa registrare, per quanto conservarlo e chi può accedervi.

Hai letto fino a qui

🤔 Hai domande su questo argomento?

Posso aiutarti a capire come applicarlo al tuo business. Scegli come vuoi parlarmi.

— oppure —

💬 Chat: risposta immediata · 📧 Email: risposta personale entro 24h · 🔒 Niente spam

Continua a leggere