Riorganizza la documentazione per l'uso con assistenti AI

- Spezza il registro delle decisioni in docs/decisions/DD-XXX.md, con indice
- Ripulisce DATABASE.md dalla storia delle migration e aggiunge la sezione Lettura
- Riduce PROJECT_STATE.md a una pagina; la procedura di allestimento passa in OPERATIONS.md
- Aggiunge OPERATIONS.md, GLOSSARIO.md, trappole note e checklist in ARCHITECTURE.md
- Sintetizza la copertura test di badge.md e documenta docs/archive
- Allinea AGENTS.md, README.md e la regola Cursor (tolto l'obbligo di develop, in contrasto con DD-019)

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

docs/decisions/DD-022.md

@@ -0,0 +1,32 @@
+# DD-022 — L'app è solo chiara
+
+**Data:** 5 settembre 2026  
+**Stato:** Accettata
+
+**Contesto**  
+`styles.css` conteneva un blocco `.dark` completo che non veniva mai applicato: nessun
+interruttore, nessun `prefers-color-scheme`. Peggio, era incoerente. In `.dark` l'accento
+diventava grigio-blu — il rosso del brand spariva — e mancavano del tutto `--success`,
+`--warning`, `--info`, `--training`, i metalli dei badge, i due gradienti e le due ombre. Un
+terzo stato: presente, sbagliato, morto.
+
+**Decisione**  
+CrAPP è un'app solo chiara. Il blocco `.dark` è rimosso e `:root` dichiara
+`color-scheme: light`, così anche i controlli nativi restano coerenti.
+
+**Alternative scartate**
+
+- Completare il tema scuro → è lavoro vero (gradienti, ombre, i due colori dei metalli, le
+  superfici traslucide) per una richiesta che nessuno ha fatto.
+- Lasciare il blocco lì «per dopo» → un tema mai attivato non si accorge di rompersi.
+
+**Conseguenze**
+
+- Chi riaprirà il tema scuro parte da zero, ma da zero onesto: la palette chiara ha ora
+  contrasti verificati e i token con suffisso `-testo` per i colori che come testo non
+  reggono.
+- La barra di stato (`theme-color`) e lo splash del manifest sono allineati al fondo chiaro.
+
+**Riesame**  
+Se arriva una richiesta reale dalla squadra, o se si gioca in palestre al buio abbastanza
+spesso da rendere il tema scuro una funzione e non un vezzo.