cyber-tesi/CLAUDE.md

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: …").