株式会社renue
AI導入・DXの悩みをプロに相談してみませんか？
AIやDXに関する悩みがありましたら、お気軽にrenueの無料相談をご利用ください。 renueのAI支援実績、コンサルティングの方針や進め方をご紹介します。
AGENTS.mdとは？
AGENTS.mdとは、AIコーディングエージェントにプロジェクト固有の指示を与えるための標準化されたMarkdownファイルです。2025年8月にOpenAIが発表し、2025年12月にはLinux Foundation傘下のAgentic AI Foundation（AAIF）に寄贈されました。
プロジェクトのルートディレクトリにAGENTS.mdを配置することで、ビルドコマンド、コーディング規約、テスト要件、AIエージェントの行動制約などを統一的に記述できます。2026年現在、多くのオープンソースプロジェクトや主要なコーディングエージェントで対応が進んでいるとされています。
なぜAGENTS.mdが必要なのか
エージェントごとの設定ファイル乱立問題
AIコーディングエージェントの普及に伴い、各エージェント固有の設定ファイルが乱立していました。
- CLAUDE.md：Claude Code用のプロジェクト設定
- .cursorrules：Cursor用のルール定義
- .github/copilot-instructions.md：GitHub Copilot用の指示
エージェントごとに異なるファイルを管理するのは非効率であり、チーム内で複数のエージェントを使い分ける場合に設定の一貫性を保つのが困難でした。
AGENTS.mdによる統一
AGENTS.mdはエージェント非依存の統一フォーマットを提供します。AGENTS.md対応エージェント間で、プロジェクトの指示を共有できます。ただし読み込み方法はツールごとに異なり、Claude CodeではCLAUDE.mdからAGENTS.mdをインポートするなどの設定が必要です。
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固有の指示を追加する運用が可能です。なお、ツールの許可・拒否などの実行制御はsettings.json等の設定で行い、指示文書への記載とは区別します。
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）はAAIFが管理するプロジェクトで、A2A（Agent-to-Agent）も2026年8月17日にAAIFへの参加が発表されています。
| 標準 | 役割 |
|---|---|
| MCP | AIエージェントとツール・データの接続 |
| A2A | AIエージェント同士の通信・協調 |
| AGENTS.md | AIエージェントへのプロジェクト固有の指示 |
この3つの標準が揃うことで、AIエージェントは「何に接続するか（MCP）」「誰と協力するか（A2A）」「どう振る舞うか（AGENTS.md）」を統一的に定義できるようになります。
よくある質問（FAQ）
Q. CLAUDE.mdはもう不要ですか？
CLAUDE.mdは引き続き必要です。Claude CodeはCLAUDE.mdを読み込むため、共通指示をAGENTS.mdに置く場合はインポート等で連携します。AGENTS.mdへの完全統一を既定の計画とはせず、利用するツールの対応仕様を確認してください。
Q. AGENTS.mdを書くのに特別なスキルは必要ですか？
いいえ。通常のMarkdownで記述するだけです。プロジェクトの開発ルールを知っている開発者であれば誰でも書けます。
まとめ
AGENTS.mdは、AIコーディングエージェントにプロジェクト固有の指示を与えるための標準化されたMarkdownファイルです。OpenAIが発表し、Agentic AI Foundationに寄贈された業界標準であり、多くのプロジェクトや主要エージェントで対応が進んでいるとされています。MCP・A2Aと並ぶ標準の1つと位置づけられています。
renueでは、CLAUDE.md・AGENTS.mdを活用したAIコーディングエージェントの開発プロセスを自社で実践し、その知見をクライアントに還元しています。AIエージェント活用に関するご相談はお問い合わせください。
参考情報
- AGENTS.md公式サイト
- AGENTS.md Explained - Particula
- Agentic AI Foundation発表 - Linux Foundation
- AGENTS.md仕様 - Agentic AI Knowledge Base
