davideandClaude Sonnet 5.5
f0e9fcfba5
Aggiunge docs/PROJECT_STATE.md: stadio MVP, stato per area, criteri di accettazione con verifica manuale e automatica, debiti noti (soprattutto i test), tabella degli ADR e proposta di cosa manca per chiudere l'MVP. Collegato da indice dei doc, README, ROADMAP e CLAUDE.md, che chiede di aggiornarlo a ogni cambio di stadio, funzione, ADR o debito. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Documentazione
Indice e regole. Ogni informazione vive in un solo documento; gli altri la richiamano con un link.
| Documento | Contenuto (sorgente di verità per…) |
|---|---|
| ../README.md | Uso, requisiti, build e publish |
| PROJECT_STATE.md | Stato del progetto a colpo d'occhio: stadio (MVP), stato per area, debiti, decisioni, cosa manca per chiudere l'MVP |
| MVP.md | Specifica funzionale, design UI/UX, criteri di accettazione |
| INSTALL.md | Come installare e autenticare i motori (Claude Code, Codex), verifica e problemi comuni |
| TESTING.md | Piano dei test: regola "nuova funzione = nuovi test", soglie di copertura, matrice requisito → test |
| ROADMAP.md | Fasi e stato (spunte); solo passi, mai motivazioni |
adr/NNNN-*.md |
Decisioni architetturali e loro motivazioni (indice sotto) |
| ../CLAUDE.md | Guida per Claude Code: comandi, architettura del codice, vincoli |
Nome del progetto
Il nome è agent-wiki-ui (prima LlmRun). Questa sezione è l'unica sorgente: gli altri doc scrivono "l'app" o <nome-app>.
Se il nome cambia di nuovo, aggiornare solo questi punti:
AssemblyNamein ../agent-wiki-ui.csproj (e il nome del file csproj): da lì il codice legge il nome (Core/AppInfo.cs) per titolo finestra, intestazione della barra laterale e cartella dati; l'eseguibile diventa<nome-app>.exe/<nome-app>RootNamespacee namespace C# (AgentWikiUi.*, anche inx:Classexmlnsdei file.axaml): il nome del namespace non può avere trattini- Cartella dati
<LocalApplicationData>/<nome-app>/chats: cambiando nome le chat salvate non si trovano più.ChatStoresposta una vecchia cartella (LlmRun) in quella nuova al primo avvio; per un nuovo cambio aggiungere il nome precedente all'elencoLegacyNames - Titolo di ../README.md e riga iniziale di ../CLAUDE.md (nome del csproj nei comandi)
Flusso (doc-first, doc-as-code)
- Prima i doc, poi i test, poi il codice: ADR (se c'è una scelta architetturale) → MVP → matrice in TESTING.md → test → codice → ROADMAP → PROJECT_STATE → README → CLAUDE.md. Nessuna funzione è finita senza test che la coprono, nello stesso commit.
- I doc stanno nel repo e cambiano con lo stesso commit del codice a cui si riferiscono.
- Una modifica non deve lasciare i doc disallineati.
Regole degli ADR
- Un file per decisione,
adr/NNNN-titolo-breve.md, numerazione progressiva. - Stati:
Proposta→Accettata→ eventualmenteSostituita da ADR-NNNNoRifiutata. - Un ADR accettato non si riscrive: se la decisione cambia se ne scrive uno nuovo che lo sostituisce e si aggiorna lo stato del vecchio.
- Sezioni: Contesto, Criteri, Opzioni, Decisione, Conseguenze, Da verificare, Riferimenti.
Indice ADR
| ADR | Titolo | Stato |
|---|---|---|
| 0001 | GUI multipiattaforma in solo C# con Avalonia | Accettata |
| 0002 | Più motori CLI (Claude Code, Codex, Antigravity) su Windows e Linux | Accettata (Claude Code, Codex) |
| 0003 | Strategia di test e regola "nuova funzione = nuovi test" | Proposta |
| 0004 | Aggiornamento dei CLI dalle Impostazioni | Proposta |
| 0005 | Windows: eseguibile senza finestra di console | Proposta |