AGENTS.md

OpenAI ha lanciato AGENTS.md nell'agosto 2025 e, il 9 dicembre 2025, lo ha conferito all'Agentic AI Foundation, un fondo diretto dalla Linux Foundation cofondato con Anthropic e Block. A quella data più di 60.000 progetti open source avevano adottato il formato, insieme a framework di agenti tra cui Cursor, Devin, GitHub Copilot, Gemini CLI e VS Code. Ciò che viene governato è un file Markdown che veicola istruzioni specifiche del progetto: convenzioni di codice, passaggi di build, requisiti di test.

Jude Gao di Vercel ha misurato cosa procura quel file. Le API di Next.js 16 assenti dai dati di addestramento del modello producevano codice scorretto nel 47% dei casi. Gli skills che impacchettavano la stessa conoscenza restavano non invocati nel 56% delle esecuzioni di valutazione, lasciando il tasso di successo al livello base del 53%, e raggiungevano solo il 79% quando le istruzioni forzavano il trigger. Un AGENTS.md statico iniettato nel system prompt a ogni turno ha ottenuto il 100% su build, lint e test. Vercel ha poi compresso 40 KB di documentazione in un indice di 8 KB delimitato da pipe senza perdere quel punteggio, perché il contesto passivo consuma la finestra a ogni interazione.

Addy Osmani inquadra il file come un problema di razionamento. Secondo il ratchet principle, ogni riga deve poter essere ricondotta a un fallimento concreto del passato; il tetto fissato da HumanLayer è sotto le 60 righe, una checklist da pilota più che una guida di stile.

Bill Staples di GitLab distingue il file Markdown dal registro governabile. Contesto, identità, policy, provenienza e memoria organizzativa devono persistere attraverso modelli e agenti, il che per lui indica un control plane piuttosto che un file nel repository.