AIにコードを書かせるたび、私は同じ前提を毎回説明していました。
「うちはこのフレームワーク」「命名はこう」「テストはこれで回す」——その繰り返しは地味に消耗します。
それを1つのファイルに畳んで渡す約束が AGENTS.mdです。
この記事では、AGENTS.md が何で、なぜ標準になり、どう腐らせず運用するかを整理します。
AGENTS.md とは
AGENTS.md は、AIコーディングエージェントに渡す「プロジェクトの取扱説明書」です。
使う技術・コーディング規約・ビルドやテストの手順といった前提を、決まった場所にまとめておく。
エージェントは作業前にこれを読み、いちいち探り直さずに文脈をつかめます。
言い換えると、毎回のチャット指示を 使い回せる資産に変える仕組みですね。
なぜ「標準」になったのか
同じ発想のファイルは、ツールごとにバラバラの名前で増えていました。
CLAUDE.md、各種 rules、memories——中身は似ているのに作法が違う、という状態。
そこで共通フォーマットとして AGENTS.md が広がり、GitHub Copilot は2025年8月に対応しました。
いまは OpenAI Codex・Cursor・Google の Gemini 系など、主要ツールが軒並み読めるようになっています。
2025年12月には MCP と同じ Linux Foundation 傘下の団体へ移管され、一企業のものではなくなりました（参考: Agentic AI Foundation の発足）。
何を書くか
盛りすぎると逆に読まれないので、要点を絞るのがコツです。
- 技術スタックと前提（言語・フレームワーク・パッケージ管理）
- コーディング規約（命名・整形・禁止事項）
- ビルド／テスト／実行のコマンド
- 触ってほしくない場所や注意点
「新メンバーが最初に読む README」を、AI向けに書く感覚に近い。
作って終わりにしない（継続更新）
AGENTS.md の価値は、書いた瞬間ではなく更新し続けることで保たれます。
規約やコマンドが変わったら、コードと一緒に AGENTS.md も直す。
レビューで「ここ AGENTS.md に追記しておこう」と拾う癖をつけると、内容が腐りません。
CI やテンプレートで存在チェックを挟むのも、形骸化を防ぐ地味に効く一手です。
.cursorrules や CLAUDE.md との違い・使い分けは、別記事で詳しく比べています。
最後に
AGENTS.md は、AIに「うちの流儀」を一度だけ教えるための場所です。
派手な機能ではないぶん、効果は毎回の指示が軽くなる形で返ってくる。
まずは数行のスタックと規約から書き始めれば十分だと思います。
以上です。
コメントを残す