CLAUDE.md

Il team di Boris Cherny in Anthropic mantiene un unico file CLAUDE.md nel proprio repository git, e la regola ad esso associata è precisa: ogni volta che Claude commette un errore, l'errore viene annotato nel file affinché non si ripeta. Cherny riferisce che Claude è sorprendentemente bravo a redigere le proprie regole. Kieran Klaassen chiude ogni ciclo di consegna allo stesso modo, confrontando l'implementazione con il piano e codificando un apprendimento in CLAUDE.md.

Ciò che il file contiene è il contesto del repository valido per ogni sessione: comandi, convenzioni, architettura ed errori ricorrenti dell'agente. Questa è la linea che lo separa dagli skill, che veicolano flussi di lavoro procedurali invocati su richiesta. Louis Claxton, dell'Applied AI team di Anthropic, lo colloca tra gli artefatti versionati assieme a REVIEW.md per la dottrina di revisione e bands.yaml per le soglie di produzione: conoscenza istituzionale mantenuta come file sotto controllo di versione. Il curriculum di Claude Code descrive quattro livelli di memoria, con il CLAUDE.md di progetto collocato tra la policy aziendale e il CLAUDE.md utente.

Anche la modalità di fallimento è documentata. Shubham Saboo la chiama drift: il CLAUDE.md si allunga, i criteri di valutazione cambiano senza lasciare traccia, e un mese dopo l'agente sembra peggiore benché il modello non sia regredito. Le valutazioni di Jude Gao su Vercel, condotte sul file gemello AGENTS.md, mostrano il costo dall'altro lato, poiché il contesto passivo viene iniettato nel system prompt a ogni turno; Vercel ha compresso 40 KB di documentazione in un indice di 8 KB per sostenere quel costo. Un file a cui tutti scrivono e che nessuno pota.