AGENTS.md とは — AI が最初に読む指示ファイル

4 分で読む

AGENTS.md は、AI エージェントが作業を始める前に自動で読み込むプロジェクト共通の指示書（ルールファイル）です。利用者がチャットで毎回手入力しなくても、共通のコーディング規約、使用する開発コマンド、安全上の禁止事項などを自動で AI モデルへ伝えてくれます。

製品ごとに CLAUDE.md（Claude Code）や GEMINI.md（Antigravity）といった固有の名前も存在しますが、「どの製品がどのファイルを読み、複数ツールでどう共通化すべきか」について、IT連携マップ編集部が実機検証に基づき解説します。

どの AI エージェントが、どのファイルを読むのか？

IT連携マップ編集部は 2026 年 10 月に、「返事の最後に特定の合言葉を書く」とだけ指示したルールファイルを空のディレクトリに配置し、各ツールがツールを使わずに自動で指示を読み取れるかを検証しました（各 3 回）。

重要な発見は以下の 2 点です。

1. ファイル名は AGENTS.md（S あり）にする：S の無い AGENT.md は、どの製品も原則読みません（Antigravity の CLI が 6 回中 1 回読んだだけ）。
2. Claude Code は CLAUDE.md が優先される：両方が存在する場合、Claude Code は CLAUDE.md だけを読み、AGENTS.md を無視します。
   Claude Code Docs（memory）原文

   By default, Claude reads AGENTS.md only when you have no CLAUDE.md in your working directory or above it.

   出典を開く確認 2026-10-18

3 つの製品で 1 つのファイルにまとめるには？

複数の AI エージェントを併用するとき、製品ごとに別々の指示ファイルを直していると、中身がずれやすくなります。 指示の本体を AGENTS.md にまとめ、CLAUDE.md には AGENTS.md を読み込む 1 行だけを書きます。

@ 記法は、Claude Code が外部ファイルをインライン展開して読み込む公式の記法です。

どこに置けばよいのか？（配置場所）

どれくらいの大きさまで読まれるのか？（サイズ上限）

指示ファイルの先頭・中間・末尾に異なる合言葉を埋め込み、ファイルサイズを大きくしながら測りました。

• Codex は先頭 32 KiB で読むのをやめる：文書に書かれた上限のとおり、32 KiB より後ろに書いた指示は読まれませんでした。
  OpenAI Codex Docs（agents-md）原文

  Codex skips empty files and stops adding files once the combined size reaches the limit defined by project_doc_max_bytes (32 KiB by default).

  出典を開く確認 2026-10-18

• Claude Code は 550KB でも全文を読む：大きなファイルも全部をコンテキストに入れるので、それだけで 1 回の送信ごとに約 20 万トークンを使い、使用量制限に早く達します。
• Antigravity は 1 ファイル 24,000 バイトで切る：文書にそう書かれています。
  Google Antigravity Docs（rules）原文

  Antigravity truncates any single rule file that exceeds 24,000 bytes

  出典を開く確認 2026-10-18

  それより大きいファイルでは、3 つの合言葉を全部答えた回、先頭だけの回、返事が空の回があり、回によって違いました。入力が大きく増えた回は、AI モデルが自分でファイルを読み直したと見られます。

何を書き、何を書かないのか？

指示ファイルは会話のたびに全文が AI モデルへ送られます（コンテキストとは）。Claude Code の文書は 1 ファイル 200 行未満を目安にし、長いほど指示が守られにくくなると書いています。

ここから先は調査の詳細です（約 3 分）。上のカードだけで決められます。調べた 1 件ずつの記録は IT連携マップ に、出典 URL と調査日つきで公開しています。