はじめに
近年、Claude、Cursor、Gemini in Android Studio、Devin など、さまざまな AIコーディングエージェント が開発者のワークフローに組み込まれるようになっています。しかし、各ツールが独自の設定ファイル（例：CLAUDE.md や .cursor/rules）を要求するため、同じような内容を複数ファイルに書き分ける非効率 が課題となっていました。
その解決策として登場したのが AGENTS.md です。
OpenAIが中心となって提案
AGENTS.md のフォーマットは、OpenAI が中心となって提案・公開 したものです。公式サイトは OpenAI が運営しており、ライセンスは MIT License で公開されています。
公式サイト:
- AGENTS.md
https://agents.md/ - GitHubリポジトリ
ライセンス：MITライセンス
https://github.com/openai/agents.md
AGENTS.mdとは？
AGENTS.md は、AIコーディングエージェントが プロジェクトを理解し、正しく動作するためのルールや手順をまとめる統一フォーマット です。
README.md が人間向けであるのに対し、AGENTS.md は AI向けのREADME と考えるとわかりやすいでしょう。
記載される内容の例
- 環境構築手順（依存関係のインストール、ツールのセットアップ）
- テストの実行方法（例:
npm test、pytestなど） - コードスタイルやLintルール
- ビルド・デプロイ手順
- PR / コミット規約
これにより、エージェントはファイルを読み込むだけで「このプロジェクトをどう扱えばよいか」を理解できます。
なぜ必要なのか？
複数エージェント対応の標準化
従来は CLAUDE.md（Claude用）、.cursor/rules（Cursor用）、GEMINI.md（Gemini用）などが乱立していました。
→ AGENTS.md にまとめることで、どのエージェントでも共通して参照可能 にする仕組みです。Codex・Cursor・VSCode・RooCode・Gemini・Kilo Code・Android Studio・GitHub Copilot、オープンソースなどが順次導入しています。
保守性の向上
ルールや手順を一箇所に集約できるため、ドキュメント更新の手間が減り、チーム全体やAIエージェントとの連携がスムーズになります。
自動化との親和性
CI/CD や LLMエージェントの自動化が進む中で、「AGENTS.md のルールを読み込んでタスクを自動実行する」ワークフローが可能になります。
主要なAIエージェント一覧（AGENTS.mdに対応）
| ツール / エージェント | 公式リンク |
|---|---|
| Codex (from OpenAI) | openai.com |
| Amp | ampcode.com |
| Jules (from Google) | jules.google |
| Cursor | cursor.com |
| Factory | factory.ai |
| RooCode | roocode.com |
| Aider | aider.chat |
| Gemini CLI (from Google) | Gemini github.com |
| Kilo Code | kilocode.ai |
| opencode | opencode.ai |
| Phoenix | phoenix.new |
| Zed | zed.dev |
| Semgrep | semgrep.dev |
| Warp | docs.warp.dev |
| Coding agent (from GitHub Copilot) | github.com coding-agent |
| VS Code | code.visualstudio.com |
| Ona | ona.com |
| Devin (from Cognition) | devin.ai |
Android Studio (Gemini)
- Narwhal 4 Feature Drop Canary 4 以降で
AGENTS.mdを公式サポート - Android Developers: Customize Gemini using AGENTS.md files
https://developer.android.com/studio/gemini/agent-files
オープンソースプロジェクト
- すでに 20,000以上のGitHubリポジトリ で
AGENTS.mdが使われているとの報告があります。 - InfoQ: AGENTS.md adoption
https://www.infoq.com/news/2025/08/agents-md/
CLAUDE.mdとの違いと併用（2025年9月19日現在）
Anthropic の Claude は専用ファイル CLAUDE.md を読み込みます。
現状では Claude が AGENTS.md を完全サポートしている公式情報はなく、Claude を利用する場合は 両方を併用 するのがおすすめです。
- Claude 専用 →
CLAUDE.md - 複数エージェント対応 →
AGENTS.mdを基本に、Claude 用にCLAUDE.mdを補助的に配置
サンプル：AGENTS.md のテンプレート
# Sample AGENTS.md file
## Dev environment tips
- Use `pnpm dlx turbo run where <project_name>` to jump to a package instead of scanning with `ls`.
- Run `pnpm install --filter <project_name>` to add the package to your workspace so Vite, ESLint, and TypeScript can see it.
- Use `pnpm create vite@latest <project_name> -- --template react-ts` to spin up a new React + Vite package with TypeScript checks ready.
- Check the name field inside each package's package.json to confirm the right name—skip the top-level one.
## Testing instructions
- Find the CI plan in the .github/workflows folder.
- Run `pnpm turbo run test --filter <project_name>` to run every check defined for that package.
- From the package root you can just call `pnpm test`. The commit should pass all tests before you merge.
- To focus on one step, add the Vitest pattern: `pnpm vitest run -t "<test name>"`.
- Fix any test or type errors until the whole suite is green.
- After moving files or changing imports, run `pnpm lint --filter <project_name>` to be sure ESLint and TypeScript rules still pass.
- Add or update tests for the code you change, even if nobody asked.
## PR instructions
- Title format: [<project_name>] <Title>
- Always run `pnpm lint` and `pnpm test` before committing.出典：https://github.com/openai/agents.md
まとめ
AGENTS.mdは AIエージェントのためのREADME- Android Studio (Gemini)、Devin などが公式対応
- 今後は
CLAUDE.mdや.cursor/rulesの代替として普及が期待される CLAUDE.mdは現時点で公式にサポートしていないため、CLAUDE.mdファイルは併用する
プロジェクトに AIエージェントを導入している場合は AGENTS.md を用意しておくと、将来的にスムーズに対応できます。
コメント