Un semplice file di testo ha cambiato per sempre il modo in cui gli sviluppatori usano l'AI per scrivere codice.
Non un nuovo modello.
Non un costoso IDE.
Non un'altra startup di "agenti AI".
Solo un file:
CLAUDE.md
E che è diventato, silenziosamente, uno dei setup per sviluppatori in più rapida crescita su GitHub.
82.000+ stelle.
Migliaia di fork.
Ingegneri, da startup a team enterprise, che lo copiano nei loro progetti dall'oggi al domani.
Perché gli sviluppatori hanno finalmente capito una cosa:
Claude Code non fallisce perché il modello è debole.
Fallisce perché ogni sessione inizia in uno stato di amnesia.
Ogni volta che apri Claude Code, dimentica:
• il tuo stack
• le tue decisioni di architettura
• le tue convenzioni di nomenclatura
• i tuoi standard di codifica
• cosa è già fallito la settimana scorsa
• cosa NON dovrebbe mai essere modificato
• perché hai scelto un framework invece di un altro
• quali file sono troppo rischiosi da toccare
Quindi il modello fa quello che qualsiasi AI fa senza contesto:
Indovina.
E quelle supposizioni diventano estremamente costose.
Gli chiedi di sistemare una funzione.
Lui riscrive tre file.
Rinomina variabili che hai scelto intenzionalmente.
Refactoring di codice funzionante.
Suggerisce strumenti incompatibili con la tua architettura.
Cancella cose "per pulizia".
Modifica la formattazione che nessuno gli ha chiesto di toccare.
E poi passi l'ora successiva ad annullare il "suo aiuto".
Questa è la tassa nascosta del coding con l'AI di cui nessuno parla.
Un engineering manager ha stimato che il suo team perdeva quasi 8 ore a settimana solo per:
→ rispiegare il contesto del progetto
→ annullare modifiche non autorizzate
→ correggere presupposti errati
→ re-insegnare le decisioni di architettura
→ fermare lo scope creep
Questo non è un problema di AI.
È un problema di memoria.
E CLAUDE.md lo risolve nel modo più semplice possibile.
È solo un semplice file di testo nella root del tuo progetto.
Ma Claude lo legge automaticamente all'inizio di ogni sessione.
Il che significa che la tua AI finalmente inizia con il contesto, non nel caos.
La differenza è enorme.
Senza CLAUDE.md:
"Assistente AI"
Con CLAUDE.md:
"Ingegnere che conosce già il tuo progetto."
Il file di solito contiene 3 livelli.
━━━━━━━━━━━━━━━
- REGOLE PREDEFINITE ━━━━━━━━━━━━━━━
Questa sezione insegna a Claude come lavori.
Quanto dettagliate devono essere le risposte.
Qual è il tuo stack.
Come comunichi.
Quanto contesto già conosci.
Che stile di scrittura usare.
Cosa NON fare.
Cose come:
→ non usare frasi di riempimento
→ mantenere le risposte proporzionate alla complessità del compito
→ chiedere prima di fare supposizioni
→ non spiegare mai eccessivamente i concetti base
→ seguire esattamente il mio stile di codifica
→ rispettare automaticamente i vincoli del progetto
Sembra poco.
Ma distribuito su centinaia di prompt?
Elimina una quantità enorme di ripetizioni.
La maggior parte degli sviluppatori, inconsapevolmente, perde 20–40 minuti al giorno a re-insegnare il contesto all'AI.
Ogni. Singola. Sessione.
Ora moltiplicalo per un intero team di ingegneri.
Sono migliaia di dollari al mese sprecati solo per ripeterti.
━━━━━━━━━━━━━━━
- CONTROLLO DEL COMPORTAMENTO
━━━━━━━━━━━━━━━
Questa è la sezione che gli sviluppatori vorrebbero aver avuto mesi fa.
Perché è qui che fermi Claude dal diventare "creativamente distruttivo".
Definisci confini rigidi come:
→ tocca solo i file direttamente correlati al compito
→ non fare mai refactoring di codice non correlato
→ chiedi prima di cancellare qualsiasi cosa
→ conferma prima di azioni distruttive
→ non riscrivere la struttura esistente senza approvazione
→ mostra sempre esattamente cosa è cambiato
→ non distribuire o eseguire migrazioni automaticamente
Questa singola sezione previene la maggior parte degli incubi del coding con l'AI.
Niente più riscritture a sorpresa.
Niente più deriva dell'architettura.
Niente più disastri del tipo "ho ripulito questo per te".
L'AI diventa prevedibile.
Che è esattamente ciò che gli ingegneri vogliono.
━━━━━━━━━━━━━━━
- MEMORIA + CERVELLO DEL PROGETTO
━━━━━━━━━━━━━━━
È qui che le cose diventano veramente potenti.
Gli sviluppatori hanno iniziato ad abbinare CLAUDE.md a file come:
MEMORY.md
ERRORS.md
Ora Claude può ricordare:
• decisioni che il tuo team ha già preso
• approcci falliti
• strumenti scartati
• incidenti di produzione
• vincoli tecnici
• compromessi architetturali
• regole specifiche del cliente
Il che significa che l'AI smette di consigliare cose che hai già escluso mesi fa.
Smettе di dimenticare.
Questo cambia tutto.
Perché il vero collo di bottiglia nel coding con l'AI non è più la generazione di codice.
È il contesto persistente.
E la maggior parte delle persone non lo ha ancora capito.
━━━━━━━━━━━━━━━
LE 4 REGOLE CHE L'HANNO RESO VIRALE
━━━━━━━━━━━━━━━
Il setup è esploso dopo che gli sviluppatori hanno iniziato a condividere 4 semplici regole ispirate all'approccio di Andrej Karpathy al lavoro con i sistemi AI.
Sembrano ingannevolmente semplici:
- Chiedi prima di presumere.
- Usa prima la soluzione più semplice.
- Non toccare codice non correlato.
- Segnala l'incertezza immediatamente.
Tutto qui.
Ma queste 4 regole risolvono la maggior parte dei fallimenti del coding con l'AI.
Perché il danno maggiore di solito arriva quando l'AI agisce con sicurezza ma senza abbastanza contesto.
Gli sviluppatori che ottengono i risultati migliori non stanno usando "più AI".
Stanno riducendo l'ambiguità.
E una volta che lo vedi, non puoi più non vederlo.
━━━━━━━━━━━━━━━
IL VERO DIVARIO NEL CODING CON L'AI
━━━━━━━━━━━━━━━
In questo momento, ci sono fondamentalmente due tipi di sviluppatori che usano Claude Code.
Gruppo 1:
Inizia ogni sessione da zero.
Ripete il contesto ogni giorno.
Pulisce le modifiche indesiderate.
Combatte costantemente lo scope creep.
Tratta l'AI come un completamento automatico temporaneo.
Gruppo 2:
Usa istruzioni persistenti.
Blocca le regole comportamentali.
Mantiene la memoria del progetto.
Controlla rigorosamente lo scope.
Tratta l'AI come un collaboratore ingegneristico a lungo termine.
Stesso modello.
Risultati completamente diversi.
Ecco perché questo file si è diffuso così velocemente.
Perché una volta che Claude ha:
• regole
• memoria
• consapevolezza dello stack
• vincoli comportamentali
• contesto del progetto
…smette di sembrare un chatbot.
E inizia a sembrare un'infrastruttura.
━━━━━━━━━━━━━━━
INIZIA QUI
━━━━━━━━━━━━━━━
Apri il tuo progetto.
Crea un file chiamato:
CLAUDE.md
Poi incolla prima queste 4 regole:
• Chiedi prima di presumere
• Soluzione più semplice prima
• Non toccare codice non correlato
• Segnala l'incertezza esplicitamente
Questo da solo migliorerà immediatamente il comportamento di Claude.
Poi espandilo gradualmente nel tempo:
→ il tuo stack
→ standard di codifica
→ regole di architettura
→ azioni vietate
→ registri delle decisioni
→ memoria del progetto
La maggior parte degli sviluppatori non lo ha ancora fatto.
Il che significa che il divario tra il coding assistito dall'AI nella media e quello d'élite sta diventando meno una questione di modelli…
…e più una questione di chi sa come strutturare il contesto correttamente.
Segna questa pagina.
Perché tra sei mesi, la memoria persistente dei progetti AI sarà probabilmente normale quanto lo sono oggi i repository GitHub.
