Claude CodeのAGENTS.md非対応が開発者の不満を招く理由

導入

AIコーディングツールの互換性をめぐり、1つのMarkdownファイルが大きな論点になっている。ShopifyのCEOであるTobi Lütke氏は、AnthropicがClaude CodeによるAGENTS.mdの読み取りに対応しない場合、社内での利用を停止する可能性を示した。個人開発者にとっては単なるファイル名の違いに見えるが、数千人の開発者が大規模なmonorepoを扱う企業では、継続的な「複雑性コスト」になり得る。

問題の構造

AGENTS.mdとCLAUDE.mdは、コーディングエージェントにリポジトリのルールを伝えるための指示ファイルだ。ビルドやテストのコマンド、コーディング規約、操作上の制約などを記述できる。エージェントは作業対象のディレクトリに応じて、ディレクトリツリー上の関連ファイルを読み込み、より近い場所にあるルールを優先する設計を取る。

AGENTS.mdはOpenAIが2025年に導入し、Codex、Cursor、Gemini CLI、GitHub Copilot、Jules、VS Codeなどが対応している。現在はLinux Foundation傘下のAgentic AI Foundationに移管された。一方、Claude CodeはCLAUDE.mdを採用し、AGENTS.mdを標準では読み取らない。そのため、同じディレクトリでも、あるツールには十分な指示が届くのに、Claude Codeには重要な文脈が欠ける可能性がある。

大規模なコードベースでは、手作業による対応は簡単ではない。チームはCLAUDE.mdからのインポート、シンボリックリンク、再帰検索スクリプト、ファイル監視、起動設定、Gitの除外ルールなどを組み合わせ、2つの形式を同期させる必要がある。素材では、fswatchとlaunchdを使うMac向けの回避策も紹介されている。動作はしても、ツールの非互換性を補うために追加の基盤を運用することになる。

Anthropicの説明と反発

Claude CodeチームのThariq氏は、カスタマイズ性を高め、AGENTS.mdの利用やシステムプロンプトの変更を容易にする方向だと説明した。現時点では、CLAUDE.mdに「@AGENTS.md」と記述して読み込ませる方法が案内されている。ただし、他のツールのようにAGENTS.mdを自動検出するのかは明言されていない。

Anthropicは、モデルごとに必要なコンテキストやSkill、システムプロンプトが異なると説明している。これに対し開発者は、企業がすでに複数モデルを使っており、モデルごとに別の指示ファイルを維持すれば、適応コストが利用者側へ移ると指摘する。モデル別の調整はハーネス側で行い、リポジトリには共有ルールを置く方が現実的だという考えだ。

意味すること

争点は、どのファイル名が優れているかだけではない。互換性の不足による負担を誰が引き受けるのかが本質である。個人ならリンクやインポートで対応できても、企業では指示ファイルが共有資産になる。どのルールが適用されたかの可視化、再帰的な読み込み、複数ツール間の一貫性は、製品側が提供すべき機能だ。

Claude Code固有の拡張としてCLAUDE.mdを残しつつ、共通レイヤーとしてAGENTS.mdを標準対応することが、より摩擦の少ない道筋だろう。そうでなければ、この問題は単なる形式論ではなく、単一ツールのために別のエコシステムを維持するのかという議論になっていく。

出典：InfoQ 中文