AGENTS.mdジェネレーター
フォームに入力して、コマンド、規約、厳守すべき制約を記載したAGENTS.mdを作成できます。さらに、Cursor、GitHub Copilot、Claude Code、Cline、Devin Desktop向けに同じパススコープルールを出力し、AGENTS.mdを標準では読み込まないツール向けのブリッジファイルも作成します。
# Acme ウェブアプリ
顧客向けのウェブアプリです。管理画面と小規模な REST API を備えています。
## 技術スタック
Next.js, React, TypeScript, pnpm
## コマンド
- インストール: `pnpm install`
- ローカルで実行: `pnpm dev`
- テスト: `pnpm test`
- Lint・型チェック: `pnpm lint && pnpm tsc --noEmit`
- ビルド: `pnpm build`
## コードスタイル
- リンターが強制するフォーマットに従い、変更しないファイルには手を加えないでください。
- 入出力が明確な小さな関数を優先し、副作用は境界部分にまとめてください。
- 依存関係を追加する前に確認してください。
- 自明でないコードには、各行の処理内容ではなく、その理由をコメントしてください。
## テスト
- 変更した動作ごとにテストを追加または更新してください。
- 完了を報告する前にテストコマンドを実行し、失敗を修正してください。
- テストをすべて成功させるために、失敗したテストを削除したりスキップしたりしないでください。
## コミットとプルリクエスト
- コミットの件名は命令形で、72文字未満にしてください。
- 各プルリクエストの変更は1つに絞り、説明にテスト方法を記載してください。
- コミットの前に必ず lint とテストを実行してください。
## 禁止事項
- シークレット、API キー、.env ファイルをコミットしないでください。
- src/generated/ 以下の生成ファイルを手動で編集せず、代わりに再生成してください。
- 本番環境に対して破壊的なデータベースコマンドを実行しないでください。
- main への force-push や、共有履歴の書き換えをしないでください。
5つのツールで使える同じルール
---
description: この glob に一致するファイルに適用する規約
globs: app/**/*.tsx
alwaysApply: false
---
このフォルダー内の近接するファイルですでに使われているパターンに従ってください。エクスポートする関数にはすべて docstring を付け、対応するテストファイルにテストを追加してください。
---
applyTo: "app/**/*.tsx"
---
このフォルダー内の近接するファイルですでに使われているパターンに従ってください。エクスポートする関数にはすべて docstring を付け、対応するテストファイルにテストを追加してください。
---
paths:
- "app/**/*.tsx"
---
このフォルダー内の近接するファイルですでに使われているパターンに従ってください。エクスポートする関数にはすべて docstring を付け、対応するテストファイルにテストを追加してください。
---
paths:
- "app/**/*.tsx"
---
このフォルダー内の近接するファイルですでに使われているパターンに従ってください。エクスポートする関数にはすべて docstring を付け、対応するテストファイルにテストを追加してください。
---
trigger: glob
globs: app/**/*.tsx
---
このフォルダー内の近接するファイルですでに使われているパターンに従ってください。エクスポートする関数にはすべて docstring を付け、対応するテストファイルにテストを追加してください。
使いやすい指示ファイルにするには
正確なコマンドを冒頭に記載する
実際に使うインストール、テスト、lintのコマンドを、フラグも含めてファイルの冒頭に記載してください。技術スタックとバージョンを正確に示し、文章だけでは曖昧になる場合は短いコード例を添えてください。
禁止事項を明確に書く
秘密情報、vendorコード、本番環境など、エージェントが触れてはならないものを明記してください。GitHubが調査したファイルでは、「秘密情報をコミットしない」が最もよく見られた有用な制約でした。
各指示を検証可能にする
「コミット前に npm test を実行する」は検証できますが、「変更をテストする」では検証できません。指示が矛盾しないようにしてください。2つの記述が食い違うと、モデルはどちらに従うかわかりません。
簡潔にし、パスごとに分ける
Anthropicはファイルあたり200行未満、Cursorはルールあたり500行未満を推奨しています。特定の領域に関する指示は、パスを指定したルールに移し、対象のファイルを扱うときだけ読み込まれるようにしてください。インポートはファイルを整理できますが、コンテキストのコストは減りません。
エージェントがすでに知っていることは省く
4つのコーディングエージェントを対象とした研究では、コンテキストファイルを追加してもタスクの成功率は安定して向上せず、推論コストが20%を超えて増加しました。LLMが作成したファイルはわずかに逆効果で、リポジトリの概要も役立ちませんでした。特定のツールなど、自明ではない要件に絞って記載してください。
同じミスが繰り返されたらルールを追加する
最初は最小限にし、エージェントが同じミスを複数回繰り返したらルールを追加してください。スタイルガイド全体を貼り付けるのではなく、手本となる既存のファイルを参照してください。
AGENTS.mdに関するよくある質問
Claude CodeはAGENTS.mdを読み込みますか？
はい。v2.1.277から対応しています。デフォルトでは、作業ディレクトリまたはその親ディレクトリにCLAUDE.md、.claude/CLAUDE.md、CLAUDE.local.mdのいずれもない場合に限り、AGENTS.mdまたは.claude/AGENTS.mdを読み込みます。claude-md-and-agents-md設定を使うと両方を読み込みます。また、CLAUDE.mdに@AGENTS.mdを記述すれば、どのバージョンでも読み込めます。
AGENTS.mdにfrontmatterや特定の見出しは必要ですか？
いいえ。AGENTS.mdは必須項目のない通常のMarkdownファイルで、見出しも自由に設定できます。agents.mdのサイトでは、プロジェクト概要、ビルドとテストのコマンド、コードスタイル、テスト、セキュリティに関する注意事項、プルリクエストのガイドラインなどのセクションを提案しています。
モノレポでAGENTS.mdを使うにはどうすればよいですか？
ルートにAGENTS.mdを1つ置き、独自のルールが必要な各パッケージにも配置してください。エージェントは編集対象のコードに最も近いファイルを読み込み、指示が競合する場合はそのファイルの内容が優先されます。agents.mdがこのことを記録した時点で、OpenAIのメインリポジトリには88個のAGENTS.mdがありました。
Gemini CLIにAGENTS.mdを読み込ませるにはどうすればよいですか？
Gemini CLIのデフォルトでは、引き続きGEMINI.mdが読み込まれます。.gemini/settings.jsonのcontext.fileNameにAGENTS.mdを追加してください。例: ["AGENTS.md", "GEMINI.md"]。/memory showを実行すると、読み込まれたファイルを確認できます。
AGENTS.mdに対応しているコーディングエージェントはどれですか？
OpenAI Codex、Claude Code、Cursor、GitHub Copilot、Devin Desktop、Cline、OpenClawのドキュメントを確認したところ、いずれも標準で読み込むことがわかりました。Gemini CLIとAiderでは、設定を1行追加する必要があります。agents.mdのサイトには、Zed、Warp、goose、opencode、Jules、JetBrains Junieなど、合計23の対応ツールが掲載されています。
AGENTS.md形式は誰が管理していますか？
OpenAIはAGENTS.mdをAgentic AI Foundationに寄贈しました。同財団は、MCPとgooseとともに2025-12-09に発表された、Linux Foundationの管理下にある基金です。agents.mdのサイトによると、6万以上のオープンソースプロジェクトがAGENTS.mdを使用しています。