AGENTS.mdはGitHub Copilotでも読めるようになった——ただし、期待通りの動作をするかは別の話だ。Claude CodeがCLAUDE.mdを扱う厳密さと、CopilotがAGENTS.mdを扱う緩さには明確な差がある。この差を理解せずに「1ファイルで全部解決」を目指すと、ツールごとに微妙に違う挙動で混乱することになる。
この記事では、CopilotのAGENTS.md読み込みの実態、Custom instructionsとの使い分け、そしてClaude Codeと共存させる設定パターンを具体的に説明する。
GitHub CopilotはAGENTS.mdを読むのか
読む。ただし条件がある。
CopilotはAGENTS.md対応を2025年に追加した。Copilot ChatとGitHub.comのウェブエディタではリポジトリルートのAGENTS.mdを読み込む。ただしモードによって対応レベルが違う。
| モード | AGENTS.md対応 |
|---|---|
| Copilot Chat（VS Code） | 対応（リポジトリルート・docs/から） |
| GitHub.com のCopilot | 対応（ウェブエディタ経由でインデックス） |
| Copilot Workspace | 対応（ディレクトリ階層を全て読む） |
| Copilot Edits（インライン） | 部分対応（読み込むが適用が不安定） |
| Copilot CLI | 非対応 |
重要な点は、CopilotのAGENTS.md扱いが「参考にする強いシステムプロンプト」に近く、Claude Codeが「CLAUDE.mdを権威ある設定として厳密に従う」のとは異なるということだ。ルールを破ることへの抵抗感が薄い。
Copilotのファイル探索順序
CopilotはCodexやClaude Codeより単純な探索をする。
- リポジトリルートの
/AGENTS.mdを最初にチェック /docs/AGENTS.mdをフォールバックとしてチェック- Copilot Workspaceでは、タスクが関係するディレクトリ配下のAGENTS.mdも読む
Codexが ~/.codex/AGENTS.md でユーザーレベルの設定を読むのと違い、Copilotにはそれに相当するユーザーレベルのAGENTS.mdパスがない。Copilotでユーザーレベルの設定をしたい場合はCopilotのカスタム指示機能（GitHub.comのアカウント設定）を使う。
Custom Instructions と AGENTS.md の違い
AGENTS.md対応が来る前から、Copilotには独自の設定ファイルがあった。.github/copilot-instructions.mdだ。これは今でもCopilotの主要な設定経路であり、AGENTS.mdが効かない場面でも確実に動作する。OpenAI CodexがAGENTS.mdをどう扱うかについてはAGENTS.md for OpenAI Codex 完全ガイドで比較できる。
project-root/
├── AGENTS.md # マルチツール共通（Codex・Cursorでも読む）
├── .github/
│ └── copilot-instructions.md # Copilot専用設定
└── CLAUDE.md # Claude Code設定2つのファイルの性格の違い:
.github/copilot-instructions.md
- Copilot専用。全モード・全セッションで確実に読まれる
- 階層なし（リポジトリ全体に1ファイル）
- Copilot固有の機能（トピックフィルタリング等）が使える
AGENTS.md
- マルチツール標準。Copilot、Codex、Cursor等が読む
- Copilot Workspaceではディレクトリ階層に対応
- Copilot固有の機能は使えない
実用上の方針: Copilotがメインツールなら .github/copilot-instructions.md の方が信頼度が高い。AGENTS.mdは「どのエージェントでも同じ基盤ルールを使いたい」ときに価値が出る。
CopilotがAGENTS.mdで確実に機能するセクション
CopilotはAGENTS.mdを読んだ後、内容を高優先度のコンテキストとして処理する。確実に効くセクションと、そうでないセクションがある。
確実に効く: コマンドとセットアップ
## Commands セクションは高い精度で機能する。Copilotがスクリプトを生成したりターミナルコマンドを提案する際に参照する。
## Commands
- インストール: pnpm install
- 開発サーバー: pnpm dev
- テスト: pnpm test --run
- Lint: pnpm lint && pnpm tsc --noEmit確実に効く: コードスタイル規約
言語レベルの規約（TypeScript設定、命名規則、推奨パターン）は一貫して適用される。
## コードスタイル
- TypeScript: strict mode、any禁止、外部データにはunknownを使う
- React: デフォルトはServer Components、必要な時だけ'use client'を付ける
- CSS: Tailwindユーティリティクラス、動的値以外のインラインスタイル禁止
- インポート: クロスモジュールは相対パスでなく`@/`エイリアスを使う効きが弱い部分:
- サブディレクトリ固有のルール（多くのモードで階層をフラットにしてしまう）
- 長いAGENTS.md（2,000トークン超は後半の注意力が落ちる）
- 条件分岐的な指示（「auth/を触るPRの場合は…」系）
Claude Code + Copilot の共存パターン
2つのツールを同じリポジトリで使う場合、設定ファイルが3つ（AGENTS.md、copilot-instructions.md、CLAUDE.md）になる。これを正しく分離すると管理が楽になる。
project-root/
├── AGENTS.md # ツール横断の共通ルール
├── .github/
│ └── copilot-instructions.md # Copilot専用
└── CLAUDE.md # Claude Code専用（AGENTS.mdをインポート）AGENTS.mdに書くもの（共通基盤）:
- プロジェクトアーキテクチャの概要
- ビルド・テストコマンド
- 絶対に守るべき制約（「migrationsの変更は事前承認必須」等）
- 技術スタックとバージョン
- ディレクトリ構造の説明
.github/copilot-instructions.mdに書くもの（Copilot専用）:
- Copilot Chatのレスポンススタイル指定
- トピックフォーカス（「TypeScriptに絞る」「Python例は不要」）
- コードレビュー時の振る舞い
CLAUDE.mdに書くもの（Claude Code専用）:
- Hooks、パーミッション設定
- サブエージェントへの委譲パターン
- AGENTS.mdをインポートして拡張
ルール競合を防ぐ: CLAUDE.mdでインポートする
CLAUDE.mdがAGENTS.mdの内容を取り込む形にすると、ルールの一元管理ができる。
# CLAUDE.md
@import AGENTS.md
## Claude Code固有設定
### Hooks
PostToolUse: npm run lint -- {path}
Stop: node scripts/verify-build.js
### Permissions
- Bash: allow
- Write: src/外のファイルは確認を求めるこのパターンだとAGENTS.mdが共有ルールの単一ソースとなり、CLAUDE.mdはそれを拡張する形になる。ルールの二重管理がなくなり、更新も1ファイルで済む。
Copilot Workspaceでの階層設定
Copilot WorkspaceはAGENTS.md階層への対応が最も充実している。ディレクトリ構造を活かした設定例:
project-root/
├── AGENTS.md # グローバル指示
├── src/
│ ├── AGENTS.md # フロントエンド固有ルール
│ └── api/
│ └── AGENTS.md # APIレイヤー固有ルール
└── tests/
└── AGENTS.md # テスト記述規約src/api/AGENTS.mdの例:
# APIレイヤー指示
## 認証
- `/auth/*` 以外の全エンドポイントに `requireAuth` ミドルウェアが必要
- JWTシークレットはハードコード禁止。必ず `process.env.JWT_SECRET` を使う
- リフレッシュトークンのローテーションロジックは `auth/refresh.ts` のみで管理
## エラーハンドリング
- 全エラーをRFC 7807の `problem+json` 形式で返す
- `req.correlationId` からの相関IDでログを記録する
- 本番環境ではスタックトレースをクライアントに返さないCopilot Workspaceで src/api/ 配下に関わるタスクを作ると、ルートのAGENTS.mdと src/api/AGENTS.md の両方が適用される。競合がある場合はサブディレクトリのファイルが優先される。
Copilotが実際に何を吸収したかを確認する方法
Claude Codeと違い、Copilotは「今どんなルールを読んでいるか」を透明に見せてくれない。実用的な確認方法は、設定後にCopilot Chatで直接聞くことだ。
このプロジェクトに設定されている主要な規約と制約を教えてください。Copilotが吸収した内容を列挙する。これが品質チェックになる。重要なルールが抜けていたら、ファイルの前の方に移動する（Copilotは早い方のコンテンツに高い注目度を向ける）か、.github/copilot-instructions.mdに確実に書く。
実測データ: TypeScript/Next.jsプロジェクトで680トークンのAGENTS.md（アーキテクチャ、コマンド、TypeScript規約）は完全に吸収された。同プロジェクトで説明・背景を加えた2,800トークン版は規約ルールの遵守率が60〜70%程度に落ちた。AGENTS.mdには「何をするか」だけを書き、「なぜか」は人間向けのCONTRIBUTING.mdに分けるのが正解だ。同じトークン効率の原則はCLAUDE.mdにも当てはまる——CLAUDE.md トークン最適化 2026でその手法を詳しく解説している。
判断フローのまとめ
| 状況 | 推奨 |
|---|---|
| Copilotのみ使う | .github/copilot-instructions.mdを主軸に |
| Copilot + Claude Code両方使う | AGENTS.mdに共通ルール、各ツールの固有ファイルに拡張 |
| Copilot Workspaceでエージェント作業 | ディレクトリ階層をフルに活用 |
| 絶対守らせたいルールがある | AGENTS.mdだけでなく.github/copilot-instructions.mdにも書く |
| チームがAIツールを統一していない | AGENTS.mdを共通基盤として採用 |
AGENTS.mdはポータビリティを与える。.github/copilot-instructions.mdはCopilot内での確実性を与える。両方使い、明確に役割分担するのが2026年の最適解だ。
2026年Q2のアップデート
この記事を公開した2026年4月から、いくつか動きがありました。
Copilot Coding Agent が GA に到達。 プレビュー段階だったCopilot Coding Agent（バックグラウンドで自律実行するエージェント機能）が2026年Q2にGAになりました。Coding Agent はリポジトリルートの AGENTS.md を読み、複数ファイル横断のリファクタに適用します。実務上の意味：AGENTS.md は inline / Workspace サジェストだけでなく自律タスク実行にも load-bearing になり、設定ミスのコストが上がりました。
AGENTS.md specがAgentic AI Foundationに移管されました。 OpenAIがCodex向けに推進したフォーマットですが、specのホスティングがAgentic AI Foundation（Linux Foundation傘下の指定ファンド）に移行しました。GitHub Copilot、Codex CLI、Cursor、Cline、Windsurfすべてが同じフォーマットに対応し、ベンダー中立の運営に。技術的な仕様（フロントマター規約、ディスカバリ階層、override機構）は変わっていません。今書いたルールファイルは長く使えます。
Copilot CLI は依然 AGENTS.md を読みません。
Copilot CLI（ターミナルコンパニオン）は独自の .agent.md カスタムエージェント形式を使用しており、AGENTS.md を読まない点は2026年Q2でも変わっていません。Copilot CLIを多用するチームは、AGENTS.md と並行して .agent.md 戦略が必要です。
.github/instructions/*.instructions.md のパス指定ルール機能が成熟。
GitHub Copilot は .github/instructions/*.instructions.md 形式のパス指定ルール（applyTo: "src/api/**" のようなfrontmatter）に対応。これは AGENTS.md の代替ではなく並列で機能します。複雑なモノレポ構造では、AGENTS.md 階層よりもこちらの方が確実にルールが効くケースがあります。
トークン予算測定が再現性を持って確認されました。
本記事中で言及した「680トークンが最適」という測定値が、複数のプロダクションプロジェクトで再現されました。新発見：長いAGENTS.md（2,800トークン超）を1ファイルで運用するより、ルート AGENTS.md を小さく保ち、.github/instructions/*.instructions.md で詳細をパス指定する方が、Copilot と Coding Agent 両方でアドヒアランスが高くなります。
よくある質問
GitHub CopilotはAGENTS.mdを直接読みますか？
直接ではありません。GitHub Copilot は主に .github/copilot-instructions.md（リポジトリルート）と言語別・パス別の指示ファイルを読みます。AGENTS.md は Copilot Workspace（エージェントモード）と Copilot Coding Agent では読まれますが、inline Copilot サジェストでは読まれません。実用的なパターン：AGENTS.md をクロスツール共通ベースラインに、.github/copilot-instructions.md を Copilot 固有のオーバーレイにします。
AGENTS.md と .github/copilot-instructions.md どちらを使うべき？
チームが Copilot のみを使うなら .github/copilot-instructions.md を主軸に（Copilot 内でのアドヒアランスがより強い）。Copilot を Claude Code / Cursor / Codex と併用するなら、AGENTS.md を共通基盤、Copilot 固有のオーバーライドだけ薄い .github/copilot-instructions.md に書きます。
Copilot Workspace は AGENTS.md をどこから読みますか？
Copilot Workspace は編集中のファイルからリポジトリルートまでディレクトリツリーを走査し、見つかったすべての AGENTS.md を読み込みます。コンフリクトでは最も近いファイルが優先されます。これは OpenAI Codex CLI と同じ Agentic AI Foundation 準拠の発見モデルです。
Copilot にとって最適な AGENTS.md のサイズは？
プロダクションでの測定によると、約680トークンが完全アドヒアランスの sweet spot です。約2,800トークンになると、説明文が指示シグナルを希釈してアドヒアランスが60〜70%まで低下します。説明文は CONTRIBUTING.md（人間向け）に移し、AGENTS.md はアクション可能なルールに集中させましょう。
Copilot Coding Agent は AGENTS.md を読みますか？
読みます。Copilot Coding Agent（2026年Q2にGAになったバックグラウンド自律コーディング機能）はリポジトリルートの AGENTS.md を読み込みます。Coding Agent は inline レビューなしで複数ファイル変更を実行するため、ここでの AGENTS.md は inline サジェストより load-bearing です。Coding Agent を本番リポジトリで使うなら AGENTS.md を常に最新で正確に保ってください。
Copilot CLI は AGENTS.md を読みますか？
読みません。Copilot CLI（ターミナルコンパニオン）は AGENTS.md ではなく独自の .agent.md カスタムエージェント形式を使用します。Copilot CLI を Copilot Workspace と並行して標準化するチームは、.agent.md 戦略も並列で必要です。Claude Code CLI と Codex CLI は両方 AGENTS.md を読むため、CLI 系で AGENTS.md を読まないのは Copilot CLI だけが例外です。
AGENTS.md specは現在誰が管理していますか？
OpenAI が Codex 向けに最初推進したフォーマットですが、2026年Q2時点で Agentic AI Foundation（Linux Foundation 傘下の指定ファンド）が管理しています。GitHub Copilot、Codex CLI、Cursor、Cline、Windsurf がすべて同じフォーマットに対応し、ベンダー中立の運営になっています。技術仕様（フロントマター規約、ディスカバリ階層、override機構）は変わっていません。