Cosa scrivere in CLAUDE.md e cosa collegare a una singola attività
Claude Code legge CLAUDE.md dal repository all’avvio. Codex e molti altri agenti hanno un file dello stesso tipo, AGENTS.md. È un posto comodo per tutto ciò che l’agente deve sapere sul progetto: come lanciare i test, dove si trovano le cose, quali sono le regole del codice.
Col tempo il file cresce, e vi compaiono istruzioni che non servono in ogni attività.
Un esempio: i revisori dopo lo sviluppo
Una tecnica utile per le attività di codice sono i revisori indipendenti. Dopo lo sviluppo l’agente avvia dei subagenti separati che non hanno visto come è stato scritto il codice. Leggono le modifiche e le confrontano con l’attività e con le regole del progetto. Uno controlla se ciò che era stato chiesto è stato fatto. Un altro guarda lo stile e il codice superfluo. L’agente corregge ciò che trovano prima di dire «fatto».
Un’istruzione così occupa una quindicina di righe. Se la metti in CLAUDE.md, l’agente la riceve in ogni sessione: in un’attività sul testo di una landing page e in un’indagine sui log, dove non c’è codice da rivedere. È contesto in più, e a volte lavoro in più.
Anche scriverla a mano in ogni attività non è comodo. È facile dimenticarla, e copiandola da una vecchia attività si rischia di prendere una versione superata.
Un’istruzione per un solo tipo di attività
In Tascue un’istruzione del genere diventa un frammento, per esempio «Revisori indipendenti». Lo selezioni nelle attività in cui il codice cambia, e quando l’attività viene copiata finisce in fondo al prompt. Le attività sui testi e sulle ricerche semplicemente non lo hanno.
Se il frammento nasce quando nel backlog ci sono già molte attività, puoi aggiungerlo a tutte insieme con «Applica a tutte le attività del backlog». Le attività in corso e quelle fatte non cambiano.
Cosa va dove
| Istruzione | Dove tenerla |
|---|---|
| Serve in qualsiasi attività di questo repository: come lanciare i test, com’è fatto il progetto | CLAUDE.md |
| Serve nelle attività di un solo tipo: revisione del codice, verifica nel browser, regole sui testi | Frammento del progetto |
| Serve in tutti i progetti: «non fare commit» | Frammento comune, incluso per impostazione predefinita nelle nuove attività |
| Serve in una sola attività | Testo dell’attività |
Un controllo semplice per una nuova istruzione: serve in ogni attività? Se no, il suo posto è in un frammento, e CLAUDE.md resta abbastanza corto da leggersi in un minuto.
Il prompt si compone da solo a partire dall’attività: intro, campi, testo, frammenti. Puoi incollarlo in Claude Code dopo «Copia» o passarlo tramite MCP, e l’agente riceve la stessa attività completa.