0 Fork 0

Files

T

davideandClaude Sonnet 5.5 c50bd63723 Documentazione: compatibilità con Codex e interruttore CLI

ADR-0002 passa ad Accettata per Claude Code e Codex con l'esito delle prove
reali: id di sessione da thread.started, output JSONL, risposta = ultimo
agent_message, ripresa senza -s e sola lettura via sandbox_mode, -- prima del
prompt. MVP, ROADMAP, INSTALL e README descrivono l'interruttore CLI, la
nuova opzione --engine e il problema del modello predefinito che richiede un
Codex più recente. TESTING.md aggiunge le righe CX, EN e ST-12.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

2026-10-15 11:40:47 +02:00

3.1 KiB

Raw Blame History

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
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:

AssemblyName in ../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>
RootNamespace e namespace C# (AgentWikiUi.*, anche in x:Class e xmlns dei 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ù. ChatStore sposta una vecchia cartella (LlmRun) in quella nuova al primo avvio; per un nuovo cambio aggiungere il nome precedente all'elenco LegacyNames
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 → 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 → eventualmente Sostituita da ADR-NNNN o Rifiutata.
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

3.1 KiB Raw Blame History