Da README.md a PROGRAM.md: il Markdown è Ora un Linguaggio di Programmazione
Per 22 anni, il Markdown è stato un formato di documentazione. Scrivevi README, post del blog e note. Spiegava cose agli esseri umani.
Poi qualcosa è cambiato. Nel 2024, gli assistenti AI di codifica hanno iniziato a leggere .cursorrules e copilot-instructions.md. Nel 2025, AGENTS.md è emerso come standard universale. All’inizio del 2026, Andrej Karpathy ha rilasciato autoresearch, dove l’intera contribuzione umana è un file Markdown chiamato program.md.
L’evoluzione è chiara:
| Era | File | Pubblico | Scopo |
|---|---|---|---|
| 2004-2023 | README.md | Esseri umani | Documentazione |
| 2024 | .cursorrules | Strumenti AI di codifica | Regole dello stile del codice |
| 2025 | AGENTS.md | Agenti AI di codifica | Istruzioni del progetto |
| 2026 | program.md | Agenti autonomi | Programmi di ricerca |
Il Markdown non è solo documentazione. È un linguaggio di programmazione per l’AI.
Le Tre Generazioni
Generazione 1: Documentazione (README.md)
Il caso d’uso originale del Markdown. Scrivi un README per aiutare gli esseri umani a comprendere il tuo progetto. È passivo — rimane lì finché un essere umano non lo legge. Nessuna macchina agisce su di esso.
Generazione 2: Configurazione (AGENTS.md, CLAUDE.md)
Gli assistenti AI di codifica hanno bisogno del contesto del progetto. AGENTS.md gli dice i tuoi comandi di build, le convenzioni di codifica e le decisioni architetturali. CLAUDE.md personalizza il comportamento di Claude Code. Questi file sono attivi — un’AI li legge e cambia il proprio comportamento di conseguenza.
Ma l’essere umano scrive ancora il codice. Il file Markdown aiuta semplicemente l’AI ad assistere meglio.
Generazione 3: Programmazione (program.md)
Con autoresearch, l’essere umano non scrive alcun codice. L’intera contribuzione è program.md — un file Markdown che definisce obiettivi di ricerca, vincoli e strategie. L’agente AI lo legge e poi scrive, esegue e itera autonomamente sul codice per ore o giorni.
Questo è il Markdown come linguaggio di programmazione. L’output non è testo formattato — è codice in esecuzione, risultati sperimentali e scoperte scientifiche.
Perché il Markdown?
Perché ogni sistema AI ha convergito sul Markdown invece di, diciamo, YAML, JSON o un DSL personalizzato?
È nei dati di addestramento. Gli LLM hanno visto miliardi di file Markdown durante l’addestramento. Comprendono profondamente le sue convenzioni — le intestazioni indicano la gerarchia, i punti elenco indicano le liste, i blocchi di codice indicano il contenuto eseguibile.
È flessibile. Il Markdown non impone uno schema rigido. Puoi scrivere istruzioni a testo libero, tabelle strutturate, esempi di codice e linguaggio naturale nello stesso file. Questa flessibilità corrisponde al modo in cui gli esseri umani pensano di dirigere gli agenti AI.
È verificabile. Puoi leggere un program.md e capire esattamente cosa viene detto all’agente. Prova con un config YAML da 500 righe.
È versioning-friendly. Ogni modifica alle istruzioni del tuo agente è un commit git. Puoi fare diff, revisionare e ripristinare le modifiche al comportamento dell’agente proprio come le modifiche al codice.
Cosa Significa per Te
Se il Markdown sta diventando un linguaggio di programmazione, allora chiunque scriva Markdown sta diventando in qualche modo un programmatore. La skill non è la sintassi — è la chiarezza di pensiero e la precisione delle istruzioni.
Ecco cosa conta ora:
Impara a scrivere istruzioni Markdown precise. Migliore è il tuo AGENTS.md o program.md, migliori le prestazioni del tuo agente AI. Questa è una nuova abilità che combina conoscenza tecnica con scrittura chiara.
Costruisci una libreria di riferimento in Markdown. Quando scrivi istruzioni per agenti AI, hai bisogno di materiale di riferimento: documentazione, esempi, paper, best practice. Avere questo materiale in formato Markdown pulito lo rende immediatamente utilizzabile.
Comprendi l’ecosistema AI Markdown. Conosci la differenza tra AGENTS.md, CLAUDE.md, llms.txt e program.md. Ognuno serve a uno scopo diverso nello stack Markdown-per-AI in crescita.
Catturare Conoscenza per le Istruzioni degli Agenti
Scrivere buone istruzioni per agenti AI richiede conoscenza. Devi comprendere il dominio, gli strumenti, i vincoli e gli obiettivi. Molta di questa conoscenza vive sul web — in pagine di documentazione, post del blog, paper di ricerca e tutorial.
Save converte ognuna di queste fonti web in Markdown pulito con un clic. Quando crei un program.md o AGENTS.md, avere il tuo materiale di riferimento già in Markdown significa che puoi estrarne parti, fare riferimento ad esso e costruire immediatamente sopra.
I ricercatori che scrivono i migliori file program.md non partono da zero. Stanno costruendo su conoscenza che hanno catturato e organizzato in formato Markdown.
Save converte qualsiasi pagina web in Markdown pulito — perfetto per costruire la libreria di riferimento di cui hai bisogno per scrivere istruzioni efficaci per agenti AI. Prova Save gratuitamente.
## Continue reading
Come Scrivere un Buon program.md: Una Guida Pratica per le Istruzioni agli Agenti AI
program.md è il file che programma gli agenti AI nell'autoresearch di Karpathy. Ecco come scriverne uno che ottiene risultati --- con struttura, esempi e best practice.
Autoresearch & PROGRAM.md di Karpathy: AI che Esegue Esperimenti Mentre Dormi
L'autoresearch di Andrej Karpathy permette agli agenti AI di eseguire 100+ esperimenti ML durante la notte, guidati da un singolo file Markdown chiamato program.md. Ecco come funziona e perché è importante.
Il Vibe Coding è Morto. Benvenuti all'Agentic Engineering con Markdown.
Karpathy dice che il vibe coding è passato di moda. Il nuovo paradigma è l'agentic engineering, dove orchestri gli agenti AI attraverso file Markdown invece di scrivere codice tu stesso.
AGENTS.md & CLAUDE.md: Il Nuovo README per gli Agenti di Coding AI
Scopri come i file AGENTS.md e CLAUDE.md guidano gli assistenti di coding AI come GitHub Copilot, Cursor e Claude Code. Più come scrivere file di istruzioni efficaci per gli agenti nei tuoi progetti.
Written by
Jean-Sébastien Wallez
I've been making internet products for 10+ years. Built Save on weekends because I wanted my own reading library in clean markdown for Claude and Obsidian. Write here about web clipping, AI workflows, and the small things that make a personal knowledge base actually useful.