>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #3585532. --> Reported by: [webchick](https://www.drupal.org/user/24967) Related to !27 >>> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>We, along with ~60K open source projects, are following the <a href="https://agents.md/">AGENTS.md</a> format. Unfortunately some of the more popular coding agents have their own "special snowflake" versions of these files (e.g. <code>CLAUDE.md</code>, <code>GEMINI.md</code>) and in order to not repeat ourselves in 500 places we currently plead with them in English to use AGENTS.md instead.</p> <p>Turns out, as noted by @the_g_bomb in <a href="https://git.drupalcode.org/project/ai_best_practices/-/merge_requests/10">https://git.drupalcode.org/project/ai_best_practices/-/merge_requests/10</a> you can just use the <code>@AGENTS.md</code> shortcut and it'll do a file import directly! :D</p> <p>Sources:</p> <ul> <li>Claude: <a href="https://code.claude.com/docs/en/memory#import-additional-files">https://code.claude.com/docs/en/memory#import-additional-files</a></li> <li>Gemini: <a href="https://geminicli.com/docs/cli/gemini-md/#modularize-context-with-imports">https://geminicli.com/docs/cli/gemini-md/#modularize-context-with-imports</a></li> </ul> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <p>Replace the contents of CLAUDE.md and GEMINI.md with @AGENTS.md in <a href="https://git.drupalcode.org/project/ai_best_practices/-/tree/1.0.x/agents?ref_type=heads">https://git.drupalcode.org/project/ai_best_practices/-/tree/1.0.x/agents?ref_type=heads</a></p>