Da qualche settimana lavoro dentro una cartella. Non è una battuta: si chiama ClaudeHome, ed è il tentativo di risolvere un problema che probabilmente conoscete anche voi se usate un assistente AI su più fronti di lavoro contemporaneamente — quello di dover rispiegare chi siete, cosa state facendo e con quali convenzioni, ogni singola volta che aprite una nuova sessione.
Nel mio caso i fronti sono parecchi: consulenza di sicurezza, un paio di progetti SaaS, un ruolo in una nuova azienda, un blog. Ognuno con il proprio gergo, i propri output attesi, i propri “non fare mai questo”. Tenerli tutti nella stessa conversazione con un assistente generico era diventato ingestibile: o il contesto si mischiava, o dovevo ricostruirlo da capo a ogni sessione. Così ho deciso di dargli una posizione reale sul disco, con una struttura pensata apposta per essere letta — non solo da me, ma anche dall’assistente stesso.
L’idea di base
La struttura è semplice sulla carta:
ClaudeHome/
├── about-me/
│ └── chi-sono.md
├── general-context/
│ └── stack-ricorrente.md
├── INDEX.md
├── CLAUDE.md
└── workspace/
├── INDEX.md
├── CLAUDE.md
├── Progetto1/
├── Progetto2/
└── Blog/
Due tipi di file ricorrono in ogni cartella, e hanno scopi diversi che vale la pena tenere separati:
- INDEX.md — una mappa, non un archivio. Titolo, una riga di scopo, un elenco puntato di cosa c’è dentro. Va aggiornato mano a mano, non riempito di prosa.
- CLAUDE.md — le convenzioni operative di quella cartella: scopo, naming, dove salvare i deliverable, cosa non fare mai, riferimenti ad altre cartelle correlate.
La regola che mi sono dato per non finire a scrivere CLAUDE.md ovunque per pigrizia: se ne aggiungo uno a un livello, deve essere perché le convenzioni di quel livello divergono davvero dal genitore. Altrimenti è solo contesto che l’assistente rilegge a ogni task senza guadagnarci nulla — e in un flusso agentico il contesto ha un costo, non è gratis.
Chi sono e cosa uso sempre — separati dal resto
Due cartelle alla radice fanno un lavoro diverso da tutte le altre: about-me/ e general-context/. La prima contiene chi sono, il tono che preferisco negli output, cosa evitare sempre — roba che non cambia da un progetto all’altro. La seconda contiene lo stack tecnico ricorrente, gli standard di riferimento che uso spesso (penso a NIST CSF, CIS), la terminologia che do per scontata. Sono i due file che voglio letti *prima* di qualunque altra cosa, indipendentemente dal progetto su cui sto lavorando quel giorno.
Un dettaglio: CLI e Cowork non si comportano allo stesso modo
Qui è dove le cose si sono fatte interessanti. Avevo dato per scontato che una struttura di file letta automaticamente dalla riga di comando si comportasse allo stesso modo anche nell’interfaccia desktop. Nope.
Claude Code (la CLI) risale da solo la gerarchia dei CLAUDE.md, partendo dalla cartella corrente fino alla radice di ClaudeHome/. Nessun setup aggiuntivo: se il file c’è, lo legge, punto.
Cowork (l’app desktop) non fa lo stesso auto-discovery. Serve dirglielo esplicitamente, nelle Global instructions — un campo diverso dal prompt di sessione, che resta attivo su ogni conversazione futura. Qualcosa del tipo: leggi about-me/ e general-context/ prima di tutto, poi — se sto lavorando dentro una sottocartella di workspace/ — risali la gerarchia di INDEX.md e CLAUDE.md dal generale allo specifico, e se un livello non ha il suo CLAUDE.md salta e continua senza fermarti.
Stessa cartella, riutilizzabile da entrambi gli strumenti — ma è un “adapter” diverso per ciascuno. Per la CLI basta il CLAUDE.md alla radice con gli import; per Cowork serve la riga esplicita nelle Global instructions.
Il passaggio manuale che nessun prompt può fare al posto vostro
C’è un ultimo pezzo che la struttura da sola non garantisce: la memoria isolata per singolo workstream. Avere le cartelle a posto non basta — bisogna promuovere ogni area di lavoro a Cowork Project, uno per uno, tramite “Nuovo Project → Usa cartella esistente” puntando direttamente a workspace/<nome>. È l’unico modo per evitare che il contesto di un progetto contamini quello di un altro. Nessun prompt di setup automatico può farlo al posto vostro, è un click manuale.
Il prompt
# Prompt di startup — creazione struttura ClaudeHome
Crea la seguente struttura di cartelle e file in [INSERISCI PERCORSO, es. ~/ClaudeHome]:
```
ClaudeHome/
├── about-me/
├── general-context/
├── INDEX.md
├── CLAUDE.md
└── workspace/
├── INDEX.md
├── CLAUDE.md
├── Progetto1/
│ ├── INDEX.md
│ └── CLAUDE.md
├── Progetto2/
│ ├── INDEX.md
│ └── CLAUDE.md
├── Progetto3/
│ ├── INDEX.md
│ └── CLAUDE.md
├── Consulenza/
│ ├── INDEX.md
│ └── CLAUDE.md
└── Blog/
├── INDEX.md
└── CLAUDE.md
```
Per ogni file INDEX.md: crea uno scheletro breve con un titolo, una riga che descrive
lo scopo della cartella, e un elenco puntato (vuoto) dei contenuti/sottocartelle
principali da aggiornare mano a mano. Tienilo minimale: è una mappa, non un archivio.
Per ogni file CLAUDE.md: crea uno scheletro con queste sezioni:
## Scopo di questa cartella
## Convenzioni (naming, formati output, dove salvare i deliverable)
## Cosa NON fare
## Riferimenti (link a INDEX.md e a cartelle correlate)
Nel CLAUDE.md alla radice (ClaudeHome/CLAUDE.md), aggiungi anche queste due righe
in cima, prima delle altre sezioni:
@about-me/chi-sono.md
@general-context/stack-ricorrente.md
Nella cartella about-me/, crea un file chi-sono.md con questo template di sezioni:
## Chi sono
## Ruolo attuale
## Tono e stile preferito negli output
## Cosa evitare sempre
Nella cartella general-context/, crea un file stack-ricorrente.md con questo template:
## Strumenti e tecnologie ricorrenti
## Standard di riferimento (es. NIST CSF, CIS)
## Terminologia e acronimi ricorrenti
Non riempire questi due file con contenuti inventati: lasciali come scheletro.
Se preferisco, puoi intervistarmi con poche domande mirate per completarli subito
invece di lasciarli vuoti — chiedimelo prima di procedere.
Ricorda: se un livello di workspace/ non ha convenzioni realmente diverse dal
genitore, non serve un suo CLAUDE.md dedicato — è solo contesto riletto a ogni
task senza guadagno.
Cosa mi porto a casa
Non è una struttura complicata, ma il valore non sta nella complessità — sta nell’aver separato in modo esplicito “chi sono” (stabile), “cosa uso sempre” (stabile), e “cosa sto facendo ora” (specifico del progetto, isolato dagli altri). Se lavorate su più fronti con un assistente AI e vi ritrovate a reincollare lo stesso contesto ogni mattina, vale la pena investire un pomeriggio a costruirvi qualcosa di simile. Il ritorno si vede dopo una settimana, non dopo un anno.
Stay safe!