詳細内容
## AGENTS.md
https://agents.md/
AGENTS.mdは、AIコーディングエージェントがプロジェクト内で効果的に機能するためのコンテキストと指示を提供する、シンプルでオープンなMarkdown形式を定義します。
**Content Type**: Technical Reference
**Scores**: Signal:5/5 | Depth:4/5 | Unique:5/5 | Practical:5/5 | Anti-Hype:5/5
**Main Journal**: 95/100 | **Annex Potential**: 96/100 | **Overall**: 96/100
**Topics**: [[AIコーディングエージェント, 開発ワークフロー改善, オープンフォーマット, プロジェクト設定, モノレポ対応]]
「AGENTS.md」は、AIコーディングエージェントがプロジェクト内で効果的に機能するためのコンテキストと指示を記述するための、シンプルでオープンなMarkdown形式を提案しています。これは、人間向けの概要やコントリビューションガイドラインを記載する「README.md」とは異なり、エージェントがコードを理解し、適切に作業を進めるために必要な詳細情報(例:依存関係のインストールコマンド、開発サーバーの起動方法、テストの実行方法、厳格なTypeScriptモードやシングルクォートといったコードスタイル規約など)を明示的に提供することを目的としています。
このフォーマットの重要性は、まずエージェントに予測可能で一貫した指示場所を提供し、多様なAIコーディングエージェント(OpenAI Codex、Google Jules、Cursorなど)が共通の定義に基づいて動作できる点にあります。これにより、開発者は「README.md」を人間向けに簡潔に保ちつつ、エージェントに対して詳細かつ具体的なガイダンスを提供できます。例えば、`pnpm install`や`pnpm test`といった特定のコマンド、Vitestを用いたテストの絞り込み方、PRタイトルのフォーマットなどが具体的に記述されています。
さらに、プロジェクトのルートだけでなく、モノレポ内のサブプロジェクトごとにネストされた「AGENTS.md」ファイルを使用することで、エージェントは編集対象のファイルに最も近い指示を読み込み、よりきめ細やかな挙動を実現できます。これは、大規模なリポジトリにおけるAIエージェントの適用性を大幅に向上させます。結果として、開発ワークフローの効率化、AIによるコード品質の一貫性維持、そして新規参加者がプロジェクトの技術的慣習を素早く把握できるよう支援し、ジェネレーティブAI時代の開発基盤を強化する重要な一手となるでしょう。