diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..92508ba
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,28 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Cos'è questo repository
+
+Non c'è codice: pipeline documentale **PDF/DOCX grezzi → Markdown (MinerU) → LLM-wiki / vault Obsidian**, a partire da una tesi di laurea magistrale (Chimica Industriale, "Sintesi e caratterizzazione di copolimeri bottle brush foto-elettro attivi", in italiano). La tesi è stata elaborata con **MinerU** (PDF → Markdown) e poi rifinita. Non ci sono build, lint o test; MinerU non è installato in locale (i JSON intermedi sono stati rimossi dalla storia).
+
+## Contenuto
+
+- `tesi.md` — **sorgente canonico**: fusione di `tesi.docx` (struttura, tabelle, indice) e dell'output MinerU di `tesi.pdf` (figure, formule), con figure e LaTeX corretti a mano. Lavorare qui.
+- `tesi.docx`, `tesi.pdf` — **grezzo di partenza** (la tesi originale), mai da modificare né da usare come fonte di lavoro; servono solo per verificare dubbi di estrazione.
+- `immagini/` — ~100 figure referenziate da `tesi.md` come `![](immagini/<sha256>.jpg)`. I nomi sono hash SHA-256 (dedup tra docx e pdf): **non rinominare** e non rompere i riferimenti. `<hash>_senza_label.jpg` è la stessa figura senza etichette (usata una volta).
+
+## Struttura di tesi.md
+
+Front matter con tabelle HTML (`<table>`) → Riassunto / Abstract / Sommario (indice con ancore `#_TocNNN` di Word, non più valide come link utili) → capitoli `# 1 Introduzione`, `2 Scopo`, `3 Procedure sperimentali`, `4 Discussione dei risultati`, `5 Conclusioni`. Intestazioni e numerazione sono scritte a mano (`## 1.1 **Titolo**`, grassetto incluso). Didascalie in HTML: `<em><strong>Figura N</strong></em> <em>- testo</em>`, sotto l'immagine. Formule display in `$$ ... $$` (~26 blocchi), tabelle residue in HTML.
+
+## Convenzioni per la trasformazione in wiki Obsidian
+
+- Non modificare `tesi.md` in modo distruttivo: generare le note in una cartella separata (es. `wiki/`), una per sezione/concetto, con wikilink `[[...]]`, frontmatter YAML e embed `![[immagine]]`; usare le skill `obsidian:obsidian-markdown` e `obsidian:obsidian-bases`.
+- Il testo è scientifico: mantenere invariati formule LaTeX, formule chimiche, nomi di composti, unità, valori numerici e sigle (DPP, 3HT, ROP, PCL, ACQ, CV…). Non tradurre né riassumere dati sperimentali.
+- Se una formula/tabella/valore sembra un errore di OCR, confrontarlo con `tesi.pdf`/`tesi.docx` prima di correggere; segnalare, non indovinare.
+- Ogni affermazione di una nota deve essere riconducibile a una sezione di `tesi.md` (citare numero di capitolo/figura).
+
+## Git
+
+Cronologia: tesi grezza MinerU → fusione docx+pdf → rinomina immagini in hash → pulizia intermedi. Commit in italiano, descrittivi, al passato/presente breve (es. "Rifinisce tesi.md: …").