CLAUDE.md

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Progetto

LlmRun: eseguibile C# (.NET 10, Windows) che invoca Claude Code (`claude -p`) da terminale. Senza argomenti apre una GUI WinForms, con argomenti funziona da CLI. Non è un repo git.

## Workflow doc-first (obbligatorio)

- Specifica e criteri di accettazione: [docs/MVP.md](docs/MVP.md). Fasi e stato: [docs/ROADMAP.md](docs/ROADMAP.md). Uso: [README.md](README.md).
- Ad ogni richiesta di modifica: aggiornare prima i doc interessati (MVP.md, ROADMAP.md con le spunte, README.md se cambia l'uso), poi il codice, poi questo file se cambiano comandi, design o vincoli. Nessuna modifica deve lasciare i doc disallineati.

## Comandi

- Build: `dotnet build` (LlmRun.csproj, net10.0-windows, WinForms)
- GUI: `dotnet run`; CLI: `dotnet run -- "prompt"`
- Publish single-file: `dotnet publish -c Release -r win-x64 --self-contained -p:PublishSingleFile=true`
- Test: non esistono ancora.

## Architettura

- [Program.cs](Program.cs): top-level statements. Senza argomenti avvia `Gui`; con argomenti è la CLI (`claude -p <prompt>` con `ArgumentList`, stdout/stderr ereditati, exit code propagato, 127 se `claude` non è nel PATH).
- [Gui.cs](Gui.cs): chat WinForms. WebView2 (conversazione, in alto) + pannello in basso (menu modello/effort, "Nuova chat", input, Invia). Ogni messaggio lancia `claude -p` con stdout/stderr rediretti; la risposta è convertita da markdown a HTML con Markdig (`DisableHtml`) e la pagina viene rigenerata per intero con `NavigateToString`. Contesto tra messaggi: `--session-id <guid>` al primo, `--resume <guid>` poi. `--model`/`--effort` omessi se "predefinito". Lista modelli hardcoded in `Gui.Models`, da aggiornare quando escono nuovi modelli.
- Dipendenze NuGet (solo GUI): Markdig, Microsoft.Web.WebView2.

## Vincoli non ovvi

- La working directory di `claude` deve essere la cartella dell'exe: usare `AppContext.BaseDirectory`, mai `Environment.CurrentDirectory` né `Assembly.Location` (vuoto in single-file).
- Lo stdin di `claude` va redirezionato e chiuso subito, altrimenti aspetta 3s.
- `claude` è un .exe nativo (`~/.local/bin`), avviabile direttamente. Se fosse `claude.cmd` serve `cmd.exe /c`.
- La logica di avvio processo è duplicata tra CLI (`Program.cs`) e GUI (`Gui.cs`): se cambia (cartella di lavoro, stdin, flag), modificarla in entrambi i punti.
- La GUI non mostra link né HTML della risposta nella finestra: i link `http(s)` vanno aperti nel browser di sistema.
- La GUI deve girare su un thread STA (creato a mano in `Program.cs`, perché i top-level statements non hanno `[STAThread]`): senza, WebView2 fallisce con `RPC_E_CHANGED_MODE`.

## Skill del repo

`.claude/settings.json` abilita il plugin `ui-ux-pro-max` (marketplace `nextlevelbuilder/ui-ux-pro-max-skill`). Usarlo per le modifiche alla GUI WinForms (layout, usabilità, accessibilità).

## Commit

Messaggi di commit in italiano: titolo breve all'indicativo o in forma nominale, eventuale corpo che spiega il perché. Mantenere la riga finale `Co-Authored-By` prevista dall'ambiente. Fare commit solo su richiesta.
Commit iniziale 2026-10-08 11:29:42 +02:00			`# CLAUDE.md`

			`This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.`

MVP LlmRun: CLI/GUI che lancia claude -p nella cartella dell'exe, con docs 2026-10-08 11:50:57 +02:00			`## Progetto`
Commit iniziale 2026-10-08 11:29:42 +02:00
MVP LlmRun: CLI/GUI che lancia claude -p nella cartella dell'exe, con docs 2026-10-08 11:50:57 +02:00			LlmRun: eseguibile C# (.NET 10, Windows) che invoca Claude Code (`claude -p`) da terminale. Senza argomenti apre una GUI WinForms, con argomenti funziona da CLI. Non è un repo git.
Commit iniziale 2026-10-08 11:29:42 +02:00
MVP LlmRun: CLI/GUI che lancia claude -p nella cartella dell'exe, con docs 2026-10-08 11:50:57 +02:00			`## Workflow doc-first (obbligatorio)`
Commit iniziale 2026-10-08 11:29:42 +02:00
MVP LlmRun: CLI/GUI che lancia claude -p nella cartella dell'exe, con docs 2026-10-08 11:50:57 +02:00			`- Specifica e criteri di accettazione: [docs/MVP.md](docs/MVP.md). Fasi e stato: [docs/ROADMAP.md](docs/ROADMAP.md). Uso: [README.md](README.md).`
			`- Ad ogni richiesta di modifica: aggiornare prima i doc interessati (MVP.md, ROADMAP.md con le spunte, README.md se cambia l'uso), poi il codice, poi questo file se cambiano comandi, design o vincoli. Nessuna modifica deve lasciare i doc disallineati.`
Commit iniziale 2026-10-08 11:29:42 +02:00
MVP LlmRun: CLI/GUI che lancia claude -p nella cartella dell'exe, con docs 2026-10-08 11:50:57 +02:00			`## Comandi`
Commit iniziale 2026-10-08 11:29:42 +02:00
MVP LlmRun: CLI/GUI che lancia claude -p nella cartella dell'exe, con docs 2026-10-08 11:50:57 +02:00			- Build: `dotnet build` (LlmRun.csproj, net10.0-windows, WinForms)
			- GUI: `dotnet run`; CLI: `dotnet run -- "prompt"`
Commit iniziale 2026-10-08 11:29:42 +02:00			- Publish single-file: `dotnet publish -c Release -r win-x64 --self-contained -p:PublishSingleFile=true`
MVP LlmRun: CLI/GUI che lancia claude -p nella cartella dell'exe, con docs 2026-10-08 11:50:57 +02:00			`- Test: non esistono ancora.`
Commit iniziale 2026-10-08 11:29:42 +02:00
MVP LlmRun: CLI/GUI che lancia claude -p nella cartella dell'exe, con docs 2026-10-08 11:50:57 +02:00			`## Architettura`
Commit iniziale 2026-10-08 11:29:42 +02:00
GUI a chat con rendering markdown, sessioni e correzione del thread STA 2026-10-08 12:23:32 +02:00			- [Program.cs](Program.cs): top-level statements. Senza argomenti avvia `Gui`; con argomenti è la CLI (`claude -p <prompt>` con `ArgumentList`, stdout/stderr ereditati, exit code propagato, 127 se `claude` non è nel PATH).
			- [Gui.cs](Gui.cs): chat WinForms. WebView2 (conversazione, in alto) + pannello in basso (menu modello/effort, "Nuova chat", input, Invia). Ogni messaggio lancia `claude -p` con stdout/stderr rediretti; la risposta è convertita da markdown a HTML con Markdig (`DisableHtml`) e la pagina viene rigenerata per intero con `NavigateToString`. Contesto tra messaggi: `--session-id <guid>` al primo, `--resume <guid>` poi. `--model`/`--effort` omessi se "predefinito". Lista modelli hardcoded in `Gui.Models`, da aggiornare quando escono nuovi modelli.
			`- Dipendenze NuGet (solo GUI): Markdig, Microsoft.Web.WebView2.`
MVP LlmRun: CLI/GUI che lancia claude -p nella cartella dell'exe, con docs 2026-10-08 11:50:57 +02:00
			`## Vincoli non ovvi`

			- La working directory di `claude` deve essere la cartella dell'exe: usare `AppContext.BaseDirectory`, mai `Environment.CurrentDirectory` né `Assembly.Location` (vuoto in single-file).
			- Lo stdin di `claude` va redirezionato e chiuso subito, altrimenti aspetta 3s.
			- `claude` è un .exe nativo (`~/.local/bin`), avviabile direttamente. Se fosse `claude.cmd` serve `cmd.exe /c`.
GUI a chat con rendering markdown, sessioni e correzione del thread STA 2026-10-08 12:23:32 +02:00			- La logica di avvio processo è duplicata tra CLI (`Program.cs`) e GUI (`Gui.cs`): se cambia (cartella di lavoro, stdin, flag), modificarla in entrambi i punti.
			- La GUI non mostra link né HTML della risposta nella finestra: i link `http(s)` vanno aperti nel browser di sistema.
			- La GUI deve girare su un thread STA (creato a mano in `Program.cs`, perché i top-level statements non hanno `[STAThread]`): senza, WebView2 fallisce con `RPC_E_CHANGED_MODE`.
Abilita plugin ui-ux-pro-max per il repo 2026-10-08 12:17:57 +02:00
			`## Skill del repo`

			`.claude/settings.json` abilita il plugin `ui-ux-pro-max` (marketplace `nextlevelbuilder/ui-ux-pro-max-skill`). Usarlo per le modifiche alla GUI WinForms (layout, usabilità, accessibilità).
Aggiunge a CLAUDE.md la regola dei commit in italiano 2026-10-08 12:24:03 +02:00
			`## Commit`

			Messaggi di commit in italiano: titolo breve all'indicativo o in forma nominale, eventuale corpo che spiega il perché. Mantenere la riga finale `Co-Authored-By` prevista dall'ambiente. Fare commit solo su richiesta.