AGENTS.md

AGENTS.md è una convenzione cross-tool per fornire istruzioni del repository agli agenti di codifica. Il fatto più importante è che Claude Code legge CLAUDE.md, non AGENTS.md. Se il tuo repository utilizza già AGENTS.md per altri agenti di codifica, la correzione documentata è creare un CLAUDE.md che lo importi. Ciò consente a entrambi gli strumenti di leggere le stesse istruzioni senza duplicazione. Un CLAUDE.md contenente @AGENTS.md carica il file importato all'avvio della sessione. Puoi quindi aggiungere istruzioni specifiche di Claude sotto l'importazione.

Anche un symlink funziona se non hai bisogno di aggiungere contenuti specifici di Claude (ln -s AGENTS.md CLAUDE.md). Tuttavia, su Windows, la creazione di un symlink richiede privilegi di amministratore o la modalità sviluppatore, rendendo l'importazione @AGENTS.md la scelta più sicura.

L'esecuzione di /init in un repository che ha già un AGENTS.md lo legge e incorpora le parti pertinenti nel CLAUDE.md generato. Il comando /init legge anche altre configurazioni dello strumento, come .cursorrules, .devin/rules/ e .windsurfrules.

Questa convenzione è distinta dal formato claude-md, che è specifico per Claude Code. Per gli strumenti che generano file AGENTS.md basati sullo stack del tuo progetto, considera la skill Agent Rules (AGENTS.md Generator).