davideandClaude Sonnet 5.5
c4c1ad4520
Introduce docs/adr con ADR-0001 (GUI in solo C# con Avalonia per Windows e Linux) e ADR-0002 (Codex e Antigravity oltre a Claude Code), entrambi in stato Proposta. Aggiunge docs/README.md come indice unico con regole SSOT e checklist di rinomina, perché il nome del progetto non è ancora deciso. La roadmap ha la nuova Fase 5 e la Fase 4 ora contiene solo i passi, con le motivazioni spostate negli ADR. 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 è provvisorio (oggi LlmRun) e non è ancora deciso. Questa sezione è l'unica sorgente: gli altri doc scrivono "l'app" o <nome-app>.
Se il nome cambia, aggiornare solo questi punti:
AssemblyName/nome del csproj e dell'eseguibile (<nome-app>.exe,<nome-app>)- Costante del nome nel codice (titolo finestra, intestazione della barra laterale, cartella dati)
- Cartella dati
<LocalApplicationData>/<nome-app>/chats: cambiando nome le chat salvate non si trovano più; migrare o leggere anche la vecchia cartella - 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 | Proposta |
| 0002 | Più motori CLI (Claude Code, Codex, Antigravity) su Windows e Linux | Proposta |