AGENTS.mdAGENTS.md: dove si trova e come lo leggono gli strumenti
AGENTS.md è un file Markdown semplice con le istruzioni del progetto, che la maggior parte degli agenti di coding legge senza configurazioni aggiuntive. OpenAI lo ha presentato alla Agentic AI Foundation della Linux Foundation e viene usato da oltre 60k progetti open source.
Dove si trova
- AGENTS.md nella root del repository, per l'intero progetto.
- File AGENTS.md annidati in sottodirectory o pacchetti: gli agenti usano quello più vicino nella gerarchia.
- OpenAI Codex: un file globale ~/.codex/AGENTS.override.md oppure, se è vuoto o non esiste, ~/.codex/AGENTS.md.
- Cline: un file globale ~/.agents/AGENTS.md.
- Claude Code accetta anche .claude/AGENTS.md.
Formato
Markdown semplice, senza frontmatter né campi obbligatori; puoi usare qualsiasi intestazione. Il formato non prevede limiti di dimensione, ma OpenAI Codex smette di leggere al raggiungimento di project_doc_max_bytes, che per impostazione predefinita è 32 KiB.
# Acme web app
Customer-facing web app with an admin area and a REST API.
## Commands
- Install: `pnpm install`
- Test: `pnpm test`
- Lint and type-check: `pnpm lint && pnpm tsc --noEmit`
## Code style
- TypeScript strict mode; no `any` in new code.
- Keep database access in `src/db/`.
## Never
- Never commit secrets or .env files.
- Never edit files under `src/generated/` by hand.
Priorità e unione
Prevale il file AGENTS.md più vicino a quello da modificare; un'istruzione esplicita in chat prevale su qualsiasi file. OpenAI Codex concatena un file per ogni directory, dalla root del progetto fino alla directory di lavoro: i file più vicini vengono quindi aggiunti per ultimi e hanno la precedenza. Per impostazione predefinita, Claude Code ignora AGENTS.md se è presente CLAUDE.md.
Strumenti che lo leggono
| Strumento | Supporto |
|---|---|
| OpenAI Codex | Supporto nativo. Legge un file globale, poi al massimo un file per directory dalla root alla directory di lavoro, fino a 32 KiB per impostazione predefinita. |
| Claude Code | Supporto nativo dalla v2.1.277, ma solo se non esistono CLAUDE.md o CLAUDE.local.md, a meno che non sia impostato claude-md-and-agents-md. |
| Cursor | Supporto nativo per file nella root e annidati; i file annidati si combinano con quelli delle directory superiori e prevale quello più specifico. |
| GitHub Copilot (cloud agent, code review, VS Code) | Supporto nativo in qualsiasi punto del repository; prevale il file più vicino. |
| Devin Desktop (formerly Windsurf) | Supporto nativo. Il file nella root è sempre attivo; un file in una sottodirectory si applica alla directory corrispondente. |
| Cline | Supporto nativo, oltre al file globale ~/.agents/AGENTS.md; puoi attivarlo o disattivarlo nel pannello Rules. |
| Gemini CLI | Opt-in: aggiungi AGENTS.md a context.fileName in .gemini/settings.json. |
| Aider | Opt-in: aggiungi read: AGENTS.md a .aider.conf.yml. |
| OpenClaw | Supporto nativo come file obbligatorio con le istruzioni operative nell'area di lavoro dell'agente. |
| Listed on agents.md (not individually re-verified) | Uno dei 23 strumenti nell'elenco di agents.md, tra cui Amp, Jules, Zed, Warp, goose, opencode e JetBrains Junie; non li abbiamo verificati singolarmente. |
Suggerimenti
- Vuoi rinominare un vecchio AGENT.md? agents.md suggerisce di eseguire mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md per mantenere funzionanti entrambi i nomi.
- Elenca i comandi per test e lint: gli agenti provano a eseguire i controlli indicati e a correggere gli errori prima di terminare.
- In un monorepo, aggiungi un breve AGENTS.md per ogni pacchetto invece di allungare il file nella root.
- In OpenAI Codex, AGENTS.override.md ha la precedenza su AGENTS.md nella stessa directory.
Genera un AGENTS.md e i file di regole corrispondenti per cinque strumenti partendo da un unico modulo. Apri il generatore di AGENTS.md →