Se hai usato un assistente di coding AI di recente, probabilmente hai notato qualcosa: vogliono tutti un file Markdown.

GitHub Copilot legge .github/copilot-instructions.md. Cursor legge .cursor/rules/. Claude Code legge CLAUDE.md. Windsurf legge .windsurf/rules. Jules di Google legge JULES.md. E lo standard universale? AGENTS.md --- ora usato da oltre 60.000 repository open source e custodito dalla Linux Foundation’s Agentic AI Foundation.

Markdown è passato da formato di documentazione a sistema operativo per gli agenti di coding AI.

Cos’è AGENTS.md?

AGENTS.md è un file Markdown semplice in formato aperto che vive nel tuo repository e agisce come un briefing per gli agenti di coding AI. Pensalo come il corrispettivo di README.md:

README.md è per gli esseri umani: avvio rapido, descrizioni del progetto, badge
AGENTS.md è per gli agenti AI: passaggi di build, comandi di test, convenzioni di codice, decisioni architetturali

L’agente legge il file più vicino nell’albero delle directory, quindi quello più vicino ha la precedenza. Ogni sottoprogetto può fornire istruzioni personalizzate.

Cos’è CLAUDE.md?

CLAUDE.md è specificamente per Claude Code di Anthropic. Viene letto automaticamente all’inizio di ogni sessione e contiene le istruzioni specifiche del progetto che altrimenti dovresti ripetere in ogni prompt.

Un buon CLAUDE.md tipicamente include:

Contesto del progetto: Una riga di orientamento per Claude su cosa fa il progetto
Stile del codice: Le tue preferenze di formattazione, convenzioni di denominazione, pattern da seguire
Comandi: Come eseguire test, build, lint e deploy
Note sull’architettura: Decisioni chiave che Claude dovrebbe rispettare

L’approccio consigliato: metti le istruzioni condivise in AGENTS.md (così tutti gli strumenti AI ne beneficiano), poi aggiungi funzionalità specifiche di Claude in CLAUDE.md.

Il Panorama Completo dei File di Istruzioni AI

Ecco ogni strumento principale di coding AI e la sua convenzione Markdown:

Strumento	File	Formato
GitHub Copilot	`.github/copilot-instructions.md`	Markdown
Cursor	`.cursor/rules/*.md`	Markdown
Claude Code	`CLAUDE.md`	Markdown
Windsurf	`.windsurf/rules`	Markdown
Google Jules	`JULES.md`	Markdown
Universale	`AGENTS.md`	Markdown

Noti il pattern? È tutto Markdown. Tutti quanti.

Perché Markdown Ha Vinto

Markdown è il formato perfetto per i file di istruzioni AI perché:

Gli LLM lo capiscono nativamente --- è il formato più comune nei loro dati di addestramento
È leggibile dall’uomo --- gli sviluppatori possono rivedere e modificare le istruzioni facilmente
È versionabile --- vive in git insieme al tuo codice
È leggero --- nessun overhead di parsing, nessun tooling speciale necessario
È universale --- funziona con ogni strumento AI, editor e piattaforma

Come ha detto Visual Studio Magazine: nell’AI agentiale, si tratta tutto di Markdown.

Best Practice per Scrivere Istruzioni per gli Agenti

Basandosi sull’analisi di migliaia di repository:

Inizia con il minimo. Aggiungi regole solo quando noti che l’agente fa ripetutamente lo stesso errore. Le istruzioni troppo specificate possono confondere più che aiutare.

Sii specifico sui comandi. Non dire “esegui i test” --- di’ pnpm test o pytest -x tests/.

Documenta la tua architettura. Se il tuo progetto usa un pattern specifico (come il message passing tra un content script e un service worker), spiegalo. L’agente non può inferire le decisioni architetturali dal solo codice.

Includi cosa NON fare. Le istruzioni negative sono sorprendentemente efficaci: “Non modificare mai direttamente lo schema del database” o “Non usare class component, usa sempre gli hook.”

Come Save Si Inserisce in Questo Mondo

Se stai costruendo file di istruzioni per agenti, probabilmente stai anche salvando materiale di riferimento dal web: pagine di documentazione, risposte di Stack Overflow, README di GitHub, riferimenti API.

Save converte qualsiasi di queste fonti web in Markdown pulito con un clic --- perfetto per costruire il contesto di cui hanno bisogno i tuoi agenti AI. Salva una pagina di documentazione, incolla il Markdown nel tuo AGENTS.md o nei documenti di riferimento, e il tuo assistente di coding AI ha immediatamente il contesto di cui ha bisogno.

Il flusso di lavoro:

Trova documentazione utile o esempi di codice sul web
Clicca Save per convertire in Markdown
Fai riferimento o includi nei file di istruzioni per gli agenti
Il tuo assistente di coding AI funziona meglio con ogni salvataggio

Il Futuro: Markdown come Superficie di Controllo dell’AI

Microsoft e GitHub stanno ora trattando Markdown come una superficie di controllo stabile e verificabile per il comportamento dell’AI. Non è più solo documentazione --- è l’interfaccia tra l’intento umano e l’esecuzione AI.

Stiamo vedendo i file Markdown servire tre ruoli distinti:

Documentazione: Spiega un sistema agli esseri umani
Istruzione: Vincola e guida il comportamento dell’AI
Skill: Raggruppa istruzioni con risorse così gli agenti possono ripetere i flussi di lavoro

Questa tendenza sta solo accelerando. Man mano che gli assistenti di coding AI diventano più capaci, i file Markdown che li guidano diventano più importanti.

Save converte qualsiasi pagina web in Markdown pulito con un clic. Perfetto per costruire librerie di riferimento, catturare documentazione e creare contesto per i tuoi flussi di lavoro di coding AI. Prova Save gratuitamente.