Il cervello e il braccio
Il principio
Claude.ai è il cervello. Claude Code è il braccio. Confondere i due ruoli è il modo più veloce per perdere tempo.
Dove installare le skill
Su Claude.ai vivono nelle Competenze le skill che lavorano sul ragionamento e sul testo: scrittura, brainstorm, gestione documenti, ricerca. Su Claude Code vivono in ~/.claude/ le skill che hanno bisogno del terminale: tutto quello che è coding, ogni MCP che parla con un servizio esterno, ogni hook. Le skill che funzionano in entrambi gli ambienti (taste-skill, skill-creator) le tengo su Claude.ai per uso quotidiano, e copiate anche nei progetti CC importanti.
All'inizio di un progetto nuovo
Apro Claude.ai. Brainstormiamo: cosa voglio costruire, perché, per chi, con quale stack. Niente codice — solo idee, vincoli, decisioni. Quando il quadro è chiaro, gli chiedo di scrivermi un prompt da incollare in Claude Code. Quel prompt contiene solo contesto e specifiche: cosa fare, come, con quale architettura. Mai codice in quel prompt. Codice lo scriverà CC, lì dove vive il filesystem.
Da lì in poi
Apro Claude Code nella cartella del progetto, incollo il prompt, e tutto il lavoro pratico avviene lì. Torno su Claude.ai solo quando devo pensare grosso: ripensare un'architettura, sbloccare un dubbio strategico, scrivere un prompt per una sessione successiva. Il braccio resta nel terminale, il cervello fuori.
Due file per partire
Ogni progetto serio inizia con due file. Un CLAUDE.md che dice a Claude come comportarsi mentre lavora con te, e un SPEC.md che dice cosa stai costruendo. Li scrivi una volta, all’inizio, e Claude li legge da solo a ogni sessione.
CLAUDE.md — dice a Claude come comportarsi
# CLAUDE.md — [nome del progetto]
# Questo file dice a Claude come comportarsi mentre lavora con te.
# Lo legge da solo ogni volta che apri il progetto: non devi ricordarglielo.
# Riempi le parti tra parentesi quadre e cancella i commenti che non ti servono.
## Cos'è
[Una frase: cosa fa questo progetto e per chi.]
## Come ti parlo
- Rispondimi in italiano, in modo semplice.
- Prima di scrivere codice, spiegami a parole cosa hai capito.
- Se una cosa non è chiara, fammi una domanda invece di tirare a indovinare.
- Una modifica alla volta: niente riscritture grosse senza chiedermelo.
## Cosa puoi fare senza chiedere
- Leggere i file del progetto per capirci qualcosa.
- Proporre modifiche e spiegarmele prima di applicarle.
## Cosa NON fare mai senza il mio ok
- Cancellare file o cartelle.
- Cambiare cose che già funzionano "per migliorarle" (rifai qualcosa solo se te lo chiedo).
- Aggiungere strumenti o librerie nuove: prima dimmelo.
- Salvare o pubblicare le modifiche in modo definitivo (un "commit"): solo quando te lo chiedo.
## Regole di base
- Commenti nel codice in italiano; i nomi nel codice in inglese (è lo standard).
- Se qualcosa va storto, dimmelo chiaro e con il contesto — niente errori nascosti sotto il tappeto.
- Se ti blocchi, dimmelo invece di insistere all'infinito.
- Se sbagli e te lo correggo, ricordatelo per le volte dopo.
## Quando chiudiamo
- Scrivi due righe su cosa abbiamo fatto e cosa resta da fare,
così la prossima volta ripartiamo senza rileggere tutto.
## Dove sono le cose
[Esempio: il sito è nella cartella `web/`, gli appunti in `note/`.]
[Lascia vuoto se è ancora presto per saperlo.]SPEC.md — dice cosa stai costruendo
# SPEC.md — [nome del progetto]
# Questo file dice COSA stai costruendo.
# Serve a te per avere le idee chiare e a Claude per non inventarsi nulla.
# Scrivilo prima di iniziare. Bastano poche righe per sezione.
## Obiettivo
[Cosa deve fare, in una o due frasi. Il problema che risolve.]
[Per chi è: tu, un amico, dei clienti.]
## Stack
[Con cosa è fatto. Se non lo sai, scrivi "da decidere con Claude".]
[Esempio: un sito statico, oppure uno script in Python.]
## MVP — la prima versione che basta
[Le poche cose che DEVONO funzionare perché valga la pena.]
- [Cosa numero 1]
- [Cosa numero 2]
- [Cosa numero 3]
## Edge case — cosa può andare storto
[Le situazioni strane a cui pensare prima, non dopo.]
- [Esempio: l'utente non scrive niente nel campo.]
- [Esempio: internet va via a metà.]
## Successo — come capisco che è fatto
[Come fai a dire "ok, funziona" senza dubbi.]
- [Esempio: riesco a fare X dall'inizio alla fine senza errori.]Copia i due testi qui sopra, crea nella cartella del tuo progetto due file chiamati esattamente CLAUDE.md e SPEC.md, e incollaci dentro il contenuto. Riempi le parti tra parentesi quadre con le tue informazioni e cancella i commenti che non ti servono. Da quel momento, ogni volta che apri il progetto con Claude Code, lui legge questi due file prima di toccare qualsiasi cosa: sa già come comportarsi e cosa state costruendo, senza che tu glielo ripeta ogni volta.