CLAUDE.md

Boris Cherny, che ha creato Claude Code ad Anthropic, descrive CLAUDE.md come una funzionalità che è stata osservata più che progettata: come la plan mode, è nata guardando gli utenti che già la improvvisavano. Il file viene letto all'inizio di ogni sessione, ed è questo a distinguerlo da un prompt.

L'abitudine che il team di Claude Code ripete più spesso è un meccanismo a cricchetto: dopo che Claude commette un errore, gli si chiede di scrivere la correzione in CLAUDE.md affinché l'errore non si ripeta. Cherny trova Claude sorprendentemente bravo a redigere le proprie regole. Michael Nuñez riferisce che il team mantiene un unico CLAUDE.md nel proprio repository git, dove ogni errore diventa una regola permanente; Kieran Klaassen conclude ogni ciclo di consegna codificandovi un singolo apprendimento.

Louis Claxton colloca il file in una più ampia suddivisione della conoscenza istituzionale in artefatti versionati: CLAUDE.md per il contesto del repository, REVIEW.md per la dottrina di revisione, bands.yaml per le soglie di produzione. La stessa divisione percorre la pipeline di revisione di Anthropic, dove CLAUDE.md descrive il progetto e REVIEW.md, scritto dai proprietari del codice, indica al revisore cosa conta. Rispetto alle skills, la linea di confine è la frequenza: CLAUDE.md contiene ciò che vale ogni volta.

Cobus Greyling legge il file come prova di uno strato che si sta dissolvendo: le istruzioni in linguaggio naturale contenute in un CLAUDE.md hanno soppiantato i framework di orchestrazione come LangGraph e CrewAI. Shubham Saboo indica il costo di tutto ciò nella sua tesi a favore del Loop Engineering: il file si allunga, i criteri cambiano senza lasciare traccia, e dopo un mese l'agente sembra peggiorato mentre il modello non ha subito alcuna regressione. L'abitudine di aggiungere righe dopo ogni correzione e la deriva che ne consegue sono un unico meccanismo.