良質な AGENTS.md はモデルのアップグレードに匹敵するが、不適切なものは逆効果となる

概要

AIエージェント向けガイドライン『AGENTS.md』がコード生成の質に与える影響を調査し、性能を最大化するための記述パターンと避けるべき落とし穴を提示している。

詳細内容

Augment Code社による調査で、AIエージェント専用の指示ファイル（AGENTS.md）の最適化が、コード生成の品質を劇的に向上させることが示された。良好なファイルはモデルをHaikuからOpusへアップグレードするのと同等の効果をもたらすが、不適切なファイルは逆に完遂率を30%低下させる。推奨されるパターンは、100〜150行に抑えた「段階的開示」、番号付きの「ワークフロー」、選択を明確にする「決定テーブル」、そして禁止事項に代替案を添える「Do & Don'tのペア」である。逆に、過度なアーキテクチャ解説や解決策のない大量の警告は、エージェントを不要な探索に追い込み、コンテキストの肥大化と混乱を招く。エージェントはAGENTS.mdを優先的に読み込むため、ここをハブとして既存のREADMEやドキュメントを整理することが推奨される。

元記事を読む他のサマリーを見る