AIコーディングエージェントにプロジェクトを正しく理解させたいと思いませんか。AGENTS.mdはAIエージェント向けの指示書フォーマットです。2025年に登場したオープンスタンダードで、GitHub上で2,500以上のリポジトリに採用されています。つまり、AIとの協業を最適化するための新しい標準なのです。

AGENTS.mdに含めるべき6つのコア要素

AGENTS.mdには6つの重要な要素があります。まずは実行可能なコマンドです。具体的には、npm testやnpm run buildなどを記載します。また、テスト方法やプロジェクト構造も含めます。さらに、コードスタイルやGitワークフローも重要です。なお、エージェントが変更してはいけない境界も明示しましょう。

特に重要なのは境界設定です。たとえば、セキュリティ関連のファイルは変更禁止にします。したがって、AIの暴走を防ぐ安全策になります。

AGENTS.mdの書き方ベストプラクティス

行数は150行以下に抑えましょう。実際、短い方がエージェントの処理効率が上がります。また、3層フレームワークの活用が推奨されています。具体的には、「常に実行」「確認が必要」「絶対禁止」の3段階です。

さらに、長い説明より具体的なコード例を優先しましょう。加えて、実行コマンドを冒頭に配置すると効果的です。このように、簡潔で構造化された記述がAIの理解を助けます。

対応ツールとAGENTS.mdの今後

対応するAIツールは増えています。たとえば、GitHub CopilotやOpenAI Codexが対応済みです。また、Factory AIやKilo Codeでも利用できます。しかし、すべてのツールが対応しているわけではありません。

とはいえ、エコシステムは急速に拡大中です。だからこそ、今のうちにAGENTS.mdを書いておくことをおすすめします。むしろ、AIエージェント時代の到来に備えた投資と考えるべきでしょう。