leggenda-del-regolo/CLAUDE.md

# La Leggenda del Regolo — note per Claude

Avventura grafica punta-e-clicca nello spirito delle avventure LucasArts, ambientata a San Piero a Sieve (Mugello)
nel 2007, durante il Palio della Fortezza. Protagonista: Andrea (l'utente), che nel 2007 ha 27 anni (è nato nel 1980). Tono comico con nostalgia.

**Il gioco è dedicato al Lele**, l'amico di Andrea che gli fece conoscere Monkey Island e che è scomparso troppo
presto. Trattare questo tema con delicatezza; come e quanto farlo comparire nel gioco lo decide Andrea.

Il documento di progetto è `docs/PROGETTO.md`: leggerlo prima di tutto, insieme a `docs/STATO.md` (dove siamo arrivati, cosa manca). Le parti segnate **[DA ANDREA]** aspettano
i suoi ricordi: non inventare persone, luoghi o fatti del paese al posto suoi; proporre, poi chiedere.

## Preferenze di lavoro (dalla collaborazione su Manzolo Rush)

- Rispondere in italiano. La shell è zsh.
- Il progetto gemello è `../ManzoloGame/` (Manzolo Rush): riusarne strumenti e metodi invece di reinventarli
  (`tools/slice_sprites.py`, `scripts/build-site.sh`, `scripts/bump.sh`, `scripts/check-public.sh`, action di Pages).
- Nessun build step: ES modules statici, server locale con `python3 -m http.server`.
- Ogni funzionalità con il suo test; un test automatico percorre tutta la soluzione dell'avventura.
- Verifica visiva nel browser con Playwright e swiftshader prima di dichiarare finito qualcosa di grafico.
- Pubblicare (tag/bump/push) solo quando Andrea lo chiede.
- Persone vere nel gioco solo con consenso; niente nomi, personaggi o musiche di giochi esistenti.
- Prompt delle immagini in `prompts/` e fogli grezzi in `assets/raw/`: esclusi da git.
- Sfondi nuovi: li genera **Codex** con il suo strumento immagini integrato, gratis e senza chiave API
  (`codex exec`, ricetta in `docs/GENERAZIONE_SFONDI.md`, «Generare con Codex»). Si lancia da qui, senza chiedere la chiave ad Andrea.
- **Pubblicare (dal 2026-11-01)**: origin è https://git.manzolo.it/manzolo/leggenda-del-regolo, pubblico: prima `make check-public`, poi `git push origin main --tags`, solo se Andrea lo chiede.
  `make deploy` costruisce l'immagine dal tag della versione, la spinge su `git.manzolo.it/manzolo/leggenda-regolo:vX.Y.Z` (e `:latest`); sul VPS il compose fissa quel tag e fa `docker compose pull && up -d`.
  Per tornare indietro: sul VPS (`Workspaces/docker/leggenda-regolo/docker-compose.yml`) si rimette il tag precedente e si rifà pull e up.
  Hook pre-push (`make hooks`, una volta per clone) lancia check-public; le Gitea Actions (`.gitea/workflows/test.yml`: test, e release sui tag) girano sul runner del PC, che si crea o riavvia con `make runner`.