CopilotコードレビューがCLAUDE.mdを読むように【複数AIの指示がぶつかる前に】

GitHub Copilotのコードレビューが、Claude Code向けに置いたCLAUDE.mdも判断材料として読むようになりました。複数のAIを併用する会社にとって便利な変更ですが、古い指示やツール固有の命令まで同時に読まれる点には注意が必要です。

今やるべきことは、指示ファイルを増やすことではなく、共通ルールとツール固有ルールを分け、検証用PRで衝突を確かめることです。
そこで、設定ファイルの役割分担からマージ前の確認方法までを順に整理します。

CopilotコードレビューがCLAUDE.mdを読むようになった

2026年7月17日、GitHubはCopilot code reviewのカスタマイズ機能を更新しました。
リポジトリ内のCLAUDE.mdに加え、REVIEW.mdとGEMINI.mdも読み込み対象になったと公式Changelogで発表しています。

出典: GitHub Changelog「Copilot code review: Customization and configurability improvements」(英語)

同じ更新で、copilot-instructions.md、パス別の*.instructions.md、agent skills、AGENTS.mdは、プルリクエストで変更を含む側のhead branchから読むようになりました。
つまり、本流へマージする前に指示変更を試しやすくなったわけです。

AGENTS.mdへの対応自体は、その約1カ月前に進んでいました。GitHubは2026年6月18日、リポジトリルートに置かれたAGENTS.mdをCopilot code reviewが使う機能の一般提供を発表しています。

出典: GitHub Changelog「Copilot code review: AGENTS.md support and UI improvements」(英語)

読まれることと毎回従うことは別

ここで誤解しやすいのが、ファイルを置けば全命令へ必ず従うという考え方です。
GitHub公式チュートリアルは、AIの応答が非決定的であることを前提に、指示を短く具体的にし、ほかの指示と競合させないよう勧めています。

2026年6月12日には、.github配下のカスタム指示にあった4,000文字の読み取り上限が撤廃されました。
ただし、これは長文化を勧める変更ではなく、レビュー時に判定できる短い命令へ整える方が運用しやすくなります。

出典: GitHub Changelog「Copilot code review: New configurations and controls」(英語)

Copilotコードレビューの指示ファイルは役割で分ける

指示ファイルは、名前ではなく誰が、どの変更で使うルールかで分けます。
複数AIを併用するリポジトリでは、すべてをCLAUDE.mdへ寄せず、4つの層へ整理すると衝突を見つけやすくなります。

ファイルごとの役割を表で確認する

ファイル	主な役割	置く内容
AGENTS.md	複数AIの共通ルール	禁止操作、テスト、共通方針
CLAUDE.md	Claude固有の作業指示	Claude Codeの手順や参照先
.github/copilot-instructions.md	Copilot共通	コードレビュー固有の観点
*.instructions.md	パス固有	applyToで限定する技術ルール
REVIEW.md	人とAIのレビュー観点	品質基準や確認項目

GitHub Docsは、AGENTS.mdをAIツールをまたぐ常設指示、copilot-instructions.mdをCopilot固有のリポジトリ共通指示として案内しています。
共通ルールを1カ所で管理し、ツール固有ファイルには差分だけ置くのが基本です。

出典: GitHub Docs「About GitHub Copilot code review」(英語)

ツール自体の役割も混同しない方が安全です。Claude Code・Codex・Copilotの使い分けを先に決めると、どのAIへ何を任せるかが明確になり、指示ファイルの境界も引きやすくなります。

CLAUDE.mdとAGENTS.mdがぶつかる場面

衝突は、難しい文章より日常的な短い命令で起きます。片方に「変更後は全テストを実行」、もう片方に「時間短縮のため単体テストだけ」と書かれていれば、レビュー基準が安定しません。

• テストコマンドがファイルごとに異なる
• 変更禁止範囲と自動修正対象が重なっている
• 対象パスが広すぎて別言語の変更へ適用される
• 出力形式が一方では詳細、他方では簡潔と指定される
• 古い構成や廃止コマンドがCLAUDE.mdに残っている

固定優先順位を前提にしない

Copilot code reviewについて、CLAUDE.md、AGENTS.md、Copilot固有ファイルが矛盾した場合の普遍的な優先順位は公式情報で確認できません。ファイル名から順位を想像する運用は避けます。

優先順位に頼る代わりに、意味が反対の命令をなくし、適用範囲を狭めます。
AIへ多く読ませるほど精度が上がるのではなく、判断に必要な基準だけが矛盾なく届く状態を目指してください。

Copilotコードレビューの指示を整理する手順

整理は、いきなり書き換えず一覧化から始めるのが安全です。既存ルールを消さずに役割を付け、意味が反対の命令だけを先に解消します。

1. CLAUDE.md、AGENTS.md、REVIEW.md、GEMINI.md、copilot-instructions.md、*.instructions.mdを一覧化する
2. 各命令へ「全AI共通」「Claude固有」「Copilot固有」「パス固有」「人の運用」のラベルを付ける
3. テスト、禁止操作、対象パス、出力形式で意味が反対の命令を探す
4. 全AI共通ルールの正本を1カ所に決める
5. Copilot固有のレビュー観点はcopilot-instructions.mdへ移す
6. ディレクトリ固有の命令は*.instructions.mdへ分け、applyToを絞る
7. 検証用PRで指摘漏れと誤検出を確認し、変更理由を記録する

短く判定可能な命令へ変える

「品質の高いコードにする」では、何を指摘すべきか判断できません。対象、条件、期待する指摘を1文へ入れ、判定できない抽象語を減らします。

たとえば、「認証情報がコードへ直書きされていたら指摘する」「API配下を変更したら指定のテストを確認する」のように書きます。外部URLだけを渡して読ませるのではなく、必要な判断基準を指示ファイル内へ残してください。

出典: GitHub Docs「Using custom instructions to unlock the power of Copilot code review」(英語)

組織全体のAI運用ルールと接続する場合は、AIエージェント利用の社内ルールも合わせて確認すると、コード上の禁止事項と会社の情報管理方針をそろえやすくなります。

Copilotコードレビューを検証用PRで試す

最新の公式発表でhead branchから読むと示されたのは、copilot-instructions.md、*.instructions.md、agent skills、AGENTS.mdの4点です。
CLAUDE.mdやREVIEW.mdも同じ扱いかは公式に明記がないため、指示の変更と小さなコード変更を同じ検証用PRへ入れ、実際の挙動をマージ前に確かめます。

ただし、2026年7月19日の調査時点では、一部GitHub Docsにbase branchを前提とした説明が残っています。
これは最新Changelogとの更新差とみられるため、現行判断では7月17日の変更発表を優先し、今後Docsが更新されたかも確認してください。

• 指示変更だけでなく、意図的な違反例を1〜3個入れる
• 期待した指摘が出たか、見逃しを記録する
• 関係ない変更への誤検出が増えていないか確認する
• 人のレビュー基準とCopilotの指摘が矛盾していないかを見る
• 結果が安定しない場合は、命令を短くして対象パスを狭める

AIがどの作業をしたかまで追いたい場合は、GitHub Copilotエージェントの作業履歴を確認する方法も役立ちます。指示、PR、レビュー結果、作業ログをつなぐと、任せっぱなしを防ぎやすくなります。

AIレビューだけでマージしない

GitHubは、Copilot code reviewがすべての問題を見つける保証はないと説明しています。AIレビューは承認者ではなく、確認漏れを減らす補助者として置き、最終判断を人から外さないことが重要です。

とくに、認証、権限、課金、顧客データ、削除処理、外部公開に関わる変更は、人の確認を必須にします。AIで作ったコードのバグ検査で示したように、画面が動くことと安全に納品できることは同じではありません。

• 秘密情報がコードや指示ファイルへ入っていないか
• 権限変更が必要以上に広がっていないか
• 削除や公開など取り消しにくい処理が含まれないか
• 重要テストが実行され、結果を人が確認したか
• 指示ファイルの変更自体が別のAIへ影響しないか

入力データや参照範囲も別に管理が必要です。CopilotとClaudeを使う際のデータ権限管理を参考に、指示ファイルへ秘密情報を書かず、content exclusionなどの設定も確認してください。

指示ファイルを整える要点

Copilotコードレビューの指示設計とは、共通ルールとツール固有ルールを分け、検証用PRで矛盾を潰す運用です。

CLAUDE.mdが読み込み対象になった今、最初の一歩は新しい設定の追加ではなく、既存ファイルを一覧化して重複、矛盾、古いコマンドへ印を付けることです。
その結果をもとに正本を決め、Copilot固有とパス固有の命令を分離します。

複数AIを安全に使う基盤を広げるなら、指示ファイルだけでなくAIコーディングツールの役割分担も同時に見直します。ツールの役割とルールの置き場が一致すると、レビュー結果を説明しやすくなります。

CopilotコードレビューとCLAUDE.mdのよくある質問