要点
- AGENTS.md は AI コーディングエージェントに指示を与えるオープン標準です。README.md を置き換えるのではなく並置される「機械向けの README」で、2025 年 8 月に OpenAI・Google・Cursor・Factory・Sourcegraph によって正式化されました。
- 普及は急速でした。2025 年 12 月までに 6 万を超えるオープンソースプロジェクトが採用し、20 を超える AI コーディングツールが対応しています。GitHub Copilot（2025 年 8 月からネイティブ対応）、OpenAI Codex、Cursor、Google Jules と Gemini、Factory、Amp、Windsurf、Zed、RooCode などです。
- 2025 年 12 月、仕様は Linux Foundation の Agentic AI Foundation に寄贈され、ベンダー間の取り決めから中立的なガバナンスへ移りました。
- これは SEO や AI 可視性のためのファイルではありません。 AGENTS.md が指示するのは自社リポジトリ内部で動くエージェントであり、ChatGPT が自社サイトを引用するかどうかには何の作用もしません。それは
llms.txtの領域であり、両者の混同はよくある、そして高くつく誤りです。 - ファイルそのものより重要なのは、転用できる教訓です。一部のコンテンツでは機械の読者が人間の読者を上回っており、機械は推論を期待されるよりも明示的な指示を書かれたほうが良く働きます。
AGENTS.md とは何か
AGENTS.md はリポジトリのルートに置く Markdown ファイルで、AI コーディングエージェントにそのコードベースでの作業方法を伝えます。README.md を置き換えるのではなく補完します。README は概要とクイックスタートで人間の開発者に向けられ、AGENTS.md はエージェントが必要とする詳細な技術指示——ビルドコマンド、テストコマンド、コード規約、各ディレクトリの意味、触ってはいけないもの——を担います。
この形式は 2025 年 8 月、OpenAI・Google・Cursor・Factory・Sourcegraph の協働によって正式化されました。単一企業の取り決めではなく、ベンダー横断の取り組みだった点が重要です。それ以前は、コーディングアシスタントごとに独自の指示ファイルを求めており、3 つのエージェントに対応するリポジトリはほぼ重複した 3 つのファイルを抱え、それらは次第に乖離していきました。
普及は速やかに続きました。GitHub Copilot は 2025 年 8 月にネイティブ対応を追加。2025 年 12 月までに 6 万を超えるオープンソースプロジェクトがこの形式を採用し、20 を超える AI コーディングツールが読み取るようになりました。同月、仕様は Linux Foundation の Agentic AI Foundation へ寄贈され、中立的なガバナンス下に置かれました。
報告されている実際の効果は一貫しています。エージェントは探索フェーズを省略でき、生成コードは最初の試行からチームの基準に沿い、レビューの往復が短くなります。
何を書くべきか
厳格なスキーマは存在せず、それはこの形式の長所でもあり短所でもあります。経験のあるリポジトリが収束していく内容は以下です。
- 実際に動くコマンド。 正確なビルド・テスト・lint・開発コマンドと、どのパッケージマネージャを使うか。エージェントは頻繁に推測を誤り、一度の誤りで 1 ターンを無駄にします。
- 規約。 命名、整形、ファイル構成、どのパターンが自プロジェクトの作法で、どれが真似すべきでない過去の遺産か。
- ディレクトリの意味。 何がどこにあり、なぜそこにあるか。「自動生成——編集禁止」は書ける中で最も価値の高い一行です。
- 絶対的な制約。 変更してはならないもの、vendored されているファイル、lint 対象外のディレクトリ、編集ではなくマイグレーションを要するもの。
- 検証手順。 エージェントが自分の変更が機能したことをどう確認すべきか。特にテストランナーが存在しないプロジェクトでは重要です。
繰り返し現れる失敗が 2 つあります。1 つは人間向けに書いてしまうこと——エージェントが行動に移せない、プロジェクト理念についての散文です。もう 1 つは腐敗を放置すること。半年前に削除されたビルドコマンドを記載した AGENTS.md は、ファイルがないよりも悪いのです。エージェントはそれを信じるからです。
解いておくべき混同
2026 年のマーケティング記事の多くは、AGENTS.md を「次の llms.txt」として扱います。違います。そして言葉にすれば区別は単純です。