La Guida alla Company Brain

Costruire il "secondo cervello" aziendale con Claude + Obsidian — guida pratica dal corso di Giovanni Beggiato ("Joe", Gentes AI), 2h18m.
Spiegata da zero11 cartelleNote atomicheFront matterRAG & memoria vivaCon prompt pronti
↩ Torna all'indice dei riassunti
Una Company Brain è un archivio di conoscenza aziendale strutturato perché un'AI lo possa leggere e navigare: non PDF dispersi, ma una rete di piccole note collegate. Questa guida spiega cos'è, perché conviene ora e come costruirne una da zero — con i prompt e gli esempi del corso. I termini tecnici sono spiegati alla prima occorrenza.

1.Cos'è una Company Brain (e cosa NON è)

Una Company Brain (o second brain aziendale) è un archivio di conoscenza strutturato apposta perché un'AI lo legga e lo navighi: una rete di piccole note collegate che l'AI percorre come una mappa, per rispondere con il tuo contesto. Risolve il fatto che la conoscenza è sparsa in tre posti:

Statistiche: 19% della settimana a cercare info, 8-12 mesi per un nuovo assunto
t≈10:25 — i dati che giustificano l'investimento (fonti McKinsey e HBR).
Cosa NON è: non è ChatGPT/Claude "nudo". Se tu e il concorrente usate la stessa AI senza un contesto vostro, ottenete le stesse risposte: zero vantaggio. La Brain dà all'AI ciò che solo tu hai — i tuoi dati.

2.Perché farla ora: i numeri e il vantaggio competitivo

Una Brain che migliora ogni giorno crea un vantaggio cumulativo: l'AI ti conosce sempre meglio e il distacco dai concorrenti cresce.

Finestra aperta: oggi vantaggio raro, domani normalità, come il sito web nel 1999
t≈22:34 — l'"arbitraggio" come vantaggio temporale di chi arriva prima. (Senso diverso dall'arbitraggio finanziario.)
La company brain a sfera: 22.500 note interconnesse
t≈24:18 — la Brain di riferimento: ~22.500 note. Ogni puntino è una nota, ogni linea un collegamento: è così che l'AI "vede" l'azienda.

3.Dizionario minimo

Obsidian
App gratuita che mostra una cartella di file di testo (Markdown) come una rete di note collegate. È un layer sopra la cartella: i dati restano file sul tuo computer.
Markdown (.md)
Formato di testo semplice, lo standard che le AI digeriscono meglio.
Wikilink [[Nota]]
Collegamento da una nota a un'altra: il "filo" che l'AI percorre.
Backlink
Il collegamento al contrario: se A punta a B, B "sa" di essere citata da A.
Front matter (YAML)
Blocchetto in cima alla nota (tra ---) con titolo, riassunto, tag, link. L'AI lo legge per primo per decidere se la nota serve.
Graph view
La vista "a palla" con tutte le note e i collegamenti.
Claude Code / Cowork
L'AI che apre la cartella, legge e naviga i file: il "motore" della Brain.
Canon
La "bibbia" aziendale: un unico documento con tutti e soli i fatti veri (anti-allucinazione).
Nota atomica
Una nota = una sola idea, autonoma (concetto dello Zettelkasten).
Hub (Map of Content)
Nota-indice che collega tante note di un'area.
RAG
Retrieval-Augmented Generation: ricerca per somiglianza di significato (vettori), utile con migliaia di note.
Version control
Storico delle versioni (GitHub/Google Drive): si torna indietro e si condivide un'unica copia.

4.L'architettura a strati (la mappa del sistema)

StratoStrumentoA cosa serve
Layer AIObsidian (note .md)Il cervello: note + collegamenti che l'AI naviga
MotoreClaude Code / CoworkLegge, scrive e naviga le note
QualitàScript Python + _index + llms.txtBrain pulita, senza orfani, efficiente in token
Version controlGitHub / Google DriveStorico, backup, unica fonte di verità
Layer visivoNotion / HTMLCruscotto per le persone (team o cliente)
ScalaRAG (Qdrant/Supabase/Pinecone)Ricerca semantica con migliaia di note
Memoria vivaskill journalRegistra sessioni e giornate: l'AI "ricorda"

5.Obsidian: note, wikilink e front matter

Installazione. Scarica Obsidian, crea una cartella (es. Aurora Cervello), poi Open folder as vault. Ogni nota è un file .md.

Collegare due note. Scriverle separate le lascia scollegate. Per collegarle si usano le parentesi quadre:

Il commerciale di riferimento è [[persona-elena-ferraro]].

Si crea un wikilink (A→B) e un backlink (B sa di essere citata). Ora l'AI può "diramarsi" verso la persona e prenderne tutto il contesto.

Front matter. L'AI legge prima questo blocco e prosegue solo se è rilevante (meno token, meno allucinazioni):

---
title: Identità di Aurora Sistemi
summary: Hub centrale; SaaS gestione patrimonio immobiliare, Milano 2018.
tags: [self, identita, hub]
type: identita
status: active
related: ["[[persona-elena-ferraro]]", "[[area-finance-operations]]"]
---
Esempio di front matter: title, summary, tags, type, status, related
t≈1:18:06 — la nota self-identita-aurora con front matter e collegamenti related.

Regole d'oro: summary chiaro (è ciò che l'AI legge per prima); primo tag = la cartella; almeno 3 wikilink in related su una sola riga; se il front matter è rosso è "rotto" → chiedi a Claude di sistemarlo.

6.Tassonomia vs Ontologia: le 11 cartelle

Tassonomia = come archivi (le cartelle). Ontologia = come colleghi (i wikilink). La logica di archiviazione scelta è l'azionabilità. La struttura è agnostica (funziona per ogni business):

Le 11 cartelle della Company Brain
t≈48:36 — "Una sola decisione: quanto è azionabile?". Le 11 cartelle.
#CartellaCosa contiene
1selfChi siamo: identità, missione, visione, offerte, obiettivi.
2areasResponsabilità continue (reparti): sales, marketing… (freelancer: i canali).
3projectsLavori con inizio e fine (one-off).
4sourcesL'inbox grezza: appunti, articoli.
5conceptsDefinizioni per l'AI: cos'è "ARR", cos'è "churn".
6docsLe SOP (procedure interne).
7entitiesNomi propri: persone, prodotti, fornitori, tool.
8dataI numeri in tabella: KPI, report, valori.
9codeScript e automazioni ricorrenti.
10outputsDeliverable finiti: proposte, case study, contratti.
11workspaceLa memoria viva: diario di sessioni e giorni.
La struttura a cartelle dentro l'IDE, con workspace, journal, daily, sessions
t≈57:16 — le cartelle reali nell'editor; in workspace vivono daily e sessions.

7.Note atomiche, Canon e Hub

Note atomiche (Zettelkasten). Dal sociologo Niklas Luhmann, che scrisse decine di libri grazie a ~90.000 schede, ognuna con una sola idea collegata alle altre. Per un'azienda: non PDF da 40 pagine, ma note brevi e riutilizzabili → l'AI ha sempre il contesto giusto.

Zettelkasten: 90.000 note atomiche collegate contro i mappazzoni PDF
t≈1:11:09 — note atomiche collegate; a destra il "NO" ai PDF monolitici.

Canon = la bibbia aziendale. Prima di spezzare i dati in note, si crea un Canon con tutti e solo i fatti veri (anti-allucinazione). Metafora: una grande bacinella (il Canon) divisa in 11 bacinelle (le cartelle); la somma deve restare identica.

Hub (Map of Content). Note-indice ben formattate che fanno da centro per ogni area. Senza hub, l'AI crea note che restano orfane. L'hub centrale è self, a cui si agganciano i reparti, e ai reparti il dettaglio.

8.La costruzione passo-passo (con i prompt)

Passo 1 — Crea lo scheletro (11 cartelle vuote).

Creami nel vault, alla radice, queste 11 cartelle vuote — una per ciascun lavoro del
cervello: self, areas, projects, sources, concepts, docs, entities, data, code, outputs,
workspace. Non crearne altre, non metterci file dentro: solo le cartelle.

Passo 2 — Estrai il Canon (prima un piano!).

Sei l'architetto del cervello aziendale di [Azienda]. Leggi tutto il materiale grezzo
nella cartella sources. Estrai i fatti duri e scrivili in un unico Canon coerente che copra:
identità, prodotti, reparti, persone e ruoli, clienti, KPI. Regole: nessun fatto inventato;
se non è in sources non scriverlo; i numeri devono quadrare. Scrivi il Canon in un solo file
di lavoro. Prima di scrivere, dammi in 5 righe cosa hai trovato e come pensi di strutturarlo,
poi aspetta il mio ok.
Usa la plan mode invece di "bypass permission": controlli il piano prima dell'esecuzione.

Passo 3 — Trasforma il Canon in note atomiche (prima gli hub).

Ok il Canon va bene. Trasformalo in note atomiche dentro le 11 cartelle. Regole: una nota =
un concetto, max 300 righe, front matter in cima (title, summary, tags…), "related" su una
sola riga con almeno 3 wikilink, nome unico. Ordine: PRIMA gli hub (self e i reparti in
areas), POI le note di dettaglio (prodotti, clienti, KPI). Mostrami "self-identita" prima
di proseguire.

Passo 4 — Completa il cervello.

Perfetto, ora completa il cervello. (I canali commerciali — LinkedIn, eventi, partner —
creali come TAG, perché un'attività può appartenere a più canali.)

9.Qualità: index, gate, llms.txt, showcase

a) _index per non avere note orfane. Una nota senza collegamenti non viene letta dall'AI (che viaggia solo sui link). Metti un _index in ogni cartella, collegato a tutte le note di quella cartella.

b) Quality gate (script Python) che controlla 6 regole e produce un referto:

Crea uno script Python che faccia da gate di qualità sul cervello. Controlla ogni nota
(salta sources/workspace/scratch): 1) front matter completo; 2) max 300 righe; 3) almeno
3 wikilink; 4) zero link rotti; 5) zero orfani; 6) una sola componente connessa. Elenca gli
errori per regola. Se è tutto ok rispondi "OK, 0 errori". Per ora non correggere: solo referto.
Principio di Joe: con l'AI puoi fare outsourcing di competenza e di pensiero, ma non della comprensione.

c) llms.txt — un indice testuale che riassume cosa contiene la Brain (Claude non deve riesplorarla ogni volta → risparmio token). (Raccomandazione pratica, non standard ufficiale.)

d) showcase.md — riassunto delle metriche (note, hub, wikilink): a colpo d'occhio e utile in vendita.

showcase.md con metriche: note totali, hub, wikilink, componenti connesse
t≈1:38:55showcase.md: note totali, di contenuto, hub, wikilink, "componente connessa = 1".

10.Version control: GitHub / Google Drive

Obsidian è local-first: i dati stanno sul tuo computer (privacy), ma se si rompe perdi tutto. Serve uno storico condiviso: GitHub (tecnico, scala meglio) o Google Drive (semplice).

Linea del tempo Git: commit e branch
t≈1:45:52 — un commit è una foto sulla linea del tempo; un branch è un ramo separato.
GDPR: con i servizi cloud (Notion, database RAG) firma i DPA per gestire i dati a norma.

11.Layer visivo: Notion e HTML

La Brain è usata soprattutto dall'AI; alle persone serve un'interfaccia.

HTML — cruscotto statico, doppio clic, senza account:

Genera un cruscotto HTML statico dai dati del Canon: indicatori dell'ultimo mese, grafici,
andamento, classifica. Tutto in un solo file HTML, offline e senza account.

Notion — per i team; si collega via MCP (un connettore che dà a Claude accesso a Notion):

/mcp  → aggiungi il server Notion → autentica → riavvia il workspace
Poi: "Costruiscimi su Notion un cruscotto KPI per Aurora (clienti, revenue…). Chiamalo 'Cervello Pino'."
Cruscotto KPI su Notion generato da Claude
t≈2:08:26 — dashboard Notion (ARR, NRR, edifici gestiti…) generata dalla Brain.

Si può chiedere all'AI di sincronizzare Notion ↔ Obsidian (il "brain sync"). Esempio di verifica:

Rispondi usando SOLO le note del cervello; cita il file; se non c'è, scrivi "non presente
nel cervello". Domanda: quali clienti hanno attivato sia Aurora Cloud, e chi li segue nel
Customer Success?

La Brain cita i file, dice cosa non sa, e incrociando entità/prodotti/KPI risponde anche a "quale impiegato porta più ARR?" o "quali dati mancano per un'analisi completa?".

12.Memoria viva: la skill "journal"

Finora la memoria è statica. Per chiedere "a marzo cosa avevamo deciso col cliente X?" serve una memoria dinamica: una skill journal con tre comandi, nella cartella workspace:

La skill journal in azione: briefing del mattino e sessioni
t≈2:15:22 — "Buongiorno Claude": la skill legge l'indice, trova l'ultima sessione e dà il briefing.

Perché due livelli? Le sessioni sono granulari (ottime per il RAG); i daily sono riassunti. L'AI trova in fretta "la giornata giusta" e poi scende nel dettaglio.

13.Scalare: quando serve il RAG

Con poche note Claude naviga benissimo sui wikilink. Oltre una soglia conviene il RAG: le parole diventano vettori e si cercano quelli "vicini" alla domanda (meno token).

Tabella 80/20: architettura in base al numero di note
t≈1:59:45 — la regola pratica per scegliere l'architettura.
N. noteArchitettura consigliata
< 500Mappe di contenuto (hub) + llms.txt. Basta Obsidian + Claude.
500 – 2.500Come sopra; inizi a valutare gli embeddings.
2.500 – 20.000Embeddings + RAG.
20.000+Pipeline RAG completa.

Database RAG: Qdrant (specializzato), Supabase (anche version control dei dati), Pinecone, Weaviate. È un mondo a sé (embedding, chunking, ricerca vettoriale).

14.Checklist finale + errori da evitare

Checklist di costruzione

  1. Installa Obsidian → crea il vault.
  2. Crea le 11 cartelle (Passo 1).
  3. Estrai il Canon con piano e regole anti-allucinazione (Passo 2).
  4. Crea hub e note atomiche con front matter corretto (Passo 3–4).
  5. Aggiungi _index in ogni cartella.
  6. Lancia il quality gate finché → "OK, 0 errori".
  7. Aggiungi llms.txt e showcase.md.
  8. Collega GitHub/Google Drive.
  9. Aggiungi il layer visivo (Notion via MCP e/o HTML).
  10. Costruisci la skill journal (memoria viva).
  11. Quando cresci → introduci il RAG.

Errori da evitare