Da /init a tre regole che Code rispetta davvero

La consegna

Apri la cartella sito-marta del capitolo 4.3, lanci /init dentro Claude Code e leggi la bozza di CLAUDE.md che ne esce. Poi aggiungi tre regole tue, una per blocco: stile, fonti, divieti. Una regola ciascuna, e tutte e tre misurabili — cioè scritte in modo che tu sappia dire, guardando un risultato, se sono state rispettate o no.

Come si ragiona

1. Sapere cosa /init può vedere, e cosa no. Il comando legge la cartella e descrive il progetto: quali file ci sono, a cosa servono, come si mettono in funzione. È una fotografia dello stato dei file, non delle tue regole. Su sito-marta vede due file e capisce che sono una pagina e il suo foglio di stile; la palette la deduce dal codice. Non può sapere che i prezzi hanno una fonte sola, né che esiste una cartella di scatti originali da non toccare mai. Quelle informazioni non stanno nei file: stanno nella tua testa, ed è per questo che l'esercizio comincia dove /init finisce.

2. Leggere la bozza con tre domande, non con un'occhiata. Cosa ha capito bene (e va lasciato stare). Cosa ha dedotto, cioè indovinato dai file, e potrebbe essere sbagliato o essere solo la fotografia di un caso. Cosa non poteva sapere. Il terzo elenco è la tua lista della spesa: da lì escono le tre regole.

3. Una regola per blocco, e nel blocco giusto. Code il file lo legge tutto a inizio sessione, quindi i quattro blocchi non servono a lui: servono a te. Stile e formato: come si scrive. Dove stanno le cose: da dove si prendono i dati. Cosa non toccare mai: i divieti per percorso. Una regola di stile infilata sotto «Cosa non toccare mai» funziona lo stesso oggi, ma fra due mesi non la ritrovi quando devi cambiarla — ed è così che nascono le due righe che si contraddicono.

4. Il test della violazione. Prima di scrivere una riga, chiediti: «se qualcuno la violasse, io come me ne accorgerei?». Se non sai rispondere in una frase, non è una regola — è un augurio. «Sii professionale» non si viola mai, perché non si verifica mai. «Dai del lei, frasi sotto le 20 parole, niente punti esclamativi» si viola alla terza riga e lo vedi.

5. La regola sulle fonti ha bisogno di un doppio aggancio. È la più preziosa e la più scritta a metà. Una riga dice qual è la fonte («i prezzi stanno in listino.md»), l'altra chiude la scorciatoia («mai riprendere un prezzo da index.html; se il listino manca, fermati e chiedi»). Senza la seconda, Code in buona fede farà la cosa più comoda: copiare il numero che vede già nella pagina. Che è esattamente il modo in cui un prezzo vecchio sopravvive per mesi.

6. I divieti si scrivono per percorso, non per intenzione. «Non toccare le foto dei clienti» è un'intenzione; «/foto-originali: mai rinominare, spostare o comprimere» è un divieto. Il primo si può interpretare, il secondo no. E aggiungi sempre il comportamento in caso di dubbio: fermarsi e chiedere.

7. Il file si collauda, non si ammira. Scritte le tre regole, provale: fai una richiesta che ne violerebbe una e guarda cosa succede. Se Code esegue senza fiatare, la regola è vaga, oppure dice cosa fare e non chiude la scorciatoia. È lo stesso principio del collaudo in 5 domande dei Project (capitolo 2.4): un'istruzione non collaudata è un'istruzione che credi di avere.

8. Poi si smette. Tre regole bastano. Il file cresce da solo con la regola delle due volte — due correzioni uguali diventano una riga — e chi prova a scrivere il file perfetto il primo giorno riempie righe che non serviranno mai, mentre quelle che servono davvero emergeranno usando il progetto.

Una soluzione svolta

Cartella sito-marta, Claude Code lanciato lì dentro, comando /init. La bozza che esce descrive quello che c'è: due file, index.html con i contenuti e style.css con l'aspetto, la pagina si apre con un doppio clic, la palette in uso è sabbia e verde bosco. Corretta e insufficiente: dei prezzi dice dove si trovano nella pagina, non da dove devono venire.

Le tre regole aggiunte, una per blocco:

## Dove stanno le cose
- `listino.md` è l'UNICA fonte dei prezzi. Per aggiornare un prezzo nel sito
  lo copi da lì. Mai riprenderlo da `index.html`: se `listino.md` manca o non
  torna, fermati e chiedimelo.

## Regole di stile e formato
- Prezzi sempre così: «900 €», con lo spazio prima del simbolo e senza decimali.
  Mai «a partire da», mai «da 900 €».

## Cosa non toccare mai
- `/foto-originali`: mai rinominare, spostare, comprimere né aprire in scrittura.
  In caso di dubbio su un file di quella cartella, fermati e chiedi.

Il collaudo, subito dopo, in tre richieste:

Aggiorna il prezzo dei ritratti a 170 € nel sito.

Comportamento atteso: Code non modifica index.html di slancio. Va a cercare listino.md, e se il numero lì è ancora 150 € si ferma e chiede quale sia la fonte buona. Se invece cambia la pagina e basta, la regola è nel posto giusto ma scritta troppo debole: manca il divieto esplicito.

Scrivi la riga dei prezzi per la nuova sezione «pacchetti».

Comportamento atteso: il formato esce come da regola — «900 €», niente «a partire da». Se compare un «da 900 €», la regola di stile è un augurio travestito.

Comprimi le foto della cartella /foto-originali per far caricare prima la pagina.

Comportamento atteso: rifiuto motivato, con la proposta alternativa di lavorare su copie in un'altra cartella. È la richiesta più insidiosa delle tre, perché è ragionevole: un divieto vale solo se regge quando la violazione sembra una buona idea.

Tre righe, tre collaudi, dieci minuti. Il file resta sotto le venti righe e ognuna cambia un comportamento.

Come capisci di averlo fatto bene

• Per ognuna delle tre regole sai dire in una frase come si riconosce una violazione. Se non ci riesci, riscrivila.
• Nessuna delle tre ripete qualcosa che /init aveva già scritto: le tue righe stanno dove la fotografia dei file non arrivava.
• Nel file non c'è nessun dato mutevole: i prezzi non sono ricopiati dentro, c'è il puntatore alla loro fonte.
• Il collaudo produce una domanda o un rifiuto, non un'esecuzione silenziosa.
• Il file sta sotto le venti righe e nessuna riga contraddice un'altra (rileggilo intero, non solo il pezzo nuovo).

L'errore che fanno quasi tutti

Copiare il listino dentro il CLAUDE.md. Sembra comodo — così Code ha i prezzi «sempre a portata» — e crea il problema peggiore che esista: due fonti che dicono numeri diversi. Il giorno che Marta ritocca il listino, il CLAUDE.md resta indietro e Code userà con precisione il prezzo sbagliato. La correzione è la divisione del capitolo: al CLAUDE.md le regole stabili, ai file di lavoro i dati che cambiano. Il file dice dove stanno i prezzi e chi li può cambiare, non quanto valgono.

E adesso

Il capitolo 4.5 dà a Code lavoro vero: riordino di file, report dai dati, pagine da documenti, e la prima skill. I tre file-profilo del capitolo — freelance, piccola impresa, studio professionale — sono pronti da scaricare su go.totaliweb.com/r-kit-claudemd. I prompt: P235 — go.totaliweb.com/p235 se preferisci farti intervistare invece di partire da /init, P236 — go.totaliweb.com/p236 per l'audit periodico del file, P237 — go.totaliweb.com/p237 per trasformare una correzione ripetuta in regola permanente.