ADR-0007: schema di una wiki interrogabile con immagini; documentazione generale

- Nuovo ADR-0007: convenzione in tre parti (indice con gli id delle figure,
  catalogo JSON con campi minimi, istruzioni solo-query) e ripartizione dei
  compiti tra wiki, motore e app. Nessuna cartella o formato imposti dall'app.
- ADR-0006, README, ROADMAP, PROJECT_STATE, TESTING: esempi resi generici
  (nessun riferimento a una wiki specifica) e nota sull'assenza di uno standard.
- Test delle immagini con struttura e testi neutri.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
davideandClaude Sonnet 5.5 committed 2026-10-15 16:11:00 +02:00
1 parent 5870de6fda
commit f2086de31d
8 files changed
+98 -27

No files matched your search

+10 -6
View File
@@ -62,14 +62,18 @@ Verificato: da Linux/WSL entrambi gli eseguibili; da Windows nativo (PowerShell
- I motori (`claude`, `codex`) devono essere installati e nel PATH dello stesso sistema: vedi [docs/INSTALL.md](docs/INSTALL.md).
## Immagini nelle risposte (wiki con catalogo di figure)
Se la risposta contiene `![didascalia](percorso)` e il file esiste, la chat mostra l'immagine; altrimenti compare il testo `[didascalia]`. Gli URL `http(s)` non si scaricano. Un percorso relativo si cerca nella cartella dell'eseguibile e poi in quelle superiori, quindi funziona con una **wiki** come `cyber-tesi`:
Non esiste (ancora) uno standard per cartella e catalogo delle immagini: la struttura qui sotto è solo un **esempio** e può cambiare. L'app non la conosce: mostra il file indicato dal percorso scritto nella risposta, ovunque stia.
Se la risposta contiene `![didascalia](percorso)` e il file esiste, la chat mostra l'immagine; altrimenti compare il testo `[didascalia]`. Gli URL `http(s)` non si scaricano. Un percorso relativo si cerca nella cartella dell'eseguibile e poi in quelle superiori, quindi funziona con una **wiki** (cartella di pagine markdown con un indice, un catalogo delle figure e le immagini) anche se l'eseguibile sta in una sottocartella dedicata alle sole query:
```
cyber-tesi/ radice del progetto, con CLAUDE.md (le istruzioni per il motore)
raw/immagini.json catalogo: metadati di ogni figura (file, didascalia, posizione, avvertenze)
raw/immagini/<file>.jpg cartella delle immagini
agent-wiki-ui/agent-wiki-ui l'eseguibile (il motore parte qui e legge il CLAUDE.md della cartella superiore)
<wiki>/ radice del progetto, con CLAUDE.md (schema completo della wiki)
index.md indice delle pagine, con gli id delle figure di ogni pagina
<catalogo-figure>.json catalogo: metadati di ogni figura (file, didascalia, posizione, avvertenze)
<cartella-immagini>/<file> le immagini
query/CLAUDE.md istruzioni solo-query (sola lettura, instradamento per indici, regole per le figure)
query/agent-wiki-ui l'eseguibile, da avviare da qui: il motore legge sia query/CLAUDE.md sia quello della radice
```
Il catalogo lo legge il motore, non l'app: nel `CLAUDE.md` si chiede di trovare la figura nel catalogo e di citarla con un percorso relativo alla radice, per esempio `![Figura 1](raw/immagini/<file>.jpg)`, con sotto la didascalia, la posizione e il link alla nota della figura. L'app mostra l'immagine e lascia la didascalia come testo markdown. Dettagli: [ADR-0006](docs/adr/0006-immagini-nel-markdown.md).
Il catalogo lo legge il motore, non l'app: il `CLAUDE.md` chiede di trovare la figura nel catalogo e di citarla con un percorso relativo alla radice (`![Figura 1](<cartella-immagini>/<file>)`), con sotto la didascalia, la posizione e il link alla nota della figura. L'app mostra l'immagine e lascia la didascalia come testo markdown. Dettagli: [ADR-0006](docs/adr/0006-immagini-nel-markdown.md). Per preparare una wiki alle query (indice con la mappa delle figure, catalogo, istruzioni solo-query) c'è una convenzione, [ADR-0007](docs/adr/0007-schema-wiki-per-query-con-immagini.md),.
## Piattaforme
Windows e Linux con lo stesso codice ([ADR-0001](docs/adr/0001-gui-multipiattaforma-avalonia.md)). Motori supportati: Claude Code e Codex CLI, già installati da terminale; Antigravity CLI è pianificato: [ADR-0002](docs/adr/0002-motori-cli-claude-codex-antigravity.md).