Ogni strumento AI per la programmazione vuole un file Markdown con le regole del tuo progetto. Ma vogliono tutti un file Markdown diverso.

Se stai usando più strumenti AI (e la maggior parte degli sviluppatori lo fa), questo diventa confuso rapidamente. Ecco la guida definitiva su quali file ti servono e cosa inserire in ciascuno.

I File a Colpo d’Occhio

File	Strumento	Posizione	Scope
`AGENTS.md`	Universale (tutti gli strumenti)	Radice del progetto	Regole condivise per tutti gli agenti AI
`CLAUDE.md`	Claude Code	Radice del progetto	Istruzioni specifiche per Claude
`.cursor/rules/*.md`	Cursor	Directory `.cursor/rules/`	Regole specifiche per Cursor
`.github/copilot-instructions.md`	GitHub Copilot	Directory `.github/`	Istruzioni specifiche per Copilot
`.windsurf/rules`	Windsurf	Directory `.windsurf/`	Regole specifiche per Windsurf
`JULES.md`	Google Jules	Radice del progetto	Istruzioni specifiche per Jules

AGENTS.md: Lo Standard Universale

Ideale per: Team che usano più strumenti AI, progetti open-source

AGENTS.md è la cosa più vicina a uno standard universale che abbiamo. Ora viene usato da oltre 60.000 repository ed è gestito dalla Linux Foundation’s Agentic AI Foundation (insieme a MCP e goose).

Metti qui le istruzioni condivise --- cose che ogni strumento AI dovrebbe sapere:

Struttura del progetto e architettura
Comandi di build e test
Convenzioni di stile del codice
Pattern comuni e anti-pattern
Dipendenze e passaggi di configurazione

Ogni strumento AI principale leggerà AGENTS.md, rendendolo l’unica fonte di verità per le istruzioni AI del tuo progetto.

CLAUDE.md: La Memoria di Claude Code

Ideale per: Utenti di Claude Code, team che si standardizzano su Anthropic

CLAUDE.md viene letto automaticamente all’inizio di ogni sessione di Claude Code. Supporta alcune funzionalità specifiche di Claude come la persistenza della memoria e il contesto della sessione.

Usa CLAUDE.md per:

Personalizzazioni comportamentali specifiche per Claude
Funzionalità che solo Claude Code supporta
Sovrascrivere o estendere AGENTS.md per Claude

Il pattern consigliato: regole condivise in AGENTS.md, aggiunte specifiche per Claude in CLAUDE.md.

.cursorrules / .cursor/rules/: L’Approccio di Cursor

Ideale per: Utenti di Cursor, team che usano Cursor come IDE principale

Cursor originariamente usava un singolo file .cursorrules, poi si è evoluto a una directory .cursor/rules/ per un controllo più granulare. Ogni file nella directory è una regola separata che Cursor applica.

Usa le regole Cursor per:

Comportamento dell’agente specifico per Cursor
Regole per le modalità Composer e Agent di Cursor
Istruzioni specifiche per tipo di file (es. regole diverse per .tsx vs .py)

copilot-instructions.md: La Convenzione di GitHub

Ideale per: Utenti di GitHub Copilot, flussi di lavoro centrati su GitHub

GitHub Copilot legge .github/copilot-instructions.md per istruzioni a livello di progetto. Segue la convenzione di GitHub di mettere la configurazione nella directory .github/.

La Configurazione Consigliata

Per la maggior parte dei progetti, hai bisogno al massimo di due file:

Se usi un solo strumento AI:

Usa semplicemente il file nativo di quello strumento (CLAUDE.md per Claude Code, .cursor/rules/ per Cursor, ecc.).

Se usi più strumenti AI:

AGENTS.md --- tutte le regole condivise (architettura, comandi di build, convenzioni)
File specifico per lo strumento --- solo per funzionalità uniche a quello strumento

Struttura di esempio:

your-project/
  AGENTS.md              # Condiviso: comandi di build, architettura, convenzioni
  CLAUDE.md              # Specifico per Claude: preferenze di memoria, utilizzo degli strumenti
  .cursor/rules/style.md # Specifico per Cursor: comportamento del composer
  .github/copilot-instructions.md  # Specifico per Copilot

Cosa Includere nelle Tue Regole

Basandosi sull’analisi di migliaia di repository, i file di istruzioni più efficaci includono:

Includi sempre:

Come costruire ed eseguire il progetto
Come eseguire i test
Decisioni architetturali chiave
Preferenze di stile del codice

Spesso utile:

Cosa NON fare (le istruzioni negative funzionano sorprendentemente bene)
Spiegazioni della struttura dei file
Passaggi comuni di debug
Comandi di gestione delle dipendenze

Evita:

Funzionalità ovvie del linguaggio
Cose che l’AI già conosce
Regole eccessivamente dettagliate (inizia minimo, aggiungi secondo necessità)

Costruire le Tue Regole AI con Contesto Web

Scrivere buoni file di istruzioni AI spesso richiede di fare riferimento a documentazione esterna, guide di stile o pattern architetturali. È qui che avere contenuti web in formato Markdown aiuta.

Ad esempio, se il tuo progetto segue un pattern API specifico da una pagina di documentazione, puoi:

Usa Save per convertire quella pagina di documentazione in Markdown
Fai riferimento o estrai le sezioni rilevanti nel tuo AGENTS.md
Il tuo assistente AI per la programmazione ora ha il contesto completo

Lo stesso vale per la documentazione dei framework, le guide di stile, gli articoli sulle best practice e le soluzioni di Stack Overflow. Il Markdown pulito è il formato con cui sia tu che i tuoi strumenti AI potete lavorare più efficacemente.

Il Punto Chiave

L’ecosistema delle regole AI per la programmazione è ancora in evoluzione, ma il pattern è chiaro: è tutto Markdown. Che tu usi uno strumento o cinque, le istruzioni AI del tuo progetto vivono in file Markdown che sono sotto controllo di versione, leggibili dagli umani e parsabili dalle macchine.

Inizia con AGENTS.md per le regole universali, aggiungi file specifici per strumento secondo necessità, e mantieni tutto minimale fino a quando non vedi un problema ricorrente che vale la pena risolvere.

Save converte qualsiasi pagina web in Markdown pulito --- perfetto per costruire il materiale di riferimento e il contesto di documentazione di cui i tuoi assistenti AI per la programmazione hanno bisogno. Prova Save gratis.