論文の概要
論文: On the Impact of AGENTS.md Files on the Efficiency of AI Coding Agents
arXiv ID: 2601.20404(2026年1月投稿、3月30日更新)
AIコーディングエージェントに渡す「リポジトリレベルの指示ファイル(AGENTS.md)」が実際にエージェントの動作効率を高めるかどうかを実験的に検証した研究。
何がわかったか
AGENTS.mdを適切に整備することで:
- 試行錯誤の回数が減る — エージェントが「何をすべきか」を迷わずに着手できる
- タスク完了率が向上する — 最初の指示に沿った実装が行われる確率が高まる
- 設定・デプロイの明確化が特に効果的 — コーディング規約、テスト手順、環境設定の記述が最も貢献度が高い
論文では「リポジトリレベルの指示がエージェントの行動・効率・統合をどう形成するか」という研究アジェンダとして位置づけている。
AGENTS.mdとは
AGENTS.mdはリポジトリのルートに置くマークダウンファイルで、AIコーディングエージェントに向けた指示を書く。内容の例:
# エージェントへの指示
## プロジェクト概要
Next.js + TypeScriptで構築したSaaSアプリ
## コーディング規約
- 型定義はinterfaceを使う
- コンポーネントはfunction宣言
- テストはVitest
## よく使うコマンド
- npm run dev: 開発サーバー起動
- npm run test: テスト実行
- npm run build: ビルド
## 注意事項
- .env.localは編集不要
- src/lib/supabase.tsは変更しない
個人開発者への示唆
Cursor 3の並列エージェント、Claude Code、OpenAI Codexなど、複数のエージェントを使いこなす時代になっている。この論文の知見が示すのは「ツールの選択と同じくらい、リポジトリの整備が重要」という点だ。
特に以下の状況でAGENTS.mdの効果が出やすい:
- 同じリポジトリを繰り返しエージェントに触らせる
- Cursor 3のように複数エージェントを並列で走らせる
- 長期的なプロジェクトでエージェントを継続的に活用する
AGENTS.mdは5分で書けて、エージェントとの作業効率を上げる即効性のある投資だ。
一次ソース: arxiv.org/abs/2601.20404