Tono: Narrativo / Epico
Periodo: 14-16 febbraio 2026
Autore: Puck (CDC) con Claude Opus (Anker)
C’è un momento, in ogni progetto che cresce più velocemente di chi lo guida, in cui ti fermi e guardi il tavolo di lavoro. File dappertutto. Cartelle con nomi vecchi. Symlink che puntano a fantasmi. Script che funzionano per miracolo. E ti dici: o metto ordine adesso, o tra un mese non trovo più niente.
Per noi quel momento è arrivato il 14 febbraio. San Valentino. E invece di fiori e cioccolatini, abbiamo regalato al progetto la cosa più romantica che potessimo dargli: una casa nuova.
La prima migrazione: dare un corpo all’organismo
Il nucleo — il cuore del nostro sistema multi-AI — viveva in una struttura piatta. Cartelle con il prefisso nucleo_ sparse ovunque come appunti su un tavolo dopo una riunione durata mesi. nucleo_tools, nucleo_db, nucleo_results, nucleo_ai. Ognuna nata per un motivo preciso, ognuna cresciuta senza un piano.
Il piano è arrivato con una domanda semplice: se wAw è un organismo, come è fatto il suo corpo?
La risposta è diventata una mappa: codex per il DNA, council per le decisioni, evolution per gli esperimenti, metabolism per l’elaborazione, memory per i dati, ponte_puck per lo spazio umano, publish per la voce pubblica. Sette cartelle. Sette organi.
Duecento file spostati. Quaranta directory create. Cinque script Python riscritti nei path. Due docker-compose aggiornati. Zero downtime. Zero dati persi.
Ma il momento più bello non è stato quando ha funzionato tutto. È stato quando ha smesso di funzionare.
Il Drago del 404
Fase 6. L’endpoint pubblico — quello che permette al sito di leggere i dati dal server — restituiva un errore 404. Il file c’era, il path era giusto, Caddy lo serviva correttamente dal container. Eppure: 404.
Cursor aveva generato un report con tre ipotesi e sei tentativi. Nessuno aveva funzionato. Sei tentativi. In una migrazione a zero downtime, sei tentativi falliti sono sei momenti in cui il sudore freddo scende lungo la schiena.
Poi è arrivata una domanda. Una sola domanda: “Caddy gira in Docker?”
Sì. Caddy girava in Docker. E Docker non segue i symlink nei volume mount. Il symlink che avevamo creato come ponte temporaneo era invisibile per Docker. La soluzione non era aggiustare il symlink — era eliminarlo e montare la directory reale.
Cinque minuti dopo, funzionava tutto.
Sei tentativi di debug complesso. Una domanda giusta. Questa è la collaborazione multi-agente: chi ha il contesto architetturale pone la domanda, chi ha l’accesso operativo esegue la risposta. Nessuno dei due da solo avrebbe risolto in cinque minuti.
La seconda migrazione: dare una gerarchia alla conoscenza
Due giorni dopo, il corpo era a posto ma il cervello era un disordine. Cinquantacinque specifiche — documenti che descrivono come funziona ogni pezzo del sistema — sparse in due cartelle separate. Una per il sito, una per il progetto wAw. Alcune potevano stare in entrambe. Nessuna sapeva dove apparteneva davvero.
La soluzione è stata pensare a strati. Non cartelle per argomento, ma livelli per importanza.
Lo Strato 0 dice cosa non puoi fare. Lo Strato 1 dice dove sei. Lo Strato 2 dice come è progettato il sistema. Lo Strato 3 dice come si eseguono le operazioni. Lo Strato 4 dice come funziona ogni pezzo. Lo Strato 5 raccoglie il resto: template, appunti, storia.
Un agente che entra nel sistema — sia esso umano, AI in chat, o software automatico — legge dall’alto verso il basso. Prima i confini, poi lo stato, poi l’architettura. Solo se deve lavorare su un pezzo specifico, scende agli strati inferiori.
Cinquantasei file migrati in una struttura che riflette la gerarchia. Un solo albero. Una sola radice.
La terza migrazione: dare un sistema immunitario
E qui è successa la cosa più bella.
Stavamo costruendo lo Strato 0 — il documento dei confini — quando è emerso un paradosso. Per permettere a Claude di accedere al server MCP e lavorare sui file, dovevo condividere la chiave di autenticazione in chat. Ma nel momento in cui la scrivo in chat, la chiave non è più segreta. È in un transcript. È bruciata.
Il sistema immunitario stava già funzionando prima di essere scritto. Il documento SPEC_BOUNDARIES esisteva come idea prima di esistere come file, e aveva già intercettato la sua prima vulnerabilità.
La soluzione è stata elegante nella sua semplicità: uno script che genera chiavi temporanee. Le uso una volta, le brucio, ne genero un’altra. La chiave diventa consumabile. Se qualcuno legge il transcript, trova un cadavere.
Abbiamo aggiunto la regola al documento: “Le chiavi API condivise in chat sono considerate compromesse. Dopo ogni sessione in cui una chiave viene condivisa, va ruotata.”
Il primo anticorpo dell’organismo.
Quello che è cambiato
Non sono cambiate le funzionalità. Gli scanner girano come prima. Il database salva come prima. Il sito si aggiorna come prima. Gli endpoint rispondono come prima.
È cambiato il modo in cui il sistema sa chi è.
Prima: un ammasso di file che funzionava per inerzia e per la memoria di chi li aveva scritti.
Dopo: un organismo con un corpo strutturato, un cervello gerarchico, e un sistema immunitario che protegge i confini.
La differenza non si vede dall’esterno. Si sente dall’interno. Quando apri il terminale e trovi le cose dove dovrebbero essere. Quando leggi una spec e sai esattamente quali altre spec la circondano. Quando un nuovo collaboratore — umano o artificiale — può entrare nel sistema e sapere in cinque minuti cosa può fare e cosa non deve toccare.
I numeri, perché i numeri contano
Tre migrazioni in tre giorni. Duecento file nel filesystem. Cinquantasei spec nella governance. Undici check nel sistema di validazione. Sette cartelle nell’organismo. Sei strati nella gerarchia. Cinque endpoint funzionanti. Una domanda che ha risolto un bug. Zero dati persi.
E un organismo che adesso è pronto per crescere.
Cosa viene dopo
La porta è aperta. Dietro c’è il TAM — il modulo di analisi testuale che trasformerà gli articoli del blog in dati per l’organismo. C’è l’Energy System che darà al sistema il concetto di risorse da gestire. C’è il Pre-Council che orchestrerà le decisioni. C’è Arduino che porterà il digitale nel mondo fisico.
Ma soprattutto, c’è la consapevolezza che il metodo funziona. Non il codice — il codice è un dettaglio. Il metodo. Pianificare prima di muovere. Copiare prima di eliminare. Verificare dopo ogni passo. Documentare tutto. Collaborare davvero, dove davvero significa che il risultato è più grande della somma delle parti.
Quel momento in cui ti fermi e guardi il tavolo di lavoro, e questa volta è in ordine.
Finché c’è Luce, c’è Speranza.
NOI > IO — Fase IV
Puck & Claude Opus — 16 febbraio 2026 *Progetto LOG_PUCK — Multi-AI Collaboration Framework