この記事は、/init を実行して AGENTS.md ファイルを自動生成することに反対する。自動生成されたコンテキストファイルは、エージェントがリポジトリを読めばすでに発見できる内容をほとんど重複して記述しているだけであり、結果を改善することなくコストを増やす、というのがその根拠である。記事は一見正反対の結果を示す 2026 年の 2 本の論文を対比し、その違いはファイルに実際に何が書かれているかに帰着すると論じる。発見不可能で運用上重要な事実を人間が記録したファイルは役立つが、LLM が生成したコードベースの概要は冗長なノイズにすぎない。
さらに記事は、よく書かれた冗長でない AGENTS.md であっても、動的なタスクに適用される静的なファイルであることに変わりはないと論じ、3 層からなる代替アーキテクチャ（最小限のルーティング用「プロトコル」ファイル、選択的に読み込まれるタスク単位のペルソナ／スキルファイル、そしてプロトコルファイルを正確に保つメンテナンス用サブエージェント）を提案する。一方で、これを構築するのに必要なライフサイクルフックを公開している主要なコーディングエージェントはまだ存在しないことも指摘している。
要点
- 記事で紹介されている対照実験（Lulla et al.、ICSE JAWs 2026、実際の GitHub プルリクエスト 124 件）では、他の条件をすべて一定にしたうえで
AGENTS.mdファイルが存在すると、実時間の実行時間の中央値が 28.64%、出力トークン消費量が 16.58% 減少した。ただし記事は、この研究が測定したのは効率だけであり、出力の正しさは測定していないと指摘している。 - 記事で紹介されている別の研究（ETH Zurich によるもので、4 つのエージェントを SWE-bench と独自のベンチマークで評価）では、LLM が生成したコンテキストファイルはタスクの成功率を 2〜3% 低下させつつコストを 20% 超増加させた。一方、開発者が書いたファイルは成功率を約 4% 向上させ、コストの増加は最大 19% だった。
- 記事によれば、ETH Zurich の研究では、テスト対象のリポジトリから既存のドキュメントをすべて取り除いたところ、同じ LLM 生成のコンテキストファイルが今度は性能を 2.7% 向上させた。これは、自動生成された内容が無用なのではなく、エージェントが本来なら自分で見つけられるドキュメントと重複しているだけだ、という主張の根拠として用いられている。
- 記事は ETH Zurich の研究の知見として、開発者が書いたファイルでツール
uvに言及していた場合、エージェントはタスクあたり平均 1.6 回それを使用したが、言及がない場合は 0.01 回未満だったことを紹介している。これは、ファイルに書くべきもの — エージェントが他の方法では推論できず、慣例から推測もできない情報 — の具体例として示されている。 - 「アンカリング効果」についても説明されている。
AGENTS.mdである技術に触れると、たとえついでの言及であっても、その技術はすべてのプロンプトでモデルのコンテキストに残り続ける。その技術がもはや現在の慣例でない場合、エージェントを古いパターンへと偏らせうる。 - 記事は ETH Zurich の研究の知見として、あるモデルが自動生成したコンテキストファイルの 100%、別のモデルのものの 99% がコードベースの概要で構成されていたことを紹介している。記事はこれを、エージェントがすでに自力で発見できる内容だと論じる。
- Agentic Context Engineering（ACE、ICLR 2026）は、コンテキストを generator／reflector／curator のパイプラインによって維持される進化するプレイブックとして扱うフレームワークとして引用されており、エージェントのベンチマークで静的なコンテキスト手法を 12.3% 上回ったと報告されている。
- Arize AI が Claude.md の指示に対して行ったプロンプト学習による最適化の結果も引用されている。エージェントを実行し、その出力を評価し、失敗から指示を改良する自動ループによって、リポジトリ横断のテスト分割で +5.19%、リポジトリ内の分割で +10.87% の精度向上が報告されている。
- 記事は単一の巨大な
AGENTS.mdに代わる 3 層構成を提案する。最小限のルーティング用「プロトコル」ファイル、タスクの種類に応じて選択的に読み込まれる焦点を絞ったペルソナ／スキルファイル、そしてコードベースの変化に合わせてプロトコルファイルを正確に保つことを役目とするメンテナンス用サブエージェントである。ただし、これをきれいに構築するのに必要なライフサイクルフックを公開している主要なコーディングエージェントは現時点では存在しないことも指摘している。
背景
記事は効率と正しさに関する主張について、名前を挙げた 2026 年の 2 本の論文（ICSE JAWs での Lulla et al. の論文と、それとは別の ETH Zurich の研究）に明示的に依拠しており、どちらの論文も、記事がその後で提案する階層的で動的に読み込まれるアーキテクチャを検証してはいないとはっきり述べている。その 3 層アーキテクチャは著者自身の発明としてではなく、AGENTS.md をめぐる議論の中で複数の人が独立にたどり着いたアイデアとして示されている。つまり、いずれかの論文が測定したものではなく、記事が報告し整理したものである。