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>
This commit is contained in:
davideandClaude Sonnet 5.5 committed 2026-10-20 15:53:24 +02:00
1 parent 07d25de49c
commit 533f735155
11 files changed
+254 -67

No files matched your search

+20 -22
View File
@@ -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)
1. Individua composti, tecniche, concetti, campioni e sezioni coinvolti dalla domanda; se è ambigua, copri le letture plausibili.
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.
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.
4. Per un valore, una tabella o una procedura apri `raw/tesi.md` alle righe di `tesi_loc` e copia il dato esatto.
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`.
File di supporto in `references/` (leggili quando servono, non a memoria):
- `protocollo-retrieval.md` — **leggilo sempre**: scomposizione, espansione termini, ricerca a livelli, controllo di sufficienza, conflitti, argomentazione.
- `mappa-argomenti.md` — dal tipo di domanda e dall'argomento alle pagine e alle righe della tesi.
- `ricette-ricerca.md` — comandi grep/sed pronti.
- `checklist-risposta.md` — controllo finale prima di inviare.
## 2. Immagini
Se la domanda riguarda strutture, schemi, meccanismi, spettri, grafici o morfologia, applica la skill **tesi-figure** (le immagini vanno inserite solo se coerenti con il testo e nel punto in cui se ne discute il contenuto): trova le figure, **guardale** (apri il file in `raw/immagini/`), spiegale e cita il percorso.
## 3. Sintesi e integrazione
- 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).
- **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.
- 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.
- Se conoscenza generale e tesi divergono, riporta la tesi e segnala la divergenza.
## Procedura (sintesi; i dettagli sono nel protocollo)
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. **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.
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**.
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.
6. **Controlla** con `references/checklist-risposta.md`.
## 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 una sintesi dei punti chiave.
## Citazioni e dati
- **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)`, e i riferimenti bibliografici col solo numero, es. `[1]`. Le figure compaiono come immagine incorporata, senza ripetere il percorso come testo. Vedi «Cosa mostrare nella risposta» in `CLAUDE.md`.
- **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.
- Procedure del cap. 3: riporta solo i dati utili con rimando a paragrafo e righe.
- 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 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.