AGENTS.mdの書き方と例
AGENTS.mdとは、コーディングエージェントにプロジェクトの指示を渡すためのファイルです。書き方の基本は、毎回当てはまる事実だけを書くことです。たとえば、テストのコマンド、ソースのフォルダー、自動生成されたファイルの扱いのルールです。特定のバグの報告のような、そのタスクだけの内容はタスクの指示に書きます。そうしないと、一時的な話がずっと残る指示になってしまいます。
短い例
架空の配送のアプリケーションなら、次のような短い項目が考えられます。「注文のロジックはsrc/ordersにある。変更したら注文のテストを実行する。公開しているレスポンスの項目は変えない。顧客のレコードをプロンプトにコピーしない。」どの文も、書いておかなければエージェントが推測するしかない判断を表しています。
範囲と強制
Codexは、リポジトリのルートから作業ディレクトリまでの経路にある指示ファイルを見つけます。上書きの仕組みとサイズの上限は、公式のAGENTS.mdのガイド(英語)に書かれています。この内容は2026年11月14日に確かめました。ほかのツールは同じファイルを違う形で読み込むことがあるので、ツールごとのドキュメントを確かめてください。
書いた指示だけでは、プロセスが秘密の情報を読んだり、ネットワークにアクセスしたりするのは防げません。指示はアクセスの制御と組み合わせます。サンドボックスと権限で境界を練習し、別の形式のCLAUDE.mdのガイダンスと比べてみてください。