Generatore AGENTS.md
Compila un modulo per ottenere un AGENTS.md con i tuoi comandi, le convenzioni e i limiti invalicabili. Otterrai anche la stessa regola associata a un percorso, adattata a Cursor, GitHub Copilot, Claude Code, Cline e Devin Desktop, oltre a file ponte per gli strumenti che non rilevano AGENTS.md per impostazione predefinita.
Dove cerca ogni strumento i propri file di istruzioni →
# App web Acme
Un'app web per i clienti, con un'area di amministrazione e una piccola API REST.
## Stack
Next.js, React, TypeScript, pnpm
## Comandi
- Installazione: `pnpm install`
- Esegui in locale: `pnpm dev`
- Test: `pnpm test`
- Lint e verifica dei tipi: `pnpm lint && pnpm tsc --noEmit`
- Build: `pnpm build`
## Stile del codice
- Segui la formattazione imposta dal linter e lascia invariati i file che non modifichi.
- Preferisci funzioni brevi, con input e output chiari; limita gli effetti collaterali ai margini del sistema.
- Chiedi prima di aggiungere una nuova dipendenza.
- Commenta il motivo del codice non ovvio, non spiegare cosa fa ogni riga.
## Test
- Aggiungi o aggiorna un test per ogni comportamento che modifichi.
- Esegui il comando di test e correggi gli errori prima di dichiarare concluso il lavoro.
- Non eliminare né saltare un test che fallisce per far passare la suite.
## Commit e pull request
- Scrivi i subject dei commit all'imperativo e in meno di 72 caratteri.
- Limita ogni pull request a una sola modifica e indica nella descrizione come l'hai testata.
- Esegui il linter e i test prima di ogni commit.
## Non fare mai
- Non inserire mai nei commit segreti, chiavi API o file .env.
- Non modificare mai manualmente i file generati in src/generated/; rigenerali.
- Non eseguire mai comandi distruttivi sul database di produzione.
- Non eseguire mai un force push su main né riscrivere la cronologia condivisa.
La stessa regola per cinque tool
---
description: Convenzioni per i file che corrispondono a questo glob
globs: app/**/*.tsx
alwaysApply: false
---
Segui le convenzioni già adottate dai file vicini in questa cartella. Ogni funzione esportata deve avere una docstring e un test nel file di test corrispondente.
---
applyTo: "app/**/*.tsx"
---
Segui le convenzioni già adottate dai file vicini in questa cartella. Ogni funzione esportata deve avere una docstring e un test nel file di test corrispondente.
---
paths:
- "app/**/*.tsx"
---
Segui le convenzioni già adottate dai file vicini in questa cartella. Ogni funzione esportata deve avere una docstring e un test nel file di test corrispondente.
---
paths:
- "app/**/*.tsx"
---
Segui le convenzioni già adottate dai file vicini in questa cartella. Ogni funzione esportata deve avere una docstring e un test nel file di test corrispondente.
---
trigger: glob
globs: app/**/*.tsx
---
Segui le convenzioni già adottate dai file vicini in questa cartella. Ogni funzione esportata deve avere una docstring e un test nel file di test corrispondente.
Come scrivere un file di istruzioni efficace
Metti i comandi esatti all'inizio
Indica subito nel file i comandi effettivi per installazione, test e lint, con i relativi flag. Specifica con precisione lo stack e le versioni e aggiungi un breve esempio di codice dove la prosa sarebbe vaga.
Scrivi regole esplicite su cosa non fare
Specifica chiaramente cosa l'agente non deve fare, ad esempio modificare segreti, codice vendorizzato o l'ambiente di produzione. «Non eseguire mai il commit di segreti» è stato il vincolo utile più comune nei file esaminati da GitHub.
Rendi verificabile ogni istruzione
«Esegui npm test prima di creare un commit» è verificabile; «testa le tue modifiche» no. Elimina le contraddizioni: se due righe sono in disaccordo, il modello potrebbe seguire l'una o l'altra.
Sii conciso e separa le regole per percorso
Anthropic consiglia di non superare le 200 righe per file e Cursor le 500 per regola. Sposta le indicazioni relative a un'area in una regola associata a un percorso, così verrà caricata solo quando si lavora su quei file. Gli import riordinano il file, ma non riducono il costo del contesto.
Evita ciò che l'agente già sa
In uno studio su quattro agenti di coding, i file di contesto non hanno aumentato in modo affidabile il successo delle attività e hanno incrementato di oltre il 20% il costo dell'inferenza. I file scritti da LLM hanno avuto un lieve effetto negativo e le panoramiche dei repository non sono state utili: limita quindi il file ai requisiti non ovvi, come l'uso di strumenti specifici.
Aggiungi regole quando gli errori si ripetono
Inizia con poco e aggiungi una regola quando noti che l'agente ripete lo stesso errore. Indica un file esistente come esempio, invece di incollare un'intera guida di stile.
Domande su AGENTS.md
Claude Code legge AGENTS.md?
Sì, a partire dalla v2.1.277. Per impostazione predefinita, legge AGENTS.md o .claude/AGENTS.md solo se nella directory di lavoro o in una directory superiore non sono presenti CLAUDE.md, .claude/CLAUDE.md o CLAUDE.local.md. L'impostazione claude-md-and-agents-md carica entrambi i file; inoltre, un CLAUDE.md che contiene @AGENTS.md funziona con qualsiasi versione.
AGENTS.md deve avere frontmatter o intestazioni specifiche?
No. AGENTS.md è un normale file Markdown, senza campi obbligatori e con le intestazioni che preferisci. Il sito agents.md suggerisce sezioni come panoramica del progetto, comandi di build e test, stile del codice, test, note sulla sicurezza e linee guida per le pull request.
Come si usa AGENTS.md in un monorepo?
Inserisci un AGENTS.md nella root e un altro in ogni package che richiede regole specifiche. Gli agenti leggono il file più vicino al codice da modificare; in caso di conflitto, prevale quel file. Quando agents.md ha documentato questa pratica, il repository principale di OpenAI ne conteneva 88.
Come faccio a configurare Gemini CLI per leggere AGENTS.md?
Per impostazione predefinita, Gemini CLI usa ancora GEMINI.md. Aggiungi AGENTS.md a context.fileName in .gemini/settings.json, ad esempio ["AGENTS.md", "GEMINI.md"]. Esegui /memory show per verificare cosa è stato caricato.
Quali agenti di coding supportano AGENTS.md?
Abbiamo verificato la documentazione di OpenAI Codex, Claude Code, Cursor, GitHub Copilot, Devin Desktop, Cline e OpenClaw: tutti leggono il file nativamente. Gemini CLI e Aider richiedono invece una riga di config. Il sito agents.md elenca 23 strumenti compatibili in totale, tra cui Zed, Warp, goose, opencode, Jules e JetBrains Junie.
Chi gestisce il formato AGENTS.md?
OpenAI ha contribuito AGENTS.md alla Agentic AI Foundation, un fondo diretto della Linux Foundation annunciato il 2025-12-09 insieme a MCP e goose. Il sito agents.md afferma che lo usano oltre 60k progetti open source.