File di regole: AGENTS.md, CLAUDE.md, .cursorrules

Un file di regole è memoria di progetto versionata. Serve a evitare che ogni sessione con l’AI riparta da zero: comandi, vincoli, stile, confini e divieti vivono nella repo, non nella chat.

Perché questa lezione conta

Se ripeti spesso “non aggiungere dipendenze”, “usa rg”, “non cambiare routing”, “il deploy è statico”, allora quella informazione non appartiene al singolo prompt. Appartiene al progetto.

Il file di regole è utile quando:

• lavori con agenti che leggono la repo;
• più persone usano strumenti AI sullo stesso codice;
• ci sono vincoli di deploy o sicurezza;
• il progetto ha comandi e convenzioni precise;
• vuoi ridurre correzioni ripetitive.

Cosa mettere

Un buon file contiene solo regole ad alto valore:

# Istruzioni progetto

- Usa `rg` per cercare testo e file.
- Esegui `npm run build` prima di chiudere modifiche Astro.
- Mantieni output statico compatibile con LiteSpeed.
- Non aggiungere dipendenze senza motivazione esplicita.
- I contenuti corso vivono in `src/content/lezioni`.
- Non cambiare slug o redirect esistenti senza richiesta.

Ogni regola deve guidare un comportamento reale.

Cosa non mettere

Evita:

• segreti;
• token;
• credenziali;
• regole ovvie;
• istruzioni contraddittorie;
• preferenze personali non verificabili;
• muri di testo che nessuno leggerà.

Un file troppo lungo smette di funzionare: l’agente lo ignora o lo interpreta male.

Quando aggiornarlo

Aggiorna il file quando emerge un errore ripetuto:

• l’agente installa dipendenze inutili;
• modifica file fuori scope;
• dimentica un comando di build;
• ignora un vincolo di deploy;
• usa uno stile non coerente.

Non aggiornarlo per ogni preferenza del momento. Deve contenere regole stabili.

Laboratorio guidato

Scrivi un file di regole per un tuo repo con massimo 20 voci.

Dividilo in:

• comandi;
• struttura;
• stile;
• test/build;
• deploy;
• sicurezza;
• divieti.

Poi usalo in un prompt agentico:

Leggi le istruzioni di progetto e applicale.
Prima di modificare file, riassumi i vincoli rilevanti per questo task.

Output atteso

Un file AGENTS.md o equivalente pronto per essere committato.

Checklist di verifica

• il file contiene regole verificabili;
• non contiene segreti;
• è abbastanza corto da essere letto;
• distingue comandi, vincoli e divieti;
• riduce istruzioni ripetute nei prompt.

Errori comuni

Scrivere un manifesto. Un agente ha bisogno di istruzioni operative, non di filosofia.

Mettere regole instabili. Se cambia ogni giorno, non è regola di progetto.

Non versionare il file. Se guida il lavoro del team, deve stare in Git.

Collegamenti

• Modulo: Contesto e memoria nel progetto — lezione 21 del corso.
• Lezione precedente: Prompt per test e documentazione.
• Prossima lezione: RAG per sviluppatori: quando serve davvero.