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-019.md

@@ -0,0 +1,33 @@
+# DD-019 — Il branch dei commit lo decide l'utente
+
+**Data:** 4 settembre 2026  
+**Stato:** Accettata — sostituisce [DD-003](DD-003.md)
+
+**Contesto**  
+DD-003 prevedeva di lavorare su `develop` e portare su `main` solo dopo i test. Nella pratica
+è successo il contrario: `main` è arrivato a 43 commit di vantaggio su `develop`, che è rimasto
+fermo. Una regola che nessuno segue è peggio di nessuna regola, perché rende inaffidabile tutto
+il resto del documento — e con più assistenti AI in gioco il rischio vero non era il branch
+sbagliato, ma un agente che committa o pusha per conto suo.
+
+**Decisione**  
+È l'utente a dire su quale branch va un commit. L'assistente può **consigliare** un branch
+dedicato quando la modifica è rischiosa o parallela ad altro lavoro, ma non cambia branch, non
+committa, non fa push e non apre PR di propria iniziativa. In assenza di indicazioni si lavora
+dove si trova il repository, di fatto `main`.
+
+**Alternative scartate**
+
+- Tenere DD-003 e riallineare `develop` → si sarebbe rotta di nuovo alla prima fretta.
+- Dismettere `develop` → si perderebbero le preview Vercel, utili quando servono davvero.
+
+**Conseguenze**
+
+- `main` è insieme produzione e branch di lavoro: ogni commit deve lasciare l'app funzionante,
+  quindi la rete di sicurezza sono i test (vedi DD-020), non il branch.
+- `develop` esiste ancora ma è indietro: la sua preview Vercel non rappresenta lo stato attuale
+  finché non viene riallineata.
+
+**Riesame**  
+Se il team cresce oltre una persona che scrive codice, o se un lavoro lungo ha bisogno di stare
+fuori produzione per più di qualche giorno.