AGENTS.mdとは

OpenAI CodexやCursorなど複数のAIコーディングツールが共通して読み込める、リポジトリ向けの標準指示ファイル形式

ひとことで言うと

どのAIコーディングツールを使っても同じ内容を読み込ませられるよう決めた、共通の指示ファイル形式。

概要

AGENTS.mdは、OpenAIが中心となりCursorやFactory等複数の企業が賛同して策定した、AIコーディングエージェント向けの共通指示ファイル形式。 ビルド・テストコマンド、コーディング規約、ディレクトリ構成といった内容を1つのファイルにまとめておくことで、Claude Code・Codex・Cursorなど複数のツールを併用する場合でも同じ指示ファイルを参照できるようにする。 CLAUDE.mdのような特定ベンダー専用の指示ファイルが乱立する状況に対し、ツール間の相互運用性を確保することを狙いとしている。

背景

コーディングエージェント/AI IDEの普及に伴い、ツールごとに異なる指示ファイル形式(CLAUDE.md等)が乱立し、複数ツールを併用する開発者が同じ内容を重複して管理する負担が生じていた。AGENTS.mdは、この重複を解消する共通フォーマットとして提案された。

歴史

2025年: OpenAIがCursor・Factory等と共同で、AIコーディングエージェント共通の指示ファイル規格「AGENTS.md」を公開。

利点

• 複数のAIコーディングツールを併用しても、指示ファイルを1つに集約できる
• オープンな仕様であり特定ベンダーに依存しない

欠点

• ツールによってはAGENTS.mdへの対応が不十分だったり、独自形式(CLAUDE.md等)と併存させる必要がある
• 策定されて間もなく、記法や運用の実務的な定着はこれからの段階

比較

• CLAUDE.md — CLAUDE.mdがClaude Code専用の指示ファイルであるのに対し、AGENTS.mdは複数ツールで共通利用できる形式を目指す

関連用語

よくある質問

参考文献

• Official WebsiteAGENTS.md