エージェント指示ファイル(AGENTS.md)
エージェント指示ファイル(agent instructions file)とは、AGENTS.md や CLAUDE.md など、コードリポジトリに置く Markdown ファイルです。コーディングエージェントはセッションの開始時にこれを読み、プロジェクトのコマンド、規約、ルールを把握します。
別名: AGENTS.md, CLAUDE.md, .cursorrules, rules file
執筆 Divya Sharma · 2026年11月15日確認 · レビューの方法
コーディングエージェントは、毎回のセッションをプロジェクトについて何も知らない状態で始めます。手がかりがなければ、テストの実行方法、従うべきスタイル、触れてはいけないフォルダーを推測するしかありません。指示ファイルは、エージェントが必ず読む場所で、こうした疑問に一度で答えます。
よく使われる形式
AGENTS.md はツールをまたいで使えることを目指したオープンな形式で、OpenAI Codex をはじめ多くのツールが読み込みます。Claude Code は CLAUDE.md を読み、AGENTS.md も使えます。Cursor には、以前の .cursorrules を含む独自のルールファイルがあります。内容はどれも似ていて、ビルドとテストのコマンド、コードスタイル、アーキテクチャのメモ、してはいけないことなどです。
仕組み
エージェントはセッションの開始時にこのファイルをコンテキストに読み込むので、プロジェクト単位のシステムプロンプトのように働きます。ファイルは入れ子にできます。モノ レポならルートに 1 つ、各パッケージにもう 1 つ置けます。AGENTS.md の指針では、編集するコードに最も近いファイルが優先され、チャットで入力した指示はそのすべてに優先します。ホームフォルダーに置く個人用のファイルには、すべてのプロジェクトに適用するルールを書けます。
限界
このファイルはコンテキストであり、強制力はありません。エージェントは通常これに従いますが、特にコンテキスト圧縮の後には無視したり忘れたりすることがあります。本番の設定ファイルに絶対に触れないなど、常に守るべきルールはエージェントフックや権限の設定に置くべきです。ファイルは短く具体的にしてください。長いファイルは毎回のセッションでトークンを消費し、重要なルールを埋もれさせます。再利用する手順はエージェントスキルのほうが適しています。
関連用語
- コーディングエージェント
- コーディングエージェント(coding agent)とは、人が貼り付けるコードを提案するだけでなく、ソフトウェアに直接取り組む AI エージェントです。コードベースを読み、ファイルを編集し、コマンドとテストを実行し、変更が動くまで繰り返します。
- コンテキストエンジニアリング
- コンテキストエンジニアリング(context engineering)とは、タスクの間に言語モデルのコンテキストウィンドウに入るすべてのもの、つまり指示、取得した文書、ツールの定義、ツールの結果、会話の履歴を選び、管理する取り組みです。
- エージェントスキル
- エージェントスキル(agent skills)とは、指示、スクリプト、参考ファイルをまとめたフォルダーで、それぞれが SKILL.md ファイルで説明されています。AI エージェントはこれを見つけ、タスクに必要なときだけ読み込みます。
- エージェントフック
- エージェントフック(agent hooks)とは、ツール呼び出しの直前やファイル編集の直後など、作業中の決まった時点でコーディングエージェントが自動的に実行する、ユーザー定義のコマンドやスクリプトです。エージェントの動作を確認、阻止、拡張するために使います。
- システムプロンプト
- システムプロンプト(system prompt)とは、アプリケーションがユーザーのメッセージより前に言語モデルに送る指示のまとまりです。会話全体を通じたモデルの役割、ルール、口調、出力形式を設定します。
- スラッシュコマンド
- スラッシュコマンド(slash command)とは、/compactや/reviewのように先頭にスラッシュを付けて入力する指示で、AIツールにテキストを通常のメッセージとして扱わず、組み込みの操作や保存済みのプロンプトを実行させるものです。