AGENTS.mdとは？
AGENTS.mdとは、AIコーディングエージェントにプロジェクト固有の指示を与えるための標準化されたMarkdownファイルです。2025年8月にOpenAIが発表し、2025年12月にはLinux Foundation傘下のAgentic AI Foundation（AAIF）に寄贈されました。
プロジェクトのルートディレクトリにAGENTS.mdを配置することで、ビルドコマンド、コーディング規約、テスト要件、AIエージェントの行動制約��どを統一的に記述できます。2026���現在、60,000以上のオープンソースプロジェクトと、Claude Code、Cursor、GitHub Copilot、Devin、Gemini CLI等の主要エージェントがAGENTS.mdをサポートしています。
なぜAGENTS.mdが必要なのか
エージェントごとの設定ファイル���立問題
AIコーディングエージェントの普及に伴い、各エージェント固有の設定ファイルが乱立していました。
- CLAUDE.md：Claude Code用のプロジェクト設定
- .cursorrules：Cursor用のルール定義
- .github/copilot-instructions.md：GitHub Copilot用の��示
エージェントごとに異なるファイルを管理するのは非���率であり、チーム内で複数のエージェントを使い分ける場合に設定の一貫性を保つのが困難でした。
AGENTS.mdによる統一
AGENTS.mdはエージェント非依存の統一フォーマットを提供します。1つのファイルを書くだけで、Claude Code、Cursor、GitHub Copilot、Devin等、あらゆるAIコーディングエージェントが同じ指示���理解します。
AGENTS.mdの基本構造
必須セクション
| セクション | 内容 |
|---|---|
| Project Overview | プロジェクトの概要、技術スタック、アーキテクチャの説明 |
| Build & Run | ビルドコマンド、起動手順、環境変数の設定方法 |
| Code Conventions | コーディング規約、命名規則、ファイル構成のルール |
| Testing | テストの実行方法、カバレッジ要件、テストフレームワーク |
| Boundaries | AIエージェントがやってはいけないこと（禁止操作、触れてはいけないファイル等） |
CLAUDE.mdとの関係
AGENTS.mdはCLAUDE.mdの上位互換的な位置づけです。CLAUDE.mdはClaude Code専用でしたが、AGENTS.mdは全エージェント共通です。多くのプロジェクトではAGENTS.mdを正式な設定ファイルとしつつ、CLAUDE.mdにはClaude Code固有の追加設定を記述する運用が推奨されています。
AGENTS.mdの効果
1. エージェントの出力品質が安定する
プロジェクトのコーディング規約、アーキテクチャの判断基準、禁止事項を明文化することで、AIエージェントの出力がプロジェクトの文脈に沿った一貫したものになります。
2. オンボーディングの高速化
新しいチームメンバー（人間もAIも）がプロジェクトの全体像と開発ルールを素早く把握できます。AGENTS.mdはAIエージェントだけでなく、人間の開発者にとっても優れたドキュメントになります。
3. マルチエージェント環境での一貫性
チーム内でClaude Code、Cursor、GitHub Copilotなど複数のエージェントを併用する場合でも、AGENTS.mdで統一されたルールを共有できます。
AGENTS.mdの書き方のポイント
- 具体的に書く：「きれいなコードを書け」ではなく「関数は30行以内、1ファイル300行以内」のように数値で指定
- 禁止事項を明記する：AIが勝手にやりがちな行動（不要なリファクタリング、過���なエラーハンドリング等）を明示的に禁止
- ビルド・テストコマンドを正確に：AIエージェントが自動でビルド・テストを実行できるよう、コマンドを正確に記述
- 継続的に更新する：プロジェクトの進化に合わせてAGENTS.mdも更新。古い設定はAIの判断を誤らせる
Agentic AI Foundationのエコシステム
AGENTS.mdは、MCP（Model Context Protocol）、A2A（Agent-to-Agent）と並び、Agentic AI Foundation（AAIF）の3本柱の1つです。
| 標準 | 役割 |
|---|---|
| MCP | AIエージェントとツール・データの接続 |
| A2A | AIエージェント同士の通信・協調 |
| AGENTS.md | AIエージェントへのプロジェクト固有の指示 |
この3つの標準が���うことで、AIエージェントは「何に接続するか（MCP）」「誰と協力するか（A2A）」「どう振る舞うか（AGENTS.md）」を統一的に定義できるようになります。
よくある質問（FAQ）
Q. CLAUDE.mdはもう不要ですか？
完全に不要ではありません。AGENTS.mdが全エージェント共通の設定、CLAUDE.mdがClaude Code固有の追加設定という使い分けが現在の主流です。ただし、長期的にはAGENTS.mdに統一される方向です。
Q. AGENTS.mdを書くのに特別なスキルは必要ですか？
いいえ。通常のMarkdownで記述するだけです。プロジェクトの開発ルールを知っている開発者であれば誰でも書けます。
まとめ
AGENTS.mdは、AIコーディングエージェントにプロジェクト固有の指示を与えるための標準化されたMarkdownファイルです。OpenAIが発表し、Agentic AI Foundationに寄贈された業界標準であり、60,000以上のプロジェクトと主要エージェントがサポートしています。MCP・A2Aと合わせて、AIエージェント時代の3つの基盤標準の1つです。
renueでは、CLAUDE.md・AGENTS.mdを活用したAIコーディングエージェントの開発プロセス���自社で実践し、その知見をクライアントに還元しています。AIエージェント活用に関するご相談はお問い合わせください。