davideandClaude Sonnet 5.5
9c6a679e6a
MVP.md descrive ora la GUI Avalonia al posto di WinForms/WebView2 e il protocollo pagina-C# sparisce. ADR-0001 passa ad Accettata con l'esito delle verifiche (renderer markdown proprio, perché Markdown.Avalonia è per Avalonia 11). Il nome ha un'unica sorgente in docs/README.md, con la checklist di rinomina e la migrazione della cartella dati. README e CLAUDE.md seguono la nuova struttura Core/Gui e i due publish single-file. 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 |
| MVP.md | Specifica funzionale, design UI/UX, criteri di accettazione |
| 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 il codice: ADR (se c'è una scelta architetturale) → MVP → ROADMAP → README → codice → CLAUDE.md.
- 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 | Proposta |