AGENTS.mdとは？ | GEO用語集

AGENTS.mdは、リポジトリやウェブサイトのルートに置くマークダウンファイルで、AIエージェントにそのプロジェクトのビルド方法、テストコマンド、コードスタイル、作業時に守るべきルールを伝える、事実上の標準指示ファイルです。「エージェントのためのREADME」と呼ばれ、OpenAI Codexをはじめとする主要なコーディングエージェントが作業開始時に自動的に読み込みます。

なぜ重要なのか

AIコーディングエージェントは強力ですが、プロジェクトの暗黙知を知りません。どのコマンドでテストを実行するのか、どのディレクトリに触れてはいけないのかを、プロンプトのたびに改めて説明する必要がありました。AGENTS.mdはこの文脈を1つのファイルに固定し、エージェントが自動的に参照できるようにします。OpenAI Codex、Amp、Jules（Google）、Cursor、Factoryが共同で設計し、GitHub Copilot、Gemini CLI、Devin、Zedなど20以上のツールがネイティブにサポートしています。2026年時点で6万以上のオープンソースプロジェクトが採用しており、2025年12月にはAnthropicのModel Context ProtocolとともにLinux Foundation傘下のAgentic AI Foundationに寄贈され、中立的なガバナンスのもとで管理されています。

構造と書き方

AGENTS.mdは必須フィールドのない純粋なマークダウンです。定められたスキーマの代わりに、エージェントが読んで従える自然言語の指示を記述します。推奨される構成は次のとおりです。

プロジェクト概要: 何をするコードベースなのかを1〜2段落で
ビルド・テストコマンド: 依存関係のインストール、開発サーバー、テスト実行のコマンド
コードスタイル: 命名、フォーマット、フレームワークの慣例
セキュリティ・境界: 触れてはいけないファイル、機密値の取り扱いルール
コミット・PRルール: メッセージの形式、レビューの手順

大規模なモノレポではパッケージごとにネストしたAGENTS.mdを置き、エージェントは作業位置からもっとも近いファイルを優先して適用します。

llms.txtとの違い

llms.txtが「AIにどのようなコンテンツがあるか」を伝える案内冊子だとすれば、AGENTS.mdは「ここでどう作業するか」を伝える運用マニュアルです。もともとコードリポジトリから出発しましたが、最近ではウェブサイトのルート（/agents.md）に置いて、ブラウジングエージェントにサイトの利用方法を案内するパターンも登場しています。llms.txtやSchema.orgマークアップとともに「エージェントが読める信号（agent-readable signals）」というカテゴリにまとめられ、AIクローリングの許可可否を扱うrobots.txtとは異なり、「許可されたエージェントが何をどうすればよいか」を扱います。

GEOの観点からの示唆

GEOの重心が「AIが引用するコンテンツ」から「AIが作業できるサイト」へと広がるにつれ、エージェントに明示的な指示を提供するファイルが新たな最適化のレイヤーになりつつあります。開発ツールやAPIドキュメントを運用するチームであれば、AGENTS.mdでエージェントの試行錯誤を減らすほど、自社の製品がエージェントのワークフローに採用される可能性が高まります。ただしAGENTS.mdは指示にすぎず強制力はないため、コンテンツ自体の構造化の品質が依然として基本です。

Sources:

How inblog Helps

inblogで製品ブログやドキュメントコンテンツを運用するなら、信号の役割分担を覚えておきましょう。llms.txt系のファイルがコンテンツの案内を担い、AGENTS.mdが作業指示を担う一方で、ブログ本文はエージェントが引用・要約しやすい構造を備えることが基本です。inblogのクリーンなマークアップと明確な小見出し構造は、こうしたエージェントが読める信号と組み合わさったときに効果が大きくなります。