論文概要
タイトル: On the Impact of AGENTS.md Files on the Efficiency of AI Coding Agents
論文: arXiv:2601.20404
CodexやClaude CodeなどのAIコーディングエージェントが、ソフトウェアリポジトリに自律的にコントリビュートする場面が増えている。しかし、リポジトリレベルの設定ファイル（AGENTS.md、CLAUDE.md等）がエージェントの運用効率にどう影響するかは、これまでほとんど研究されていなかった。
主な知見
本論文は、AGENTS.mdファイルの有無と内容がエージェントの効率に与える影響を、複数のリポジトリで実証的に分析した。
効率が向上する要因
- ビルド手順の明示: ビルドコマンドやテスト実行方法を明記すると、エージェントの試行錯誤が大幅に減少
- コーディング規約の指定: リンタールール、命名規則を指定すると、修正ループが減少
- 禁止事項の明記: 「このディレクトリは変更しない」等の制約が、不要な変更を防止
効率が低下する要因
- 過度に長いファイル: 情報過多はコンテキストウィンドウを圧迫し、逆効果
- 曖昧な指示: 「良いコードを書く」のような抽象的指示は効果なし
- 古い情報の残存: 実態と乖離した指示がエージェントを迷わせる
個人開発者への示唆
AGENTS.mdは「書けばいい」ではなく「設計する」ものだ。
- 具体的かつ簡潔に: ビルドコマンド、テスト手順、禁止事項を端的に書く
- 定期的に更新: コードベースの変化に合わせてAGENTS.mdも更新する
- 200行以下を目指す: 長すぎるファイルは逆効果。詳細は別ファイルに分離
Claude Codeユーザーなら CLAUDE.md、Codexユーザーなら AGENTS.md の最適化で、日々の開発効率を改善できる。
💡 エキスパートコメント
AI Solo Craft 編集部のエキスパートが、今日のニュースを専門視点で読み解きます。
🎨
デザイナー
AGENTS.mdはエージェントにとっての「オンボーディング文書」ですね。人間の新メンバーに渡すドキュメントと同じ設計原則（明確・簡潔・最新）が当てはまるのは面白い示唆です。
📊
マネージャー
AIエージェントの効率を組織的に最適化する「プロンプトエンジニアリングの次」として、リポジトリ設計の最適化が来ると見ています。この分野の研究が増えるのは良い兆候です。
📋 デスクコメント
📋
シニアデスク
今日やれること: 自分のリポジトリのCLAUDE.md / AGENTS.mdを見直す。「ビルド手順」「テスト方法」「禁止事項」の3点が明記されているか確認し、200行を超えていたら分割を検討しましょう。
実感として、CLAUDE.mdを整備したプロジェクトでは確かにエージェントの出力品質が上がります。特に「禁止事項」の効果は高い。ただし、論文が指摘する「200行の壁」は重要で、私たちも100行超えたら分割するルールを採用しています。