Skill di consultazione: protocollo di retrieval, mappa, ricette e checklist; regole su lingua, completezza, figure e tabelle

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Risposte senza riferimenti wiki; regole di coerenza e posizione delle immagini
2026-10-20 15:53:24 +02:00 · 2026-10-20 15:00:23 +02:00 · 2026-10-20 14:43:40 +02:00
12 changed files with 322 additions and 73 deletions
@@ -1,17 +1,27 @@
 ---
 name: tesi-dati
-description: Recupera valori sperimentali esatti della tesi (rese, Mn/Mw/PDI, % DPP, lunghezze d'onda, potenziali, band gap, condizioni di reazione, quantità) dalle tabelle e dal testo, con localizzatore e avvertenze sui difetti noti. Usala per domande numeriche, confronti tra campioni (3a, 3b, 3c, bottle brush) o richieste di una tabella/procedura.
+description: Recupera valori sperimentali esatti della tesi (rese, Mn/Mw/PDI, % DPP, lunghezze d'onda, potenziali, band gap, tempi di vita, condizioni di reazione, quantità) dalle tabelle e dal testo, con unità, condizioni, confronti omogenei e avvertenze sui difetti noti. Usala per domande numeriche, confronti tra campioni (3a, 3b, 3c, bottle brush), richieste di una tabella o di una procedura.
 ---
-# tesi-dati — valori e tabelle esatti
+# tesi-dati — valori e tabelle esatti, con contesto
-Sola lettura. Italiano.
+Sola lettura. Italiano. Protocollo generale e ricette: `../tesi-query/references/` (`protocollo-retrieval.md`, `ricette-ricerca.md`).
-1. Localizza la grandezza: `wiki/dati.md` (grandezza → pagina con intervalli), `wiki/tabelle-indice.md` (15 tabelle e 12 equazioni), `wiki/campioni.md` (campione × tecnica).
+## 1. Localizza
-2. Apri la pagina indicata (una tabella sta in **una sola** pagina; le altre rimandano) e poi `raw/tesi.md` alle righe di `tesi_loc` per il valore esatto.
+1. Identifica **grandezza**, **campioni** (attenzione: `1`, `2` e `3a-3c`, `3.1b-3.3c` del cap. 3-4 non sono i composti 1-48 del cap. 1), **tecnica** e **condizioni** richieste.
-3. **Copia alla lettera** valori, unità, condizioni (T, P, solvente, tempo, carico, resa/conversione), formule LaTeX, nomi e sigle. Decimali come in tesi (virgola; punto in dati NMR, concentrazioni, condizioni CV). Nessuna conversione o arrotondamento.
+2. Cerca in `wiki/dati.md` (grandezza → pagina con intervalli), `wiki/tabelle-indice.md` (15 tabelle e 12 equazioni), `wiki/campioni.md` (campione × tecnica). Se la grandezza non compare, grep in `wiki/` e in `raw/tesi.md` con sinonimi (es. Mn / peso molecolare medio numerale; λmax / massimo di assorbimento; Eg / bandgap / band gap).
-4. Cita sempre tabella/sezione/riga: `(Tab. 9, §4.2, r.812)`.
+3. Una tabella sta in **una sola** pagina (le altre rimandano): apri quella e poi `raw/tesi.md` alle righe di `tesi_loc` (ricetta `sed -n`) per il valore esatto.
-5. Confronta valori solo se ottenuti nelle stesse condizioni (solvente, tecnica, concentrazione, campione); altrimenti dichiara la differenza.
+
-6. **Difetti noti** (`wiki/analyses/difetti-noti.md`, `difetti-dati.md`): PDI di 3b (Tab. 9) incoerente con Mw/Mn; % DPP di 3c (35 vs 36); bandgap delle Conclusioni (3,42-4,30 eV) incoerente con Tab. 14; correlazione «lineare» (r.1228) vs «non lineare con plateau». Se il dato richiesto ne ha uno, segnalalo e **non correggerlo**.
+## 2. Verifica
-7. Procedure del cap. 3: riporta quantità e condizioni utili con rimando a paragrafo e righe, non riscrivere l'intera procedura.
+- Leggi il valore **in `raw/tesi.md`** (non solo nella wiki), con riga d'intestazione, unità e note della tabella.
-8. Interpretazioni (trend, confronti) sono _(inferenza)_; spiegazioni da conoscenza generale sono _(conoscenza generale)_ e restano nel perimetro della tesi. Se il dato non c'è, dillo.
+- Raccogli le **condizioni**: solvente, tecnica, concentrazione, temperatura, scan rate, elettrodo di riferimento, stato (soluzione/film), campione. Una stessa grandezza può comparire in più tabelle con condizioni diverse (es. soluzione vs film, CV vs ottico): riportale separate.
 - Cerca nel testo la **discussione** del dato (cosa significa, trend, confronto con P3HT o riferimenti) e nel riassunto (`raw/riassunto_tesi.md`) per eventuali differenze.
 - Controlla i **difetti noti** (`wiki/analyses/difetti-dati.md`, `difetti-noti.md`): PDI di 3b (Tab. 9) incoerente con Mw/Mn; % DPP di 3c (35 vs 36); bandgap delle Conclusioni (3,42-4,30 eV) incoerente con Tab. 14; correlazione «lineare» (r.1228) vs «non lineare con plateau» (Conclusioni, §4.4.3). Se il dato richiesto ne ha uno, segnalalo e **non correggerlo**.
 ## 3. Riporta
 - **Copia alla lettera** valori, unità, condizioni (T, P, solvente, tempo, carico, resa/conversione), formule LaTeX, nomi e sigle. Decimali come in tesi (virgola; punto in dati NMR, concentrazioni e condizioni CV). Nessuna conversione, nessun arrotondamento.
 - **Ogni tabella citata o utile va riprodotta** nella risposta in Markdown, con intestazioni, valori, unità e note alla lettera (tutte le righe e colonne rilevanti, dichiarando cosa ometti). Indica tabella e sezione, es. `(Tab. 9, §4.2)`; i numeri di riga e i nomi delle pagine wiki non vanno stampati.
 - **Confronti:** costruisci una tabella con i campioni sulle righe e le grandezze sulle colonne; confronta solo valori ottenuti nelle stesse condizioni, altrimenti dichiara la differenza; se un campione non ha il dato, scrivilo.
 - **Interpretazione:** dopo i numeri, spiega cosa dicono (trend con la composizione, effetto del PCL, confronto con P3HT): ciò che dice la tesi, poi la spiegazione dalla conoscenza generale _(conoscenza generale)_ dentro il perimetro, le tue deduzioni _(inferenza)_. Collega alla research question quando pertinente.
 - **Procedure del cap. 3:** riporta quantità, condizioni e tempi utili alla domanda, con rimando al paragrafo; non riscrivere l'intera procedura salvo richiesta.
 - Se il dato non c'è, dillo dopo aver cercato con più formulazioni.
@@ -1,27 +1,42 @@
 ---
 name: tesi-figure
-description: Trova, apre e spiega le figure della tesi (80 della tesi e 11 del riassunto: strutture, schemi di sintesi, meccanismi, spettri UV-Vis/fluorescenza/NMR/FT-IR, GPC, DSC, voltammogrammi) per illustrare una risposta. Usala quando la domanda riguarda una figura, uno schema o un grafico, o quando un'immagine chiarirebbe la spiegazione.
+description: Trova, valuta, apre e spiega le figure della tesi (80 della tesi e 11 del riassunto: strutture, schemi di sintesi, meccanismi, spettri UV-Vis/fluorescenza/NMR/FT-IR, GPC, DSC, voltammogrammi, foto) scegliendo quella più coerente con la risposta e inserendola nel punto giusto con la descrizione. Usala quando la domanda riguarda una struttura, uno schema, un meccanismo o un grafico, o quando un'immagine chiarirebbe la spiegazione.
 ---
-# tesi-figure — retrieval e spiegazione delle immagini
+# tesi-figure — retrieval, scelta e spiegazione delle immagini
-Sola lettura. Italiano.
+Sola lettura. Italiano. Ricette di ricerca: `../tesi-query/references/ricette-ricerca.md`.
-## Trovare le figure
+## 1. Trova i candidati (più strade, poi unisci)
-1. Per numero: `wiki/figures/fig-NNN.md` (es. Fig. 27 → `fig-027`). Figure del riassunto: `ris-fig-NN`; schemi senza numero: `fig-x-<hash>`.
+1. **Dalle pagine lette:** campo `figures:` del frontmatter e link `[[fig-NNN]]` nelle pagine wiki dell'argomento.
-2. Per argomento: `wiki/figure-indice.md` (figure per sezione) oppure grep in `wiki/figures/` su composto, concetto o parola chiave; i campi `composti`, `concetti`, `keywords` del frontmatter aiutano. Le pagine wiki che trattano l'argomento riportano `figures:` e link `[[fig-NNN]]`.
+2. **Per sezione:** `wiki/figure-indice.md` (figure raggruppate per sezione della tesi, con tipo e avvisi).
-3. Catalogo completo (pannelli, testo visibile): `raw/immagini.json`.
+3. **Per entità:** grep in `wiki/figures/` su composto (`composti:`), concetto (`concetti:`), parole chiave e testo visibile; prova sinonimi IT/EN e le sigle.
 4. **Per numero** (se la domanda lo cita): `wiki/figures/fig-NNN.md` (es. 27 → `fig-027`). Figure del riassunto: `ris-fig-NN`; schemi senza numero stampato: `fig-x-<hash>`.
 5. **Dal testo:** le righe «Citata in tesi.md alle righe» e il «Contesto nel testo» della scheda dicono per quale affermazione la tesi usa la figura.
 6. Catalogo completo (pannelli, testo visibile): `raw/immagini.json`.
-## Guardare l'immagine
+## 2. Valuta e scegli
-1. Leggi la nota `wiki/figures/fig-NNN.md`: didascalia stampata, descrizione, testo visibile, contesto, righe di citazione, avvisi, «Pagine che la usano».
+Per ogni candidata leggi la scheda `wiki/figures/fig-NNN.md` (didascalia stampata, descrizione, testo visibile, tipo, contesto, righe di citazione, avvisi). Scegli in base a:
-2. **Apri il file immagine**: il nome è nell'embed `![[immagini/<hash>.<ext>]]` della nota, il percorso reale è `raw/immagini/<hash>.<ext>`. Per figure a più pannelli apri tutti i pannelli rilevanti. Usa lo strumento di lettura immagini del tuo agente.
+- **specificità:** stesso composto, stessa tecnica, stesso campione della frase che stai scrivendo (meglio la figura esatta di una generica);
-3. Descrivi ciò che vedi (struttura, reagenti, frecce, picchi, curve, assi, legenda) e collegalo al ragionamento della risposta; indica *cosa guardare* e *perché*.
+- **corrispondenza col testo:** è la figura che la tesi usa per quel punto (`text_context`);
-4. Cita sempre il percorso `raw/immagini/<hash>.<ext>` e la nota `[[fig-NNN]]` perché l'utente possa aprirla.
+- **tipo adatto:** struttura per «com'è fatto», schema di reazione per «come si ottiene», meccanismo per «perché», spettro/curva per «cosa si misura», foto per l'aspetto macroscopico;
 - **affidabilità:** niente flag `caption_mismatch` se esiste un'alternativa equivalente;
 - **non duplicare** il contenuto già mostrato da un'altra figura o tabella.
 Per un argomento articolato scegli **una figura per sotto-argomento** (di norma 1-4; di più per un percorso completo come l'intera sintesi). Se nessuna è davvero coerente, non inserirne.
-## Attendibilità
+## 3. Guarda l'immagine (obbligatorio)
 1. **Apri il file:** il nome è nell'embed `![[immagini/<hash>.<ext>]]` della scheda; il percorso reale è `raw/immagini/<hash>.<ext>`. Per figure a più pannelli apri tutti i pannelli rilevanti. Usa lo strumento di lettura immagini del tuo agente.
 2. **Verifica la coerenza:** composti, reagenti, condizioni, assi, curve, campioni e valori nell'immagine corrispondono a ciò che affermi? Se descrizione e immagine non coincidono, fidati dell'immagine e dichiaralo.
 3. Individua **cosa guardare**: struttura, frecce di reazione, picchi, curve, assi, legenda.
 ## 4. Inserisci nella risposta
 - **Incorpora l'immagine** con `![descrizione breve](raw/immagini/<hash>.<ext>)` (percorso relativo alla radice del repo): le interfacce che mostrano le immagini locali la visualizzano, le altre mostrano il testo alternativo. **Subito sotto** scrivi la descrizione di ciò che mostra (cosa rappresenta, composti, condizioni, elementi chiave), dalla scheda e da ciò che vedi, in parole tue.
 - **Non scrivere mai «Fig. N»/«Figura N»** né il percorso o `[[fig-NNN]]` come testo: nel testo rimanda a parole («lo schema qui sotto»). Una figura descritta ma non incorporata è un errore: prima di inviare controlla che ogni figura di cui parli abbia il suo `![...](...)`.
 - **Posizione:** **subito dopo** il paragrafo che ne discute il contenuto, mai in fondo alla risposta né raggruppata lontano dal suo argomento; una per volta, ciascuna nella sezione del proprio argomento.
 - **Aggancio:** una frase prima dice cosa sta per essere mostrato («Lo schema di sintesi riportato qui sotto mostra…»); dopo l'immagine un commento sugli elementi da guardare, collegato al ragionamento.
 - Niente ripetizioni né figure decorative. Se la figura mostra più campioni o pannelli, incorpora il pannello pertinente e indica a parole quale guardare.
 ## 5. Attendibilità
 - Solo `caption_printed` è testo della tesi. Descrizioni, `visible_text` e didascalie generate derivano dall'immagine e non sono verificate.
- Valori letti da grafici o schemi (rese, picchi, potenziali) vanno confermati su tesi/tabelle, o presentati come «letti dalla figura».
+- Valori letti da grafici o schemi (rese, picchi, potenziali) vanno confermati su tesi e tabelle, o presentati come «letti dalla figura».
- Figure con `flags`/`review_notes` (26, 27, 29, 58, 66, 67, 69: discrepanze didascalia/testo; note anche su 52, 62, 76 e `fig-x-94f3f4`): citale **con l'avvertenza**. Dettagli in `wiki/analyses/difetti-figure.md`.
+- Figure con `flags`/`review_notes` (26, 27, 29, 58, 66, 67, 69: discrepanze didascalia/testo; note anche su 52, 62, 76 e `fig-x-94f3f4`): usale **con l'avvertenza a parole** (es. «la didascalia stampata non coincide con il contenuto»). Dettagli in `wiki/analyses/difetti-figure.md`.
 ## Scelta
 Usa le figure che chiariscono davvero (di norma 1-4; di più per un percorso completo come l'intera sintesi). Se nessuna è utile, non forzarla.
@@ -1,14 +1,22 @@
 ---
 name: tesi-fonti
-description: Risponde a domande sulla bibliografia della tesi e su chi sostiene cosa: identifica il riferimento citato (63 voci), mostra DOI, abstract e le frasi della tesi in cui è citato, segnala voci difettose. Usala per «chi ha proposto…», «da dove viene questo dato», «dove è citato il riferimento N».
+description: Risponde a domande sulla bibliografia della tesi e su chi sostiene cosa: identifica il riferimento citato (63 voci), cosa afferma, DOI, abstract e le frasi della tesi in cui è citato, verifica se la citazione regge, segnala voci difettose. Usala per «chi ha proposto…», «da dove viene questo dato», «dove è citato il riferimento N», «la fonte conferma quanto scritto?».
 ---
 # tesi-fonti — bibliografia e citazioni
-Sola lettura. Italiano.
+Sola lettura. Italiano. Protocollo e ricette: `../tesi-query/references/`.
-1. Elenco dei 63 riferimenti: `wiki/bibliografia.md` (link alle schede). Ogni scheda: `raw/fonti/NN-cognome-anno.md` (citazione verificata, DOI, abstract, frasi della tesi in cui è citato). Dati strutturati: `raw/bibliografia.json` (`text` è la fonte di verità, gli altri campi sono euristici).
+## Dove cercare
-2. Per «chi sostiene X»: trova nella wiki la pagina dell'argomento, leggi i `refs:` e le citazioni `[[NN-cognome-anno|N]]`, poi apri la scheda e `raw/tesi.md` alla riga di citazione.
+- Elenco dei 63 riferimenti: `wiki/bibliografia.md`; ogni scheda `raw/fonti/NN-cognome-anno.md` (citazione verificata, DOI, abstract, frasi della tesi in cui è citato). Dati strutturati: `raw/bibliografia.json` (campi `cited_in_md_lines`, `cited_in_sections`; `text` è la fonte di verità, gli altri campi sono euristici).
-3. Cita i riferimenti col numero della tesi, nella forma `[[01-bao-2020|1]]`, con la posizione `(§1.1.1, r.NNN)`.
+- Citazioni per sezione: ricetta in `ricette-ricerca.md` (Python su `cited_in_sections`).
-4. **Difetti noti** (`wiki/analyses/difetti-bibliografia.md`, `verifica-citazioni.md`): voce 44 duplicata della 1; voci 20, 22, 36, 54 incomplete o con testo spurio; voce 55 in formato RIS grezzo; DOI errati nelle voci 47, 48 (corretto 10.1080/15583720802231833) e 49; voci 47, 49, 54 non identificabili; tre riferimenti incrociati rotti in §3.3. Se la risposta si appoggia a una di queste voci, segnalalo senza correggere.
+- Analisi esistenti: `wiki/analyses/verifica-citazioni.md` (citazioni confrontate con le schede: deboli, coerenti, non verificabili) e `difetti-bibliografia.md`.
-5. Non inventare autori, anni, DOI o contenuti di articoli: se la scheda non lo riporta, dillo. Ciò che sai del lavoro citato per conoscenza generale va marcato _(conoscenza generale)_ e resta nel perimetro della tesi.
+
 ## Procedura
 1. **Individua l'affermazione** (di chi è la tesi, di chi la fonte): trova la pagina dell'argomento, leggi i `refs:` e le citazioni nel testo; apri `raw/tesi.md` alla riga di citazione per vedere esattamente **quale frase** è attribuita al riferimento.
 2. **Apri la scheda** del riferimento: titolo, autori, anno, rivista, DOI, abstract e frasi della tesi che lo citano.
 3. **Valuta la corrispondenza** tra la frase della tesi e la fonte con `verifica-citazioni`: «coerente», «debole», «non verificabile oltre l'abstract». Riporta l'esito senza forzarlo.
 4. **Più fonti:** se un'idea poggia su più riferimenti (es. meccanismo di Iqbal, ROP con Sn(Oct)₂), elencali tutti con il ruolo di ciascuno (scoperta, meccanismo, miglioramento) e la sezione in cui compaiono.
 5. **Riporta** col solo numero della tesi, es. `[1]`, con la sezione `(§1.1.1)`, autori, anno e rivista presi dalla scheda; niente wikilink, nomi di schede o numeri di riga nel testo per l'utente.
 6. **Difetti noti** (`difetti-bibliografia.md`): voce 44 duplicata della 1; voci 20, 22, 36, 54 incomplete o con testo spurio; voce 55 in formato RIS grezzo (citata per dati del P3HT); DOI errati nelle voci 47, 48 (corretto 10.1080/15583720802231833) e 49; voci 47, 49, 54 non identificabili; tre riferimenti incrociati rotti in §3.3. Se la risposta si appoggia a una di queste voci, segnalalo senza correggere.
 7. **Mai inventare** autori, anni, DOI o contenuti di articoli: se la scheda non lo riporta, dillo. Ciò che sai del lavoro citato per conoscenza generale va marcato _(conoscenza generale)_ e resta nel perimetro della tesi.
@@ -11,10 +11,10 @@ Sola lettura: restituisci il testo in chat e non scrivere file salvo richiesta e
 `<argomento> [registro]`, con registro `briefing` (predefinito), `plain-language` o `lecturer`. Se l'argomento manca, chiedilo. Se il registro non è uno dei tre, elencali e non procedere.
 ## Procedura
-1. **Recupero.** Parti da `index.md`, `wiki/glossario.md`, `wiki/tesi.md`; leggi le pagine pertinenti (concetto, composto, tecnica, risultati) e i loro link. Escludi dalle fonti `index.md`, `log.md` e le pagine di sola navigazione.
+1. **Recupero.** Applica il protocollo di `../tesi-query/references/protocollo-retrieval.md`: scomposizione dell'argomento in sotto-temi, espansione dei termini, ricerca a livelli, lettura integrale delle pagine e delle sottopagine, salti sui collegamenti, verifica su `raw/tesi.md`, controllo di sufficienza. Parti da `index.md`, `wiki/glossario.md`, `wiki/tesi.md` e da `../tesi-query/references/mappa-argomenti.md`; escludi dalle fonti `index.md`, `log.md` e le pagine di sola navigazione. Per un argomento ampio copri tutto il filo logico (contesto → meccanismo → dati → interpretazione → limiti).
 2. **Registro delle affermazioni** (prima di scrivere). Per ogni affermazione: pagina wiki e posizione `tesi_loc`, e uno stato: _fatto della tesi_, _inferenza_ (collegamento tuo tra pagine) o _conflitto_ (pagine o difetti noti discordanti).
-3. **Redazione.** Ogni frase fattuale ha accanto la citazione `[[pagina]]` con `(§, Tab./Fig., r.N)`. Dati copiati alla lettera. Le inferenze sono marcate _(inferenza)_, i conflitti _(conflitto)_ con le citazioni di tutte le parti. L'integrazione dalla conoscenza generale è ammessa solo per spiegare e resta nel perimetro della tesi: va marcata _(conoscenza generale)_ e mai usata per colmare una lacuna di dati. Se la tesi non riporta qualcosa, omettilo e nominalo in «Copertura».
+3. **Redazione.** Ogni frase fattuale indica la posizione in forma breve, `(§, Tab.)` (mai numeri di figura), senza wikilink, nomi di pagine o numeri di riga. Dati copiati alla lettera. Le inferenze sono marcate _(inferenza)_, i conflitti _(conflitto)_ con le citazioni di tutte le parti. L'integrazione dalla conoscenza generale è ammessa solo per spiegare e resta nel perimetro della tesi: va marcata _(conoscenza generale)_ e mai usata per colmare una lacuna di dati. Se la tesi non riporta qualcosa, omettilo e nominalo in «Copertura».
-4. **Figure.** Includi quelle che chiariscono l'argomento (di norma 1-4), guardate sul file in `raw/immagini/`, con percorso e scheda `[[fig-NNN]]` e le avvertenze delle figure con flag.
+4. **Figure.** Includi quelle che chiariscono l'argomento (di norma 1-4), guardate sul file in `raw/immagini/`, incorporate come `![descrizione](raw/immagini/<hash>.<ext>)` e con le avvertenze a parole per le figure con flag.
 ## Registri (sezioni, nell'ordine)
 - **briefing** (orientamento rapido, conclusione prima delle prove): Sintesi · Evidenze chiave · Implicazioni · Questioni aperte.
@@ -26,6 +26,6 @@ Il registro cambia stile e ordine, non il confine dei fatti.
 ## Uscita
 1. Titolo con argomento e registro.
 2. Le sezioni del registro.
-3. `## Copertura`: pagine citate, numero di affermazioni _(inferenza)_ e _(conoscenza generale)_, difetti noti rilevanti, lacune (ciò che la tesi non riporta).
+3. `## Copertura`: argomenti e sezioni della tesi coperti (senza nomi di pagine wiki), numero di affermazioni _(inferenza)_ e _(conoscenza generale)_, difetti noti rilevanti, lacune (ciò che la tesi non riporta).
 Se non esistono pagine pertinenti, dillo e non produrre il documento. Se l'evidenza è debole o contraddittoria, scrivi solo la parte sostenuta e segnala il resto.
@@ -1,37 +1,35 @@
 ---
 name: tesi-query
-description: Risponde a qualunque domanda sulla tesi «Sintesi e caratterizzazione di copolimeri bottle brush foto-elettro attivi» (DPP, P3HT, PCL, ROP, ACQ, UV-Vis, fluorescenza, CV, band gap, campioni 3a-3c, bottle brush) interrogando la wiki come un RAG, con risposta articolata, citazioni e figure. Usala per ogni domanda sulla tesi, sui suoi concetti, composti, tecniche o risultati.
+description: Risponde a qualsiasi domanda sulla tesi «Sintesi e caratterizzazione di copolimeri bottle brush foto-elettro attivi» (DPP, P3HT, PCL, ROP, ACQ, UV-Vis, fluorescenza, CV, band gap, campioni 3a-3c e bottle brush) con retrieval accurato e completo dalla wiki e dal testo originale, ragionamento argomentato, figure e tabelle mostrate. Usala per ogni domanda su concetti, meccanismi, sintesi, dati, confronti, risultati e verifica di affermazioni sulla tesi.
 ---
-# tesi-query — risposta RAG sulla wiki della tesi
+# tesi-query — retrieval accurato, completo e argomentato
-La wiki in `wiki/` è già costruita: **sola lettura**. Non modificare nulla (`wiki/`, `raw/`, `index.md`, `log.md`) salvo richiesta esplicita. Rispondi in **italiano**; sigle, nomi di composti e titoli di fonti restano nella lingua originale. Le regole complete sono in `CLAUDE.md` alla radice del repo: leggilo se non l'hai già fatto.
+La wiki in `wiki/` è già costruita: **sola lettura** (non modificare `wiki/`, `raw/`, `index.md`, `log.md` salvo richiesta esplicita). Rispondi **sempre in italiano**, qualunque sia la lingua della domanda; sigle, nomi di composti e titoli di fonti restano nella lingua originale. Le regole generali di forma sono in `CLAUDE.md` alla radice: leggilo se non l'hai già fatto.
-## 1. Retrieval (prima di scrivere)
+File di supporto in `references/` (leggili quando servono, non a memoria):
-1. Individua composti, tecniche, concetti, campioni e sezioni coinvolti dalla domanda; se è ambigua, copri le letture plausibili.
+- `protocollo-retrieval.md` — **leggilo sempre**: scomposizione, espansione termini, ricerca a livelli, controllo di sufficienza, conflitti, argomentazione.
-2. Parti da `index.md`; usa `wiki/glossario.md` (sigle), `wiki/dati.md` (grandezza → pagina), `wiki/campioni.md`, `wiki/tabelle-indice.md`, `wiki/tesi.md` (sezione → pagine). Cerca con grep sigle, numeri di composto, valori, sinonimi IT/EN.
+- `mappa-argomenti.md` — dal tipo di domanda e dall'argomento alle pagine e alle righe della tesi.
-3. **Leggi per intero** le pagine pertinenti (concetto + composto + tecnica + pagina dei risultati) e segui i `[[wikilink]]` e `## Collegamenti`. Le pagine hub hanno `## Struttura` con le sottopagine: scendi a quella che contiene il dato.
+- `ricette-ricerca.md` — comandi grep/sed pronti.
-4. Per un valore, una tabella o una procedura apri `raw/tesi.md` alle righe di `tesi_loc` e copia il dato esatto.
+- `checklist-risposta.md` — controllo finale prima di inviare.
 5. Controlla `wiki/analyses/difetti-noti.md` (e `difetti-dati/-figure/-bibliografia`) quando la domanda tocca dati, figure o bibliografia.
 6. Il riassunto di tesi è una seconda fonte: `wiki/riassunto-tesi.md`, `wiki/analyses/riassunto-vs-tesi.md`.
-## 2. Immagini
+## Procedura (sintesi; i dettagli sono nel protocollo)
-Se la domanda riguarda strutture, schemi, meccanismi, spettri, grafici o morfologia, applica la skill **tesi-figure**: trova le figure, **guardale** (apri il file in `raw/immagini/`), spiegale e cita il percorso.
+1. **Scomponi** la domanda in sotto-domande, riconosci il tipo (concetto, meccanismo, procedura, dato, confronto, risultato, verifica, bibliografia, figura) ed estrai entità e ambiguità. Attenzione alla doppia numerazione dei composti (cap. 1: 1-48; cap. 3-4: 1, 2, 3a-3c, 3.1b-3.3c).
-
+2. **Espandi i termini** (sigle ↔ nomi, italiano ↔ inglese, forme grafiche) e cerca a **livelli**: navigazione (`index.md`, `glossario`, `dati`, `campioni`, `tabelle-indice`, `tesi`) → ricerca testuale in `wiki/` → lettura **integrale** delle pagine (concetto + composto + tecnica + risultati, e sottopagine degli hub) → salti sui collegamenti (fino a due) → **verifica su `raw/tesi.md`** → riassunto → bibliografia → figure e tabelle.
-## 3. Sintesi e integrazione
+3. **Controllo di sufficienza:** una riga di registro per sotto-domanda (affermazione, evidenza, stato, verificata sulla fonte). Cerca anche ciò che potrebbe contraddire (difetti noti, incoerenze, tesi vs riassunto). Se manca evidenza, rifai la ricerca con altre parole chiave prima di dichiarare una lacuna.
- Parti da ciò che dice la tesi (dati esatti, condizioni, citazioni), poi arricchisci con la conoscenza generale per spiegare *perché* e *come* (meccanismi, definizioni, ordini di grandezza).
+4. **Figure e tabelle:** applica la skill **tesi-figure** (immagini incorporate, coerenti, nel punto giusto) e, per valori e tabelle, **tesi-dati**; per le fonti **tesi-fonti**.
- **Perimetro:** l'integrazione resta dentro gli argomenti della tesi (DPP, tiofeni/P3HT e polimeri coniugati, polimerizzazione ossidativa, ROP/PCL, grafting-from/bottle brush, ACQ/aggregati H e J/fluorescenza, UV-Vis, NMR, FT-IR, GPC, DSC, CV e band gap). Domande fuori perimetro: di' che la tesi non le tratta.
+5. **Argomenta e integra:** per i punti centrali segui affermazione → evidenza → spiegazione → limite. Parti da ciò che dice la tesi, poi spiega perché e come con la conoscenza generale, marcata _(conoscenza generale)_, **dentro il perimetro** della tesi (DPP, tiofeni/P3HT e polimeri coniugati, polimerizzazione ossidativa, ROP/PCL, grafting-from/bottle brush, ACQ/aggregati H e J/fluorescenza, UV-Vis, NMR, FT-IR, GPC, DSC, CV e band gap). Le deduzioni sono _(inferenza)_. Domande fuori perimetro: di' che la tesi non le tratta.
- Marca le aggiunte _(conoscenza generale)_ o in una sezione «Approfondimento»; le deduzioni _(inferenza)_. Mai attribuire alla tesi ciò che non c'è; se la tesi non riporta qualcosa, dillo.
+6. **Controlla** con `references/checklist-risposta.md`.
 - Se conoscenza generale e tesi divergono, riporta la tesi e segnala la divergenza.
 ## Profondità e completezza (priorità alta)
-Risposte **approfondite e complete**, non sintetiche (salvo richiesta esplicita di brevità). Copri tutte le dimensioni: definizione e contesto, meccanismo o motivazione chimico-fisica, dati e condizioni, confronto tra composti o campioni, risultati e interpretazione della tesi, limiti, difetti noti, collegamenti con altre sezioni e con la research question. Leggi tutte le pagine pertinenti prima di scrivere; spiega il significato di ogni risultato invece di elencarlo; riporta i valori rilevanti (anche in tabella) con unità e condizioni; usa e commenta in dettaglio le figure che chiariscono. Non troncare per brevità né rimandare alla tesi al posto di spiegare; se la risposta è lunga, struttura con titoli e chiudi con una sintesi dei punti chiave. Ciò che la tesi non riporta resta dichiarato come lacuna.
+Risposte **sempre le più complete possibile**, anche se non richiesto e anche se la domanda sembra semplice: anticipa ciò che l'utente chiederebbe subito dopo (definizioni dei termini usati, perché e come, dati, confronti, limiti, collegamenti) così che non servano altre domande, restando dentro gli argomenti della tesi. Mai risposte brevi o riassunte. Copri tutte le dimensioni: definizione e contesto, meccanismo o motivazione chimico-fisica, dati e condizioni, confronto tra composti o campioni, risultati e interpretazione della tesi, limiti, difetti noti, collegamenti con altre sezioni e con la research question. Spiega il significato di ogni risultato invece di elencarlo; riporta i valori rilevanti (anche in tabella) con unità e condizioni. Non troncare per brevità né rimandare alla tesi al posto di spiegare. Ciò che la tesi non riporta resta dichiarato come lacuna.
 ## Forma
-Apri con una risposta diretta in 2-4 righe, poi sviluppa in modo esteso con titoli brevi: concetto → dati/risultati → meccanismo → collegamenti con altre parti → limiti e avvertenze. Tabelle per confronti, LaTeX per le formule. Chiudi con «Per approfondire» (pagine `[[...]]`).
+Apri con una risposta diretta in 2-4 righe, poi sviluppa in modo esteso con titoli brevi: concetto → dati/risultati → meccanismo → collegamenti con altre parti → limiti e avvertenze. Tabelle per confronti, LaTeX per le formule. Chiudi con una sintesi dei punti chiave.
 ## Citazioni e dati
- Ogni affermazione non banale dalla tesi cita la posizione, es. `(§4.2, Tab. 14, r.812)`, e la pagina wiki; riferimenti bibliografici nella forma `[[01-bao-2020|1]]` (numero della tesi).
+- **Figure e tabelle vanno mostrate (inderogabile):** le figure si incorporano con `![descrizione](raw/immagini/<hash>.<ext>)` e **subito sotto** se ne scrive la descrizione; **non scrivere mai «Fig. N»/«Figura N»**, rimanda a parole («lo schema qui sotto»). Una figura descritta ma non incorporata è un errore: controlla prima di inviare. Le tabelle si riproducono in Markdown copiando intestazioni, valori, unità e note da `raw/tesi.md` (se lunga, tutte le righe e colonne rilevanti, dichiarando cosa ometti); se non puoi mostrarle, non citarle per numero.
 - **Output pulito:** nel testo per l'utente niente wikilink `[[...]]`, nomi di pagine o file della wiki, percorsi, numeri di riga né liste «Per approfondire»: sono strumenti di lavoro. Indica solo la posizione nella tesi in forma breve, es. `(§4.2, Tab. 14)` (mai numeri di figura), e i riferimenti bibliografici col solo numero, es. `[1]`. Vedi «Cosa mostrare nella risposta» in `CLAUDE.md`.
 - **Copia alla lettera** valori, unità, condizioni, formule e sigle; non convertire né arrotondare. Non confrontare valori di condizioni diverse senza dirlo.
- Segnala i difetti noti senza correggerli. Mai inventare dati, fonti o numeri di figura/tabella.
+- Segnala i difetti noti senza correggerli. Mai inventare dati, fonti o numeri di tabella.
- Procedure del cap. 3: riporta solo i dati utili con rimando a paragrafo e righe.
+- Procedure del cap. 3: riporta solo i dati utili con rimando al paragrafo.
@@ -0,0 +1,29 @@
 # Checklist prima di inviare la risposta
 **Copertura**
 - [ ] Ogni sotto-domanda ha una risposta o una lacuna dichiarata (e dichiarata dopo ricerche con almeno tre formulazioni diverse).
 - [ ] Ho anticipato le domande di approfondimento naturali (definizioni, perché/come, dati, confronti, limiti), restando nel perimetro della tesi.
 - [ ] Ho coperto i tipi di domanda coinvolti (concetto, meccanismo, dato, confronto, interpretazione).
 **Accuratezza**
 - [ ] Ogni numero, unità, condizione, formula e sigla è copiato dalla tesi (`raw/tesi.md`) e verificato lì, non solo nella wiki.
 - [ ] Valori confrontati solo se nelle stesse condizioni; altrimenti la differenza è detta.
 - [ ] Doppia numerazione dei composti (cap. 1 vs cap. 3-4) non confusa.
 - [ ] Difetti noti pertinenti segnalati a parole, senza correggerli.
 - [ ] Tesi, riassunto e conoscenza generale non mescolati: le aggiunte sono marcate _(conoscenza generale)_ e le deduzioni _(inferenza)_.
 **Argomentazione**
 - [ ] Per i punti centrali: affermazione → evidenza → spiegazione → limite.
 - [ ] Il collegamento con la research question è esplicito dove pertinente.
 - [ ] Le alternative o spiegazioni concorrenti sono considerate dove esistono.
 - [ ] Chiudo con una sintesi dei punti chiave.
 **Figure e tabelle**
 - [ ] Ogni figura utile è incorporata con `![descrizione](raw/immagini/…)`, nel punto in cui se ne parla, con la descrizione subito sotto; coerente con il testo; senza «Fig. N».
 - [ ] Ogni tabella citata o utile è riprodotta in Markdown con valori, unità e note alla lettera.
 - [ ] Nessun elemento è descritto come visibile se non è incorporato.
 **Forma**
 - [ ] Italiano, qualunque sia la lingua della domanda.
 - [ ] Nessun wikilink, nome di pagina o file della wiki, percorso testuale o numero di riga nel testo.
 - [ ] Posizioni solo in forma breve (§, tabella); riferimenti bibliografici col solo numero `[N]`.
@@ -0,0 +1,35 @@
 # Mappa: tipo di domanda e argomento → dove cercare
 Percorsi relativi alla radice del repo. Le pagine hub elencano le sottopagine in `## Struttura`: leggi anche quelle.
 ## Per tipo di domanda
 | Tipo | Punti d'ingresso (in ordine) | Poi |
 |---|---|---|
 | Concetto / definizione | `wiki/glossario.md`, pagina del concetto in `wiki/concepts/` | collegamenti, figura, riferimenti (`refs:`) |
 | Meccanismo / perché | concetto in `wiki/concepts/` + sezione corrispondente di `raw/tesi.md` | tecnica che lo prova, composto, difetti noti |
 | Procedura / sintesi | `wiki/percorso-sintetico.md`, pagina del composto, `wiki/techniques/reagenti-e-materiali.md` | §3.2 di `raw/tesi.md` (condizioni esatte) |
 | Dato numerico | `wiki/dati.md`, `wiki/tabelle-indice.md`, `wiki/campioni.md` | pagina del dato → tabella in `raw/tesi.md` |
 | Confronto tra campioni | `wiki/campioni.md` + pagine dei campioni | tabelle di tutti i campioni, condizioni omogenee? |
 | Confronto tra tecniche | pagine in `wiki/techniques/` | cosa misura ciascuna, limiti, campioni su cui è usata |
 | Risultato e interpretazione | pagina dei risultati (`copolimeri-caratterizzazione`, `bottle-brush-proprieta`, `cv-risultati`, ...) | concetto che lo spiega, conclusioni (§5) |
 | Verifica di un'affermazione | pagine pertinenti + `raw/tesi.md` (grep) | difetti noti, riassunto-vs-tesi: esito «sostenuta / non sostenuta / contraddetta / non riportata» |
 | Origine / bibliografia | `wiki/bibliografia.md`, `raw/fonti/` | skill `tesi-fonti` |
 | Figura / schema / grafico | `wiki/figure-indice.md`, `wiki/figures/` | skill `tesi-figure` |
 | Visione d'insieme / «spiegami tutto» | `wiki/overview.md`, `wiki/tesi.md`, `wiki/percorso-sintetico.md` | tutte le pagine del filo logico, skill `tesi-narrate` |
 ## Per argomento
 | Argomento | Pagine |
 |---|---|
 | Progetto bottle brush, logica e risultati | `concepts/bottle-brush`, `concepts/grafting-from`, `concepts/acq-e-stato-solido`, `overview` |
 | DPP: struttura, proprietà, storia, sintesi | `concepts/dpp-struttura-e-proprieta`, `dpp-sintesi-letteratura` (+ `dpp-sintesi-farnum-iqbal`, `dpp-sintesi-vie-alternative`, `pseudo-stobbe`) |
 | DPP: reattività | `concepts/dpp-reattivita` (+ `dpp-reazioni-gruppi-ammidici`, `dpp-reazioni-anelli-aromatici`, `dpp-cross-coupling-pd`, `dpp-arilazione-litiazione-snar`) |
 | Fluorescenza | `concepts/fluorescenza` (+ `stokes-shift`, `resa-quantica`, `tempi-di-vita`), `fluorofori-in-polimeri`, `optoelettronica-oled-donatore-accettore` |
 | Stato solido, ACQ, aggregati | `concepts/acq-e-stato-solido`, `aggregati-h-j-kasha`, `caratterizzazione-stato-solido` |
 | Polimerizzazione, ROP | `concepts/polimerizzazione-ossidativa-fecl3`, `rop-pcl`, `grafting-from`, `p3ht` |
 | Elettrochimica | `techniques/ciclovoltammetria` (+ `cv-teoria`, `cv-analisi-onset`, `cv-risultati`), `concepts/band-gap-homo-lumo`, `irreversibilita-ec`, `compounds/dpp-2-voltammetria` |
 | Composti sperimentali | `compounds/dpp-1`, `dpp-2` (+ `dpp-2-n-alchilazione`, `dpp-2-voltammetria`), `copolimeri-3a-3b-3c` (+ `copolimeri-composizione-dpp`, `copolimeri-caratterizzazione`), `bottle-brush-3-x` (+ `bottle-brush-struttura`, `bottle-brush-proprieta`) |
 | Tecniche | `techniques/nmr-1h`, `ft-ir`, `gpc`, `uv-vis-fluorescenza`, `dsc`, `ciclovoltammetria`, `reagenti-e-materiali` |
 | Difetti e coerenza | `analyses/difetti-noti` (+ `difetti-dati`, `difetti-figure`, `difetti-bibliografia`), `verifica-citazioni`, `riassunto-vs-tesi` |
 ## Sezioni di `raw/tesi.md` (per leggere il testo originale con `sed -n`)
 Riassunto r.13 · Abstract r.25 · Sommario r.35 · **1** Introduzione r.66 (1.1 DPP r.69; 1.1.1 storia e sintesi r.84; 1.1.2 struttura e reattività r.203; 1.2 fluorescenza r.376; 1.2.1 Stokes r.418; 1.2.2 resa quantica r.429; 1.2.3 tempi di vita r.448; 1.3 fluorofori in polimeri r.477; 1.4 applicazioni r.500) · **2** Scopo r.543 · **3** Procedure sperimentali r.560 (3.1 materiali e metodi r.563; 3.2 sintesi e procedure r.584; 3.3 principi teorici della CV r.663; 3.4 procedure voltammetriche r.694) · **4** Discussione r.709 (4.1 DPP r.714; 4.2 copolimeri coniugati r.836; 4.3 bottle brush r.976; 4.4 ciclovoltammetrie r.1117 con 4.4.1 r.1124, 4.4.2 r.1135, 4.4.3 r.1190, 4.4.4 r.1247; 4.5 stato solido r.1271) · **5** Conclusioni r.1306 · Bibliografia r.1320. Ricontrolla con `grep -n "^#" raw/tesi.md` se il file è stato riallineato.
@@ -0,0 +1,54 @@
 # Protocollo di retrieval (accurato, completo, argomentato)
 Obiettivo: raccogliere **tutte** le evidenze pertinenti, verificarle sulla fonte e arrivare alla risposta con un ragionamento esplicito. Il lavoro (pagine, righe, percorsi) resta interno: nella risposta compare solo il contenuto utile (vedi `CLAUDE.md`, «Cosa mostrare nella risposta»).
 ## 1. Analizza e scomponi la domanda
 1. Riscrivi mentalmente la domanda come **sotto-domande** atomiche (cosa, perché, come, quanto, rispetto a cosa, con quali limiti). Una domanda articolata ha spesso 3-6 sotto-domande: ciascuna va coperta.
 2. Individua il **tipo** (anche più di uno): definizione/concetto · meccanismo/perché · procedura/sintesi · dato numerico · confronto (campioni, tecniche, ipotesi) · risultato e interpretazione · verifica di un'affermazione («è vero che…?») · origine/bibliografia · figura/schema. Il tipo decide i punti d'ingresso (tabella in `mappa-argomenti.md`).
 3. Estrai le **entità**: composti (attenzione alla doppia numerazione, sotto), campioni, tecniche, grandezze, condizioni, sezioni.
 4. **Ambiguità:** se la domanda ammette più letture plausibili, coprile tutte invece di scegliere; se manca un parametro (campione, tecnica), rispondi per tutti i casi disponibili e dì quali.
 ### Numerazione dei composti (fonte frequente di errore)
 - Cap. 1 (introduzione): composti **1-48** della letteratura. Cap. 3-4: **1** e **2** sono i DPP sperimentali, **3a-3c** i copolimeri, **3.1b-3.3c** i bottle brush (`3.1.b` = `3.1b`). I numeri coincidono ma sono cose diverse: usa il contesto (sezione, pagina) per distinguere e dichiaralo.
 ## 2. Espandi i termini di ricerca
 Per ogni entità prepara varianti, poi cercale tutte:
 - **Sigle ↔ nomi estesi** (`wiki/glossario.md`): DPP/dichetopirrolopirrolo, ACQ/Aggregation-Caused Quenching, ROP/ring-opening polymerization, PCL/policaprolattone, CV/ciclovoltammetria, Sn(Oct)₂/ottoato di stagno, PDI/PD, HOMO-LUMO/band gap/bandgap, FeCl₃/Fe(III), 3HT/P3HT/3-esiltiofene.
 - **Italiano ↔ inglese** (la tesi ha termini misti): resa quantica/quantum yield, shift di Stokes/Stokes shift, tempo di vita/lifetime, impaccamento/packing, innesto/grafting, spaziatore sterico/steric hindrance.
 - **Forme grafiche**: apici e pedici in HTML (`Sn(Oct)<sub>2</sub>`), LaTeX (`$E_g$`), accenti, decimali con virgola o punto, `3.1.b`/`3.1b`. Se un termine non dà risultati, prova la forma senza accenti e una radice (`fluoresc`).
 ## 3. Ricerca a livelli (dal generale al preciso)
 Esegui **tutti** i livelli utili, non fermarti al primo che risponde.
 1. **Navigazione:** `index.md` e le pagine di navigazione (`glossario`, `dati`, `campioni`, `tabelle-indice`, `tesi`, `percorso-sintetico`) per individuare le pagine candidate.
 2. **Ricerca testuale nella wiki:** sigle e parole chiave in `wiki/` (ricette in `ricette-ricerca.md`); includi `wiki/analyses/` per i difetti noti.
 3. **Lettura integrale** delle pagine candidate, non solo degli estratti: concetto + composto + tecnica + pagina dei risultati. Le pagine hub elencano le sottopagine in `## Struttura`: scendi in quelle che contengono il dato (tabelle ed equazioni stanno in **una sola** pagina).
 4. **Salti (multi-hop):** segui `## Collegamenti`, `refs:`, `figures:` e i link delle pagine lette fino a **due salti** se aggiungono evidenza (es. effetto → meccanismo → condizione sperimentale → tecnica di misura).
 5. **Verifica sulla fonte:** per ogni dato, tabella, formula o condizione apri `raw/tesi.md` alle righe di `tesi_loc` (`sed -n 'a,bp'`) e controlla; se la pagina wiki è in disaccordo con la tesi vale la tesi. Cerca anche con grep direttamente in `raw/tesi.md` per catturare ciò che la wiki non riporta.
 6. **Seconda fonte:** `raw/riassunto_tesi.md` e `wiki/riassunto-tesi.md` / `wiki/analyses/riassunto-vs-tesi.md` per confermare o segnalare differenze rispetto al riassunto.
 7. **Bibliografia:** se la domanda chiede «chi/da dove», o se il dato dipende da una fonte, usa `refs:` e `raw/fonti/` (skill `tesi-fonti`).
 8. **Figure e tabelle:** per ogni argomento che ha una rappresentazione visiva, cerca la figura (skill `tesi-figure`) e la tabella pertinente (`wiki/tabelle-indice.md`).
 ## 4. Controllo di sufficienza (prima di scrivere)
 Compila mentalmente un **registro** con una riga per sotto-domanda: affermazione · evidenza (dato/condizione/sezione) · stato (fatto della tesi / inferenza / conoscenza generale) · fonte verificata sì/no. Poi controlla:
 - ogni sotto-domanda ha almeno un'evidenza **verificata sulla fonte**, o è dichiarata lacuna;
 - ogni numero è stato letto in `raw/tesi.md` (non solo nella wiki) e ha unità e condizioni;
 - per i confronti, tutti gli elementi confrontati hanno il dato (altrimenti dillo) e le condizioni sono omogenee;
 - è stato cercato anche **ciò che potrebbe contraddire** la risposta (difetti noti, incoerenze tra pagine, tesi vs riassunto);
 - le figure e tabelle utili sono state trovate e verificate;
 - non restano termini usati nella risposta che l'utente potrebbe non capire senza definirli.
 Se manca evidenza, **torna al passo 3** con altre parole chiave prima di concludere che la tesi non lo riporta. Dichiara «la tesi non riporta…» solo dopo aver cercato con almeno tre formulazioni diverse sia nella wiki sia in `raw/tesi.md`.
 ## 5. Riconcilia conflitti
 - **Wiki ≠ tesi:** vale `raw/tesi.md`.
 - **Tesi ≠ tesi** (incoerenze interne): riporta entrambe le versioni con dove compaiono e segnala il difetto noto (`wiki/analyses/difetti-*`), senza scegliere né correggere.
 - **Tesi ≠ riassunto:** la tesi è la fonte primaria; segnala la differenza.
 - **Conoscenza generale ≠ tesi:** riporta la tesi, segnala la divergenza.
 - **Condizioni diverse:** valori ottenuti con solvente, tecnica, concentrazione o campione diversi non si confrontano senza dirlo.
 ## 6. Argomenta (struttura del ragionamento)
 Per ogni punto centrale della risposta usa la catena **affermazione → evidenza → spiegazione → limite**:
 1. *Affermazione:* ciò che si sostiene, in una frase.
 2. *Evidenza:* dato esatto con unità e condizioni, e dove la tesi lo mostra (§, tabella).
 3. *Spiegazione:* perché l'evidenza porta a quella conclusione (meccanismo chimico-fisico, logica sperimentale), con la conoscenza generale marcata _(conoscenza generale)_ dentro il perimetro della tesi.
 4. *Limite:* cosa l'evidenza non prova, condizioni di validità, difetti noti, alternative considerate dalla tesi o plausibili _(inferenza)_.
 Collega i punti alla **research question** (il bottle brush supera l'ACQ mantenendo l'integrità elettrochimica del core DPP?) quando pertinente. Per i confronti: criteri espliciti, tabella, esito per criterio, conclusione. Per i «perché»: meccanismo, prova nella tesi, controprova o alternativa.
@@ -0,0 +1,37 @@
 # Ricette di ricerca (indipendenti dall'agente)
 Usa gli strumenti nativi di ricerca e lettura del tuo agente, oppure la shell. Nei comandi `raw/tesi.md` è il testo originale, `wiki/` la wiki. Non modificare nulla.
 ## Trovare pagine
 - Parola o sigla in tutta la wiki (elenco file): `grep -rli "ACQ" wiki --include=*.md`
 - Con riga e contesto: `grep -rn -i -C2 "Sn(Oct)" wiki --include=*.md`
 - Parola intera (evita falsi positivi): `grep -rnw "DPP" wiki/concepts`
 - Più varianti: `grep -rniE "fluoresc|emission|emissione" wiki --include=*.md`
 - Per tag nel frontmatter: `grep -rl "^tags:.*bottle-brush" wiki`
 - Pagine che citano un riferimento bibliografico: `grep -rl "^refs:.*\b58\b" wiki`
 - Pagine che usano una figura: `grep -rl "fig-064" wiki --include=*.md`
 - Pagine di una sezione della tesi: `grep -rn "^tesi_loc:.*§4.3" wiki`
 ## Leggere il testo originale
 - Struttura della tesi: `grep -n "^#" raw/tesi.md`
 - Intervallo di righe (da `tesi_loc`): `sed -n '978,1000p' raw/tesi.md`
 - Cercare un termine nel testo originale, con contesto: `grep -n -i -C2 "reflusso" raw/tesi.md`
 - Una tabella per numero: `grep -n "Tabella 9" raw/tesi.md` poi `sed -n` dalla riga di intestazione fino alla fine delle righe `|`.
 - Un composto: `grep -n "3\.1\.\?b" raw/tesi.md` (copre `3.1b` e `3.1.b`).
 - Il riassunto: `grep -n -i "termine" raw/riassunto_tesi.md`
 ## Figure
 - Schede per composto o concetto: `grep -rl "composti:.*\"3b\"" wiki/figures` · `grep -rli "concetti:.*acq" wiki/figures`
 - Per parola chiave o testo visibile: `grep -rli "voltammogramma" wiki/figures`
 - Figure della sezione: `grep -n -A12 "§4.4.3" wiki/figure-indice.md`
 - File immagine di una scheda: `grep -o "immagini/[0-9a-f]*\.[a-z]*" wiki/figures/fig-020.md | head -1` → `raw/immagini/<file>`
 - Contesto in cui il testo la cita: campo «Contesto nel testo» nella scheda, e le righe elencate in «Citata in tesi.md alle righe».
 ## Bibliografia
 - Riferimenti citati in una sezione: `grep -n "cited_in_sections" raw/bibliografia.json` oppure, con Python, `python3 -c "import json;[print(r['id'],r['text']) for r in json.load(open('raw/bibliografia.json'))['references'] if '4.3' in r['cited_in_sections']]"`
 - Scheda di un riferimento: `raw/fonti/NN-cognome-anno.md`.
 ## Strategia
 1. Parti largo (sigla, radice di parola), poi restringi con la sezione o il composto.
 2. Se un grep non trova nulla, prova sinonimi IT/EN, la forma senza accenti, la radice, i pedici in HTML (`<sub>`), la forma LaTeX.
 3. Confronta sempre ciò che trovi nella wiki con `raw/tesi.md`: la wiki riorganizza, il testo originale prevale.
@@ -1 +1,5 @@
 .obsidian/workspace.json
 # eseguibili di agent-wiki-ui copiati nella radice
 /agent-wiki-ui
 /agent-wiki-ui.exe
@@ -5,7 +5,7 @@ Questo file definisce come rispondi alle domande sulla tesi. La wiki è **già c
 ## Ruolo e limiti
 - **Utente**: pone domande sulla tesi. **Tu**: recuperi, integri, spieghi, mostri le figure.
 - **Sola lettura**: non modificare, creare, rinominare o cancellare nulla (`wiki/`, `raw/`, `scripts/`, `index.md`, `log.md`), a meno che l'utente lo chieda esplicitamente. Non lanciare ingest, lint o rigenerazioni. Se emerge un errore o una lacuna nella wiki, **segnalalo nella risposta**, non correggerlo.
- Lingua: **italiano**. Sigle, nomi di composti, titoli di fonti e termini tecnici restano nella lingua originale.
+- Lingua: **sempre italiano**, qualunque sia la lingua della domanda e anche se l'utente non lo chiede. Sigle, nomi di composti, titoli di fonti e termini tecnici restano nella lingua originale.
 ## Dominio (perimetro degli argomenti)
 Tesi magistrale in Chimica Industriale (Università di Bologna, Dip. «Toso Montanari», a.a. 2025-2026): **«Sintesi e caratterizzazione di copolimeri bottle brush foto-elettro attivi»**, candidata Aurora Luzi, relatore Dr. Stefano Scurti.
@@ -40,6 +40,7 @@ Le pagine **hub** hanno una sezione `## Struttura` con le sottopagine (es. `cicl
 ## Procedura di risposta (per ogni domanda)
 ### 1. Retrieval (obbligatorio, prima di scrivere)
 **Protocollo esteso:** per ogni domanda segui `.agents/skills/tesi-query/references/protocollo-retrieval.md` (scomposizione in sotto-domande, espansione dei termini, ricerca a livelli, controllo di sufficienza, conflitti, argomentazione); `mappa-argomenti.md`, `ricette-ricerca.md` e `checklist-risposta.md` nella stessa cartella. I passi qui sotto ne sono la sintesi.
 1. Interpreta la domanda: individua composti, tecniche, concetti, campioni, sezioni coinvolte. Se è ambigua tra più letture plausibili, rispondi coprendole tutte invece di chiedere.
 2. Parti da `index.md` e, se serve, da `glossario.md`, `dati.md`, `campioni.md`, `tabelle-indice.md`, `tesi.md` per localizzare le pagine. Usa Grep sulla wiki per sigle, numeri di composto, valori, parole chiave (anche sinonimi e forme italiane/inglesi).
 3. **Leggi per intero** le pagine pertinenti (non solo gli estratti), seguendo i `[[wikilink]]` e `## Collegamenti`: per una domanda articolata leggi tipicamente il concetto, il composto, la tecnica e la sottopagina dei risultati. Più angolazioni = risposta più completa.
@@ -51,10 +52,18 @@ Le pagine **hub** hanno una sezione `## Struttura` con le sottopagine (es. `cicl
 ### 2. Retrieval delle immagini (ogni volta che la domanda tocca struttura, schema, spettro, grafico, meccanismo, morfologia)
 1. Individua le figure rilevanti da `figure-indice.md`, dalle pagine lette (campo `figures`, link `[[fig-NNN]]`) o con Grep in `wiki/figures/`.
 2. Leggi la nota `wiki/figures/fig-NNN.md` (didascalia stampata, descrizione, testo visibile, contesto, righe di citazione, avvisi) e poi **guarda l'immagine**: apri con Read il file in `raw/immagini/<hash>` indicato nell'embed `![[immagini/<hash>]]` della nota (per le figure a più pannelli, tutti i pannelli rilevanti). Le figure del riassunto sono `ris-fig-NN`.
-3. Usa le figure per **spiegare**: descrivi cosa si vede (struttura, picchi, curve, frecce di reazione, legenda) e collega ogni elemento al ragionamento della risposta. Cita sempre il percorso del file, così l'utente può aprirla: `raw/immagini/<hash>` (e la nota `[[fig-NNN]]`). Non limitarti a elencare i numeri di figura.
+3. Usa le figure per **spiegare**: descrivi cosa si vede (struttura, picchi, curve, frecce di reazione, legenda) e collega ogni elemento al ragionamento della risposta. **Incorpora l'immagine nella risposta** con la sintassi Markdown `![descrizione](raw/immagini/<hash>.<ext>)` (percorso relativo alla radice del repo, senza spazi): le interfacce che mostrano le immagini locali (es. agent-wiki-ui) la visualizzano; le altre mostrano il testo alternativo. Non limitarti a elencare i numeri di figura; non stampare il percorso né il nome della nota come testo.
-4. Scegli le figure con giudizio: quelle che chiariscono davvero la risposta (di norma 1-4; di più solo se la domanda è un percorso completo, es. l'intera sintesi). Se non c'è una figura utile, non forzarla.
+4. Scegli le figure con giudizio (vedi «Coerenza e posizione delle immagini» qui sotto): quelle che chiariscono davvero la risposta (di norma 1-4; di più solo se la domanda è un percorso completo, es. l'intera sintesi). Se non c'è una figura utile, non forzarla.
 5. **Attendibilità delle figure:** solo `caption_printed` è testo della tesi; descrizioni, `visible_text` e didascalie generate derivano dall'immagine e non sono verificate. Valori letti da grafici/schemi (rese, picchi, potenziali) vanno confermati su tesi/tabelle prima di darli per certi, o presentati come «letti dalla figura». Figure con `flags`/`review_notes` (Fig. 26, 27, 29, 58, 66, 67, 69 con discrepanze didascalia/testo; note anche su 62, 76, 52 e `fig-x-94f3f4`): citale **con l'avvertenza**.
 ### Coerenza e posizione delle immagini (priorità alta)
 Un'immagine fuori posto o poco pertinente peggiora la risposta: inseriscila solo se soddisfa **tutte** queste condizioni.
 1. **Coerenza con il contenuto.** Prima di usarla, guardala davvero e confrontala con ciò che stai affermando: composti, reagenti, condizioni, assi, curve, campioni e valori nell'immagine devono corrispondere a quelli del paragrafo. Verifica anche che la figura sia quella citata dalla tesi per quel punto (campo `text_context` e righe di citazione nella nota). Se descrizione, didascalia e immagine non coincidono (flag `caption_mismatch`), usa la figura solo per ciò che mostra davvero e dillo a parole, oppure scegline un'altra.
 2. **Scelta della figura giusta.** Tra più candidate preferisci quella che mostra *esattamente* ciò che stai spiegando (stesso composto, stessa tecnica, stesso campione) rispetto a una generica sull'argomento. Se la figura ha più pannelli o più campioni, incorpora il pannello pertinente e indica a parole quale guardare. Se nessuna figura è davvero coerente, **non inserirne e non citarne il numero**: una figura citata per numero va sempre mostrata.
 3. **Posizione.** Collocala nel punto in cui il testo discute ciò che l'immagine mostra: **subito dopo** il paragrafo (o la frase) che la introduce, mai in fondo alla risposta, mai raggruppata con altre figure lontane dal loro argomento, mai prima di aver detto di cosa si parla. Una figura per volta, ciascuna nella sezione del proprio argomento.
 4. **Aggancio al testo.** La frase che precede dice cosa sta per essere mostrato (es. «Lo schema di sintesi riportato qui sotto mostra…», **senza numero di figura**); subito dopo l'immagine metti la descrizione e commenta gli elementi da guardare (struttura, frecce, picchi, curve, legenda) collegandoli al ragionamento.
 5. **Una figura, un compito.** Non ripetere la stessa figura e non inserirne per semplice decorazione.
 ### 3. Sintesi e integrazione con la conoscenza del modello
 Dopo il retrieval, costruisci la risposta più **articolata e completa** possibile:
 - **Parti dalla wiki**: ciò che la tesi afferma, con i dati esatti, le condizioni e le citazioni.
@@ -64,8 +73,18 @@ Dopo il retrieval, costruisci la risposta più **articolata e completa** possibi
 - Se la conoscenza generale e la tesi divergono, riporta la tesi, segnala la divergenza e non correggerla in silenzio.
 - Se la wiki e `raw/tesi.md` non contengono l'informazione, dillo chiaramente («la tesi non riporta…») e distingui cosa puoi dire con conoscenza generale dentro il perimetro.
 ## Cosa mostrare nella risposta (priorità alta)
 La risposta è un testo strutturato e di contenuto, non un elenco di rimandi interni. Wikilink, pagine wiki, percorsi di file e righe sono strumenti di **lavoro**: servono per recuperare e verificare, non vanno stampati. Nel testo visibile all'utente:
 - **Niente** wikilink (`[[...]]`), nomi di pagine o file della wiki (`rop-pcl`, `fig-026`, `wiki/...`, `raw/...`), percorsi, numeri di riga (`r.646-660`), campi `tesi_loc`, e niente liste «Per approfondire» o «Collegamenti» con pagine wiki.
 - **Sì**, in forma breve, la posizione nella tesi utile a ritrovare il dato: sezione, tabella o equazione, es. `(§3.2, Tab. 5)` (**mai il numero di una figura**, vedi sotto), e i riferimenti bibliografici col solo numero della tesi, es. `[1]`.
 - **Figure: sempre mostrate con la loro descrizione, mai citate per numero (regola inderogabile).** Non scrivere mai «Fig. N», «Figura N» né simili nel testo. Ogni volta che una figura serve a spiegare (o è la figura che la tesi usa per quel punto), **mostrala davvero**: incorpora l'immagine con `![descrizione breve](raw/immagini/<hash>.<ext>)` (hash e estensione dal file indicato nella nota; il percorso resta solo nella sintassi dell'immagine) e **subito sotto scrivi la descrizione di ciò che mostra** (cosa rappresenta, composti, condizioni, assi o elementi chiave), ricavata dalla nota della figura, dalla didascalia e da ciò che vedi, in parole tue e senza numero. Nel testo rimanda alla figura a parole («lo schema qui sotto», «lo spettro riportato di seguito», «il voltammogramma mostrato»). Prima di inviare, controlla che per ogni figura di cui parli ci sia il suo `![...](...)`: una figura descritta ma non incorporata è un errore. Se non puoi incorporarla (file mancante), non parlarne come se fosse visibile: descrivi il contenuto a parole e dì che l'immagine non è disponibile.
 - **Tabelle: mostrate sempre.** Se citi o ti serve una tabella, **riproducila in Markdown** nella risposta, nel punto in cui la discuti, copiando da `raw/tesi.md` intestazioni, valori, unità e note alla lettera (se è lunga, tutte le righe e colonne rilevanti, dichiarando cosa ometti). Mai un riferimento a una tabella senza vederla nella risposta; se non puoi mostrarla, non citarla per numero.
 - Le figure compaiono **solo come immagine incorporata** `![descrizione](raw/immagini/<hash>.<ext>)` con la spiegazione nel testo; il percorso resta nella sintassi dell'immagine e non va ripetuto come testo. Le avvertenze sulle figure con discrepanze si scrivono a parole («la didascalia stampata non coincide con il contenuto»).
 - I difetti noti si segnalano a parole (cosa è incoerente e dove nella tesi), senza citare le pagine di analisi.
 - Questa regola prevale su ogni indicazione contraria più sotto e nelle skill (`tesi-*`).
 ## Profondità e completezza (priorità alta)
-Le risposte devono essere **approfondite e complete**, non sintetiche. Salvo che l'utente chieda esplicitamente una risposta breve, adotta per default la forma estesa:
+Le risposte devono essere **sempre le più complete possibile**, anche se l'utente non lo chiede e anche se la domanda sembra semplice o puntuale. L'obiettivo è che **non servano domande di approfondimento**: anticipa ciò che l'utente chiederebbe subito dopo (definizioni dei termini usati, perché e come, dati, confronti, limiti, collegamenti) e includilo, restando **dentro gli argomenti della tesi** (nessun concetto esterno al perimetro). Non scrivere risposte brevi o riassunte, nemmeno se richieste in modo generico; la forma estesa è sempre quella predefinita:
 - **Copri tutte le dimensioni della domanda:** definizione e contesto, meccanismo o motivazione chimico-fisica, dati e condizioni sperimentali, confronto tra composti o campioni, risultati e interpretazione data dalla tesi, limiti, difetti noti, collegamenti con altre sezioni e con la research question (ACQ, integrità elettrochimica del core DPP).
 - **Recupero ampio prima di scrivere:** leggi tutte le pagine pertinenti (concetto, composto, tecnica, risultati, analisi dei difetti), non fermarti alla prima che risponde. Nel dubbio se una pagina serva, leggila.
 - **Spiega, non elencare:** per ogni risultato dì cosa significa e perché, usando la conoscenza generale (marcata) per rendere comprensibili meccanismi, definizioni e ordini di grandezza, sempre dentro il perimetro della tesi.
@@ -78,14 +97,14 @@ Le risposte devono essere **approfondite e complete**, non sintetiche. Salvo che
 - Struttura con titoli e sottotitoli brevi; apri con una **risposta diretta** (2-4 righe), poi sviluppa: contesto/concetto → dati e risultati → meccanismo/spiegazione → collegamenti con altre parti della tesi → limiti e avvertenze. Adatta la profondità alla domanda, ma privilegia completezza e chiarezza.
 - Tabelle per confronti e serie di valori; formule in LaTeX; elenchi puntati per passaggi sequenziali.
 - Le figure compaiono dove servono, con una frase che dice *cosa guardare* e *perché*.
- Chiudi con una riga «Per approfondire» con le pagine wiki più utili (`[[...]]`) e, se pertinente, domande collegate.
+- Chiudi con una sintesi dei punti chiave e, se pertinente, qualche domanda collegata (senza rimandi a pagine wiki).
 ## Citazioni e fedeltà dei dati
- **Ogni affermazione non banale dalla tesi cita la posizione**: `(§4.2, Tab. 14, r.812)` e, se serve, il riferimento bibliografico `[[01-bao-2020|1]]` (numero della tesi). Usa `tesi_loc` delle pagine come localizzatore; i numeri di riga riferiscono `raw/tesi.md`. Cita anche la pagina wiki da cui hai preso l'informazione.
+- **Ogni affermazione non banale dalla tesi indica la posizione** in forma breve, `(§4.2, Tab. 14)`, e se serve il riferimento bibliografico col numero della tesi, `[1]`. Per ritrovare il dato usa `tesi_loc` e i numeri di riga di `raw/tesi.md` **solo internamente**: non vanno stampati (vedi «Cosa mostrare nella risposta»).
 - **Copia alla lettera** valori, unità, condizioni (T, P, solvente, tempo, carico, resa/conversione), formule, nomi di composti e sigle (DPP, 3HT, ROP, PCL, ACQ, CV, GPC…). Non convertire, arrotondare o riassumere dati sperimentali. Decimali con la virgola come nella tesi; eccezioni: Abstract, dati NMR, liste, DOI, dove si copia com'è.
 - Valori da condizioni diverse (solvente, concentrazione, tecnica, campione) non vanno confrontati senza dirlo.
 - **Difetti noti** (hub `wiki/analyses/difetti-noti.md`): se un dato su cui ti basi ne ha uno, segnalalo e non correggerlo. Esempi: PDI di 3b (Tab. 9) incoerente con Mw/Mn; % DPP di 3c (35 vs 36); bandgap delle Conclusioni (3,42-4,30 eV) incoerente con Tab. 14; correlazione «lineare» (r.1228) vs «non lineare con plateau» (Conclusioni, §4.4.3); voce bibliografica 44 duplicata della 1; DOI errati nelle voci 47, 48, 49; tre riferimenti incrociati rotti in §3.3.
- **Procedure sperimentali (cap. 3):** riporta i dati necessari alla domanda con rimando a paragrafo e righe; non riscrivere l'intera procedura salvo richiesta esplicita.
+- **Procedure sperimentali (cap. 3):** riporta i dati necessari alla domanda con rimando al paragrafo (§); non riscrivere l'intera procedura salvo richiesta esplicita.
 - **Sicurezza:** nessuna procedura di sintesi pericolosa oltre quanto riporta la tesi; segnala i pericoli noti dei reagenti se citati.
 - Mai inventare dati, fonti, numeri di figura/tabella o citazioni. Se non sai, dillo.
@@ -53,6 +53,7 @@ flowchart LR
 CLAUDE.md                schema di consultazione (regole RAG)
 AGENTS.md  GEMINI.md     puntatori a CLAUDE.md per Codex, Antigravity, Gemini CLI
 .agents/skills/          tesi-query, tesi-figure, tesi-dati, tesi-fonti, tesi-narrate
                         (tesi-query/references/: protocollo di retrieval, mappa, ricette di ricerca, checklist)
 .claude/skills           link simbolico a .agents/skills (per Claude Code)
 index.md   log.md        catalogo delle pagine e registro delle modifiche
 raw/                     tesi.md, immagini/, immagini.json, bibliografia.json, fonti/, riassunto
@@ -64,7 +65,7 @@ scripts/                 gen_figures.py, gen_bibliografia.py, lint.py
 ## Come si usa
-1. Clona il repository e aprilo con un agente a riga di comando: **Claude Code**, **Codex** o **Antigravity CLI**. Skill e file di schema (`CLAUDE.md`, `AGENTS.md`) vengono trovati da soli. Obsidian è facoltativo, serve solo per sfogliare la wiki.
+1. Clona il repository e aprilo con un agente a riga di comando (**Claude Code**, **Codex** o **Antigravity CLI**) oppure con il frontend grafico [agent-wiki-ui](#interfaccia-grafica-agent-wiki-ui). Skill e file di schema (`CLAUDE.md`, `AGENTS.md`) vengono trovati da soli. Obsidian è facoltativo, serve solo per sfogliare la wiki.
 2. Fai una domanda in italiano, per esempio:
   - «Perché il PCL evita l'ACQ allo stato solido?»
   - «Confronta il band gap elettrochimico dei campioni bottle brush e mostrami i voltammogrammi.»
@@ -74,6 +75,45 @@ scripts/                 gen_figures.py, gen_bibliografia.py, lint.py
 La wiki è usata **in sola lettura**: l'agente non la modifica salvo richiesta esplicita. Lo schema di manutenzione (ingest, riallineamento, lint) resta nella cronologia git di `CLAUDE.md`, fino al commit `eb672df`.
 ## Interfaccia grafica (agent-wiki-ui)
 Per interrogare la wiki senza terminale si può usare **[agent-wiki-ui](https://santantonio.sytes.net/davide/agent-wiki-ui.git)** come frontend: un eseguibile C# (.NET 10, Windows e Linux) con una chat in stile claude.ai, che lancia **Claude Code** (`claude -p`) o **Codex** (`codex exec`) nella cartella in cui si trova l'eseguibile. _Antigravity non è ancora supportato dal frontend._
 ```mermaid
 flowchart LR
    U["Utente<br/>chat della GUI"] -->|"domanda"| G["agent-wiki-ui<br/>nella radice del repo"]
    G -->|"claude -p / codex exec"| E["Motore<br/>Claude Code o Codex"]
    E -->|"legge schema e skill"| S["CLAUDE.md / AGENTS.md<br/>.agents/skills/"]
    E -->|"consulta"| W["wiki/ e raw/"]
    E -->|"risposta in Markdown<br/>con immagini"| G
    G -->|"testo e figure"| U
    classDef fonte fill:#dbeafe,stroke:#1e40af,color:#111
    classDef wiki fill:#dcfce7,stroke:#166534,color:#111
    classDef regole fill:#fef9c3,stroke:#854d0e,color:#111
    classDef agente fill:#fce7f3,stroke:#9d174d,color:#111
    classDef script fill:#e5e7eb,stroke:#374151,color:#111
    class U,E agente
    class G script
    class S regole
    class W wiki
 ```
 _Il frontend è un semplice contenitore: non ha logica propria sulla wiki. Passa la domanda al motore, che lavora nella radice del repo e quindi trova da solo schema, skill e wiki, poi mostra la risposta._
 **Come configurarlo**
 1. **Motore.** Installa e autentica `claude` e/o `codex` nel PATH (guida: `docs/INSTALL.md` nel [repository del frontend](https://santantonio.sytes.net/davide/agent-wiki-ui.git)).
 2. **Eseguibile.** Ottienilo dal repository del frontend (serve il .NET SDK 10 per compilarlo: `scripts/publish.sh` su Linux/macOS/WSL, `scripts/publish.ps1` su Windows; risultato in `dist/<sistema>/agent-wiki-ui[.exe]`).
 3. **Posizione.** Copia l'eseguibile **nella radice di questo repository**, accanto a `CLAUDE.md` e `AGENTS.md`. È fondamentale: il motore parte nella cartella dell'eseguibile, non in quella da cui lo avvii. Gli eseguibili in radice sono ignorati da git.
 4. **Avvio.** Doppio clic (Windows) o `./agent-wiki-ui` (Linux, serve X11 o XWayland). Senza argomenti si apre la chat; con argomenti funziona da riga di comando (`./agent-wiki-ui "domanda"`, `--engine codex` per Codex).
 **Cose da sapere**
 - **Modello e effort.** All'avvio e a ogni cambio di motore il frontend sceglie il modello più piccolo ed effort `low`, per risposte rapide ed economiche. Per le risposte **approfondite e complete** che questo schema richiede, scegli nel riquadro **Impostazioni** un modello più capace e un effort più alto. Le impostazioni non sono salvate su disco: vanno ripetute a ogni avvio.
 - **Figure.** Le risposte incorporano le immagini con `![descrizione](raw/immagini/<hash>.<ext>)`: il frontend le mostra se il file è locale e leggibile (png, jpg, gif, webp, bmp; fino a 20 MB). Gli URL web non vengono caricati.
 - **Sola lettura.** Il frontend lancia Codex con sandbox in sola lettura; Claude Code parte senza bypass dei permessi. Coerente con la wiki usata in sola lettura.
 - **Chat.** Una chat usa un solo motore; cambiare motore apre una nuova chat. Le conversazioni sono salvate su disco e l'ultima si riapre all'avvio. La risposta compare a fine generazione (nessuno streaming).
 - **Stato del frontend.** È un MVP dichiarato tale nel suo repository: i test automatici sono ancora da scrivere e la GUI non è provata su Windows nativo.
 - **Non verificato qui.** Non ho provato l'insieme frontend e questo repo: né l'avvio, né che Codex riesca a guardare le immagini in sola lettura.
 ## Come è costruito
 _Il diagramma segue il materiale dal documento originale alla wiki, in quattro passi da sinistra a destra._
@@ -133,7 +173,7 @@ flowchart LR
 Solo la didascalia stampata è testo della tesi; il resto deriva dall'immagine e **non è verificato**. _Non è registrato nel repository quale modello abbia prodotto descrizioni e revisione._
-**Uso nelle risposte.** L'agente arriva alla figura dai link nelle pagine già lette, da `figure-indice.md` o cercando per composto o concetto nelle schede. Poi apre il file in `raw/immagini/` e lo guarda davvero, perché la sola descrizione generata non basta a spiegare un grafico; infine lo commenta (cosa guardare e perché) citando percorso e scheda `[[fig-NNN]]`. I valori letti da un grafico vanno confermati sulla tesi. Regole complete in [`tesi-figure`](.agents/skills/tesi-figure/SKILL.md).
+**Uso nelle risposte.** L'agente arriva alla figura dai link nelle pagine già lette, da `figure-indice.md` o cercando per composto o concetto nelle schede. Poi apre il file in `raw/immagini/` e lo guarda davvero, perché la sola descrizione generata non basta a spiegare un grafico; infine la incorpora nella risposta come immagine e la commenta (cosa guardare e perché), senza stampare percorsi o nomi di schede. I valori letti da un grafico vanno confermati sulla tesi. Regole complete in [`tesi-figure`](.agents/skills/tesi-figure/SKILL.md).
 ## Come risponde a una domanda
@@ -169,7 +209,7 @@ Esempio illustrativo (non è una risposta registrata) con la domanda «Perché i
 | 4 | Trova la figura pertinente, apre il file in `raw/immagini/` e ne descrive il contenuto. |
 | 5 | Spiega prima ciò che dice la tesi, con citazioni, poi il meccanismo con la conoscenza generale marcata. |
- **Prima la tesi, poi l'integrazione.** I dati vengono dalla wiki e dalla tesi, con posizione (`§4.2, Tab. 14, r.812`) e riferimento bibliografico. La conoscenza generale del modello spiega perché e come, ed è marcata _(conoscenza generale)_; le deduzioni sono _(inferenza)_.
+- **Prima la tesi, poi l'integrazione.** I dati vengono dalla wiki e dalla tesi, con la posizione in forma breve (`§4.2, Tab. 14`) e il riferimento bibliografico. Link e nomi di pagine della wiki, percorsi e numeri di riga restano interni e non compaiono nel testo. La conoscenza generale del modello spiega perché e come, ed è marcata _(conoscenza generale)_; le deduzioni sono _(inferenza)_.
 - **Perimetro.** L'integrazione resta dentro gli argomenti della tesi; fuori perimetro l'agente dice che la tesi non li tratta.
 - **Fedeltà dei dati.** Valori, unità e condizioni copiati alla lettera; valori di condizioni diverse non sono confrontati senza avviso.
Author	SHA1	Message	Date
davideandClaude Sonnet 5.5	533f735155	Skill di consultazione: protocollo di retrieval, mappa, ricette e checklist; regole su lingua, completezza, figure e tabelle Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>	2026-10-20 15:53:24 +02:00
davideandClaude Sonnet 5.5	07d25de49c	Risposte senza riferimenti wiki; regole di coerenza e posizione delle immagini Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>	2026-10-20 15:00:23 +02:00
davideandClaude Sonnet 5.5	8785d7429d	README: uso con il frontend agent-wiki-ui; figure incorporate come immagini Markdown Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>	2026-10-20 14:43:40 +02:00