Add docs/ with architecture, content model, frontend reference

Require CLAUDE.md changes to keep docs/ in sync with new features
or architecture.

CLAUDE.md

@@ -112,6 +112,14 @@ Rotte: `/`, `/blog`, `/blog/[slug]`, `/category/[slug]`.
 
 Il riferimento Hostinger è solo ispirazione visiva. Non copiare codice o asset.
 
+## Documentazione
+
+`docs/` descrive struttura e comportamento del repo (architettura, content model, frontend) a un
+livello più approfondito di questo file. Se implementi nuove funzionalità, endpoint, content type
+o cambi l'architettura (nuovo servizio, nuova rotta Caddy, nuovo modo di scambiare dati tra
+frontend e CMS), **aggiorna il file `docs/*.md` pertinente nello stesso commit**, o creane uno
+nuovo se non esiste una sezione adatta. Non lasciare `docs/` disallineata col codice.
+
 ## Priorità
 
 Correttezza e integrità dati → sicurezza → semplicità → SEO/a11y → performance.
@@ -133,5 +141,6 @@ built-in Strapi al reimplementare funzioni CMS in Nuxt.
 ## Prima di dichiarare completo
 
 Lint → test → typecheck → build dell'app toccata, con gli script del `package.json` relativo.
-Non affermare che un check è passato se non l'hai eseguito. Chiudi riassumendo cosa è cambiato e
-quali rischi restano aperti.
+Non affermare che un check è passato se non l'hai eseguito. Se hai toccato architettura o
+funzionalità, verifica di aver aggiornato `docs/` (vedi [Documentazione](#documentazione)). Chiudi
+riassumendo cosa è cambiato e quali rischi restano aperti.