AGENTS.md e gli agenti di codice: il nuovo strumentario dello sviluppatore
Nel 2026, gli agenti di codice passano dall'autocompletamento al compagno di squadra. Il file AGENTS.md si è imposto come lo standard aperto per dar loro il contesto di un progetto. Perché conta.
Dall'autocompletamento all'agente
In pochi anni, l'assistenza al codice ha cambiato natura: dal suggerimento riga per riga, siamo passati ad agenti capaci di leggere un'intera base di codice, lanciare test, aprire una pull request. Il problema non è più «generare codice», ma dare all'agente il contesto giusto — comandi di build, convenzioni, architettura.
AGENTS.md: uno standard aperto, in Markdown
È esattamente ciò che risolve AGENTS.md: un semplice file Markdown, alla radice del progetto, che spiega a qualsiasi agente come lavorare qui — comandi di build e di test, stile del codice, framework, decisioni di architettura. Nessuno schema imposto, nessuno strumento da installare: ogni agente che lo legge ne beneficia immediatamente.
Il formato è stato formalizzato ad agosto 2025, poi donato all'Agentic AI Foundation della Linux Foundation a dicembre 2025. Alla fine del 2025, oltre 60.000 progetti open source lo avevano adottato, e più di venti strumenti lo supportano — GitHub Copilot (supporto nativo da agosto 2025), OpenAI Codex, Cursor, Gemini e Jules, Windsurf, Zed, e altri. Segno dei tempi: Next.js 16.2 genera ora un AGENTS.md in create-next-app.
Perché è più di una moda
Un agente senza contesto riscopre il progetto ogni volta: indovina i comandi, ignora le tue convenzioni, produce codice da rilavorare. Un AGENTS.md ben scritto elimina questa fase di scoperta: il codice generato rispetta i tuoi standard fin dall'inizio, e i viaggi di andata e ritorno della revisione si riducono.
È, in fondo, la stessa idea di una buona documentazione di onboarding — solo che qui il nuovo arrivato è una macchina che legge in fretta e non dimentica nulla.
La mia posizione
Lo dico spesso: l'IA fa parte dei miei strumenti, non delle mie fondamenta. Un agente ben attrezzato accelera la ricerca, la prototipazione, i compiti meccanici. Ma è lo sviluppatore a scrivere l'AGENTS.md, a decidere l'architettura, a rivedere e validare. Lo strumento non sostituisce il giudizio: lo amplifica.
Un agente vale quanto vale il contesto che gli dai. AGENTS.md è quel contesto, versionato con il codice.