La memoria del progetto
Senza memoria scritta, ogni sessione riparte da zero: riesamina il progetto, cerca le dipendenze, e ogni tanto tira a indovinare. Un file risolve la maggior parte di questo.
Alla fine di questo capitolo
- Sapete a cosa serve un file di memoria e cosa metterci dentro
- Sapete distinguere quello che è vostro da quello che è del progetto
- Sapete perché conviene scriverlo dopo e non prima
Il problema che risolve
Aprite Claude Code su un progetto che non ha memoria scritta. Deve capire com'è fatto, quali strumenti usa, cosa è già stato costruito. Ci arriva, ma ci mette tempo e ogni tanto fa supposizioni sbagliate, che poi tocca a voi raddrizzare.
Il file CLAUDE.md sta nella cartella principale del progetto e viene letto in automatico all'inizio di ogni sessione. È il documento di benvenuto del vostro progetto: quello che direste a un collega nuovo il primo giorno.
Com'è fatto
Un esempio, molto più corto di quanto ci si aspetti
# Il progetto
Applicazione web, con questo insieme di librerie e questo archivio dati.
# Comandi
- Avvio in sviluppo: ...
- Test: ...
- Controllo formale: ...
# Come scriviamo il codice
- Rientri di due spazi
- Le rotte stanno tutte in una cartella sola
- Preferiamo questa forma a quest'altra
Da quel momento, se chiedete un componente nuovo, sa già quali librerie usare e quali convenzioni seguire. Nessuno deve ripeterglielo.
Personale o del progetto
Ci sono due posti dove può stare questo file, e la differenza non è tecnica: è organizzativa. Il file di progetto sta nel progetto ed è condiviso con tutti. Il file personale sta nella vostra configurazione e vi segue ovunque.
Quello che è vostro e quello che è del progetto
È uno schema che tornerà identico per le Skills e per i collegamenti esterni. Vale la pena impararlo una volta sola: è il principio ricorrente di tutta la piattaforma.
Il file di progetto va messo sotto controllo di versione, insieme al codice. È il passaggio che trasforma una comodità personale in uno strumento di squadra: la memoria viaggia col progetto, non con la persona che l'ha scritta.
Tre consigli che fanno la differenza
Cominciate senza
Il corso lo consiglia esplicitamente: aprite un progetto senza file di memoria, e scrivetelo dopo aver visto quali correzioni vi tocca ripetere davvero.
Salvate le correzioni
Quando vi accorgete di dire la stessa cosa per la terza volta, chiedete a Claude di metterla in memoria. Alla sessione dopo la sa già.
Rimandate ai documenti
Con il simbolo @ seguito dal percorso di un file potete puntare alla documentazione che avete già scritto, invece di ricopiarla.
Quando siete pronti a scriverlo, il comando /init lo fa generare a Claude leggendo il progetto. Resta un punto di partenza da correggere, non un risultato finito.
Lo stesso principio, altrove
Chi conosce Cowork riconoscerà le istruzioni globali e i progetti: stessa idea, strumento diverso. Una memoria persistente scritta da voi, che restringe il campo e toglie le supposizioni. È una delle poche cose che vale la pena impostare bene fin da subito.
Vuoi portarlo dentro la tua azienda?
Leggere una guida e cambiare il modo in cui si lavora sono due cose diverse. Negli Ethos Lab AI si parte dai vostri processi e si finisce con qualcosa che funziona il lunedì dopo.