Files
davideandClaude Sonnet 5.5 f2086de31d 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>
2026-10-15 16:11:00 +02:00

4.9 KiB

Stato del progetto

Stadio: MVP (prima di una versione 1.0). Ultimo aggiornamento: 2026-10-15. Questo documento è la fotografia dello stato, non la fonte di dettagli: i passi sono in ROADMAP.md, i requisiti in MVP.md, le decisioni negli ADR (indice in README.md), i test in TESTING.md. Qui si legge a colpo d'occhio dove siamo; per il resto si segue il collegamento.

In una frase

agent-wiki-ui è un eseguibile C# (.NET 10) per Windows e Linux che inoltra prompt a Claude Code e Codex già installati, da riga di comando o da una GUI di chat. La parte funzionale dell'MVP c'è; mancano i test automatici e alcune verifiche su macchine reali.

Stato per area

Area Stato Note
CLI (agent-wiki-ui "prompt", --engine) Funzionante Exit code e 127 provati su Linux; su Windows l'exit code arriva solo se il chiamante attende il processo (ADR-0005).
GUI di chat (Avalonia) Funzionante Barra laterale, cronologia su disco, markdown, tema chiaro/scuro, Impostazioni. Provata con screenshot headless e su WSLg; non su Windows nativo.
Motori Claude Code e Codex Una chat = un motore; sessione di Codex letta dall'output. Antigravity non iniziato (ADR-0002).
Aggiornamento dei CLI Funzionante, non provato in reale Controllo preventivo e pulsante evidenziato; l'update vero non è mai stato lanciato dall'app (ADR-0004).
Eseguibili standalone Funzionanti win-x64 e linux-x64 creati da entrambi i sistemi con scripts/publish.sh / .ps1 (circa 47 MB). Windows senza console al doppio clic.
Test automatici Non iniziati Piano e matrice pronti (ADR-0003); nessun test scritto. Vedi debiti.
Documentazione Allineata al codice Doc-first; ogni funzione ha le righe della matrice in TESTING.md.

Criteri di accettazione dell'MVP

Da MVP.md. Restano non spuntati finché non hanno test automatici (regola di TESTING.md).

Criterio Verifica a mano Test automatico
claude parte nella cartella dell'exe Sì: Linux e Windows (da C:\Windows il motore vede la cartella dell'exe) No (CL-04)
Output in streaming nella CLI Output ereditato dal motore; non misurato No (CL-08)
Exit code propagato Linux sì; Windows solo con attesa del processo No (CL-06)
Prompt con virgolette e spazi intatto Sì, con un claude finto su Linux No (CL-01)

Debiti noti

  • Test automatici assenti (Fase 6): contraddice la regola "nuova funzione = nuovi test" per tutto il codice scritto finora. È il debito principale.
  • Verifiche su macchine reali: GUI su Windows nativo e su una distribuzione Linux pulita; doppio clic senza console e riaggancio al terminale (ADR-0005); tema che segue il sistema su Linux; update reale dei CLI.
  • Impostazioni non salvate su disco: modello, effort e motore tornano ai valori iniziali a ogni avvio (si parte dal modello più piccolo con effort low).
  • Nessuno streaming nella GUI: la risposta compare a fine generazione.
  • Elenchi dei modelli fissi (Claude Code e Codex): da aggiornare a mano; il "modello più piccolo" di Codex è un'assunzione (GPT-5.6 Luna).

Decisioni

ADR Stato
0001 GUI Avalonia multipiattaforma Accettata
0002 Più motori CLI Accettata (Claude Code, Codex)
0003 Strategia di test Proposta
0004 Aggiornamento dei CLI Proposta
0005 Windows senza console Proposta
0006 Immagini nel markdown (solo file locali) Proposta (implementata, test verdi)
0007 Schema di una wiki interrogabile, con immagini Proposta (solo documentazione; nessun codice)

Per chiudere l'MVP

Proposta, derivata dai punti aperti sopra; da confermare.

  1. Test automatici per Core/ e MainViewModel e per i quattro criteri di accettazione (Fase 6, prime righe di CL, ST, VM, CX).
  2. Gli ADR 0003, 0004 e 0005 passati ad "Accettata" dopo le loro verifiche.
  3. GUI provata su Windows nativo e su Linux pulito.
  4. Criteri di accettazione di MVP.md spuntati.

Oltre l'MVP (non bloccanti): Antigravity, impostazioni persistite, streaming nella GUI, rinomina e ricerca delle chat, CI con matrice Windows e Linux, firma dell'eseguibile Windows.

Come tenere aggiornato questo file

Si aggiorna nello stesso commit di ogni cambio di stadio, di funzione, di ADR o di debito: stato per area, criteri, debiti, tabella delle decisioni, data. Se una riga qui contraddice ROADMAP.md o un ADR, vale quello e questa pagina va corretta.