Claude Code 2.1.277は、オープンなプロジェクト指示ファイル形式であるAGENTS.mdに対応した。標準的な動作では、プロジェクト内にCLAUDE.mdが存在しない場合に、Claude CodeがAGENTS.mdをプロジェクト指示として読む。これにより、複数のAIコーディングツールで共通の指示書を使うリポジトリでも、Claude専用ファイルを先に作成せずClaude Codeを利用しやすくなる。1

基本ルールは「置き換え」ではなくフォールバック

今回の挙動はシンプルだ。

• CLAUDE.mdがないプロジェクト：Claude CodeはAGENTS.mdをプロジェクト指示として利用できる。1
• CLAUDE.mdがあるプロジェクト：従来のCLAUDE.mdがプロジェクト指示ファイルとして扱われる。リリース告知の標準フォールバック動作は、両ファイルを自動的に結合するものとしては説明されていない。1

この動作はClaude Codeの/configにあるProject instructionsから有効化・変更できる。なお、Amazon Bedrock、Google Vertex AI、Azure AI Foundry上のClaude Codeでは、現時点でこの機能はサポートされていない。1

AGENTS.mdとは何か

AGENTS.mdは、AIコーディングエージェントにリポジトリ固有の情報を伝えるための、オープンなMarkdown形式の慣例だ。「エージェント向けREADME」と捉えると分かりやすい。プロジェクトの背景、セットアップ手順、ビルド・テストコマンド、コーディング規約、コントリビューション時の注意点などをまとめられる。1932

この形式は、OpenAI Codex、Amp、Google Jules、Cursor、Factoryなどを含む開発エコシステムの協力から生まれ、現在はLinux Foundation傘下のAgentic AI Foundationが管理している。プロジェクト側は、6万超のオープンソースリポジトリで採用されているとしている。1921

対応ツールのエコシステムには、OpenAI Codex、Google Jules、Cursor、GitHub Copilotのコーディングエージェント、Gemini CLI、Aider、Zed、Warp、VS Code、Devin、JetBrains Junie、Factory、Goose、OpenCodeなどが含まれる。ただし、ファイルの探索方法や優先順位はツールごとに異なるため、AGENTS.mdがあるだけで全ツールが同一の挙動になるわけではない。19

実務上のメリット：指示書を一つに寄せやすくなる

従来、共通のAGENTS.mdを採用しているチームがClaude Codeにも同じ指示を渡すには、別途CLAUDE.mdを保守する、AGENTS.mdへのシンボリックリンクを作る、あるいはAGENTS.mdをインポートするだけの小さなCLAUDE.mdを置く、といった回避策が必要だった。以前はClaude CodeがAGENTS.mdをネイティブには読まなかったため、インポートやシンボリックリンクが案内されていた。10

2.1.277のフォールバックにより、Claude固有の指示が不要なリポジトリなら、その追加管理を減らせる。共通のAGENTS.mdを、Claude Codeを含む対応ツール群の基礎ルールとして利用できるからだ。

もっとも、これは各ツールの指示システムが完全に互換になったことを意味しない。ディレクトリ単位の指示をどう探索するか、競合をどう処理するかは、引き続き各コーディングエージェントで確認する必要がある。

AGENTS.mdとSKILL.mdは競合しない

AGENTS.mdとSKILL.mdは、同じものを代替する形式ではなく、用途が異なる。

• AGENTS.md：特定リポジトリで作業する際の常設ガイダンス。プロジェクト全体の文脈とルールを担う。1932
• SKILL.md：再利用可能な「Agent Skill」の一部。指示、メタデータ、必要に応じて補助リソースを含められるファイルシステム上のパッケージで、専門的なワークフローや領域知識を必要な場面で提供する。3337

Claude Codeは、SkillsがクロスツールのAgent Skills標準に従うとしている。Claude Codeのドキュメントでは、プロジェクト用スキルは、たとえば.claude/skills/<name>/SKILL.mdのように、SKILL.mdを含むディレクトリとして構成する。3739

なお残る制約

今回追加されたのは、あくまでプロジェクト指示ファイルのフォールバックだ。すべてのエージェント向け規約との完全な互換性を一度に実現する更新ではない。

特に、Claude Codeで文書化されているプロジェクトスキルの配置先は.claude/skills/<name>/SKILL.mdである。2.1.277の変更告知はAGENTS.mdのプロジェクト指示対応を対象としており、.agents/skills/ディレクトリを探索する機能は告知していない。137

また、このフォールバックをCLAUDE.mdとAGENTS.mdの自動マージ規則と受け取るべきではない。共通ルールとClaude Code固有の挙動を両方必要とするなら、両者の関係を明示しておくのが安全だ。

既存のClaude Codeプロジェクトでの現実的な構成

すでにCLAUDE.mdを運用しているプロジェクトでは、次の分け方が実用的だろう。

1. ツールをまたいで共有したいリポジトリ共通ルールはAGENTS.mdに置く。
2. Claude Code専用の指示はCLAUDE.mdに残す。
3. 共通ルールもClaude Codeに必ず読ませたい場合は、CLAUDE.mdからAGENTS.mdを明示的に参照またはインポートする。両方が自動で読み込まれるとは仮定しない。

この構成なら、ツール間の移植性を確保しつつ、Claude Code専用のワークフローも切り分けられる。Claude Code 2.1.277は、CLAUDE.mdがない場合にAGENTS.md中心のリポジトリをそのまま扱えるようにする、重要な相互運用性の改善といえる。ただし、指示ファイルとスキル探索の規約がすべて同じ挙動になったわけではない。

Claude Code 2.1.277は、オープンなプロジェクト指示ファイル形式であるAGENTS.mdに対応した。標準的な動作では、プロジェクト内にCLAUDE.mdが存在しない場合に、Claude CodeがAGENTS.mdをプロジェクト指示として読む。これにより、複数のAIコーディングツールで共通の指示書を使うリポジトリでも、Claude専用ファイルを先に作成せずClaude Codeを利用しやすくなる。1

基本ルールは「置き換え」ではなくフォールバック

今回の挙動はシンプルだ。

• CLAUDE.mdがないプロジェクト：Claude CodeはAGENTS.mdをプロジェクト指示として利用できる。1
• CLAUDE.mdがあるプロジェクト：従来のCLAUDE.mdがプロジェクト指示ファイルとして扱われる。リリース告知の標準フォールバック動作は、両ファイルを自動的に結合するものとしては説明されていない。1

この動作はClaude Codeの/configにあるProject instructionsから有効化・変更できる。なお、Amazon Bedrock、Google Vertex AI、Azure AI Foundry上のClaude Codeでは、現時点でこの機能はサポートされていない。1

AGENTS.mdとは何か

AGENTS.mdは、AIコーディングエージェントにリポジトリ固有の情報を伝えるための、オープンなMarkdown形式の慣例だ。「エージェント向けREADME」と捉えると分かりやすい。プロジェクトの背景、セットアップ手順、ビルド・テストコマンド、コーディング規約、コントリビューション時の注意点などをまとめられる。1932

この形式は、OpenAI Codex、Amp、Google Jules、Cursor、Factoryなどを含む開発エコシステムの協力から生まれ、現在はLinux Foundation傘下のAgentic AI Foundationが管理している。プロジェクト側は、6万超のオープンソースリポジトリで採用されているとしている。1921

対応ツールのエコシステムには、OpenAI Codex、Google Jules、Cursor、GitHub Copilotのコーディングエージェント、Gemini CLI、Aider、Zed、Warp、VS Code、Devin、JetBrains Junie、Factory、Goose、OpenCodeなどが含まれる。ただし、ファイルの探索方法や優先順位はツールごとに異なるため、AGENTS.mdがあるだけで全ツールが同一の挙動になるわけではない。19

実務上のメリット：指示書を一つに寄せやすくなる

従来、共通のAGENTS.mdを採用しているチームがClaude Codeにも同じ指示を渡すには、別途CLAUDE.mdを保守する、AGENTS.mdへのシンボリックリンクを作る、あるいはAGENTS.mdをインポートするだけの小さなCLAUDE.mdを置く、といった回避策が必要だった。以前はClaude CodeがAGENTS.mdをネイティブには読まなかったため、インポートやシンボリックリンクが案内されていた。10

2.1.277のフォールバックにより、Claude固有の指示が不要なリポジトリなら、その追加管理を減らせる。共通のAGENTS.mdを、Claude Codeを含む対応ツール群の基礎ルールとして利用できるからだ。

もっとも、これは各ツールの指示システムが完全に互換になったことを意味しない。ディレクトリ単位の指示をどう探索するか、競合をどう処理するかは、引き続き各コーディングエージェントで確認する必要がある。

AGENTS.mdとSKILL.mdは競合しない

AGENTS.mdとSKILL.mdは、同じものを代替する形式ではなく、用途が異なる。

• AGENTS.md：特定リポジトリで作業する際の常設ガイダンス。プロジェクト全体の文脈とルールを担う。1932
• SKILL.md：再利用可能な「Agent Skill」の一部。指示、メタデータ、必要に応じて補助リソースを含められるファイルシステム上のパッケージで、専門的なワークフローや領域知識を必要な場面で提供する。3337

Claude Codeは、SkillsがクロスツールのAgent Skills標準に従うとしている。Claude Codeのドキュメントでは、プロジェクト用スキルは、たとえば.claude/skills/<name>/SKILL.mdのように、SKILL.mdを含むディレクトリとして構成する。3739

なお残る制約

今回追加されたのは、あくまでプロジェクト指示ファイルのフォールバックだ。すべてのエージェント向け規約との完全な互換性を一度に実現する更新ではない。

特に、Claude Codeで文書化されているプロジェクトスキルの配置先は.claude/skills/<name>/SKILL.mdである。2.1.277の変更告知はAGENTS.mdのプロジェクト指示対応を対象としており、.agents/skills/ディレクトリを探索する機能は告知していない。137

また、このフォールバックをCLAUDE.mdとAGENTS.mdの自動マージ規則と受け取るべきではない。共通ルールとClaude Code固有の挙動を両方必要とするなら、両者の関係を明示しておくのが安全だ。

既存のClaude Codeプロジェクトでの現実的な構成

すでにCLAUDE.mdを運用しているプロジェクトでは、次の分け方が実用的だろう。

1. ツールをまたいで共有したいリポジトリ共通ルールはAGENTS.mdに置く。
2. Claude Code専用の指示はCLAUDE.mdに残す。
3. 共通ルールもClaude Codeに必ず読ませたい場合は、CLAUDE.mdからAGENTS.mdを明示的に参照またはインポートする。両方が自動で読み込まれるとは仮定しない。

この構成なら、ツール間の移植性を確保しつつ、Claude Code専用のワークフローも切り分けられる。Claude Code 2.1.277は、CLAUDE.mdがない場合にAGENTS.md中心のリポジトリをそのまま扱えるようにする、重要な相互運用性の改善といえる。ただし、指示ファイルとスキル探索の規約がすべて同じ挙動になったわけではない。