--- title: "Generatore AGENTS.md con regole per cinque agenti di coding · DotsAgent" description: "Compila un modulo per ottenere un AGENTS.md, la stessa regola associata a un percorso per Cursor, Copilot, Claude Code, Cline e Devin, e file ponte per Gemini CLI e Aider." url: https://dotsagent.io/it/instructions --- Instruct · strumento # 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 →](https://dotsagent.io/it/instructions/files) `AGENTS.md` ``` # 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 Una regola in cinque formati; salva ogni file nel percorso indicato sopra. `.cursor/rules/scoped.mdc` ``` --- 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. ``` `.github/instructions/scoped.instructions.md` ``` --- 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. ``` `.claude/rules/scoped.md` ``` --- 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. ``` `.clinerules/scoped.md` ``` --- 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. ``` `.devin/rules/scoped.md` ``` --- 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. GitHub Blog, analisi di oltre 2.500 file AGENTS.md ### 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. GitHub Blog, analisi di oltre 2.500 file AGENTS.md ### 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. Documentazione sulla memoria di Claude Code ### 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. Documentazione sulla memoria di Claude Code; documentazione di Cursor Rules ### 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. ETH Zurich SRI Lab, arXiv 2602.11988 ### 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. Documentazione di Cursor Rules; GitHub Blog ## 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. Riferimento indipendente per chi sviluppa agenti IA. Non siamo affiliati a nessun fornitore citato qui. © 2026 DotsAgent · Dati verificati il 1 ottobre 2026