説明
AGENTS.mdは、コーディングエージェントをガイドするためのシンプルでオープンなフォーマットで、60,000以上のオープンソースプロジェクトで使用されています。これはエージェントのためのREADMEと考えてください。従来のREADME.mdファイルは、人間の貢献者向けに調整されており、クイックスタート、プロジェクトの説明、貢献ガイドラインを提供します。AGENTS.mdは、ビルド手順、テスト、そしてREADMEを混乱させる可能性のある規約など、コーディングエージェントが必要とする追加の、時には詳細なコンテキストを提供することでこれを補完します。
AGENTS.mdをREADME.mdから分離することには複数の目的があります。これにより、エージェントは指示のための明確で予測可能な場所を持ち、READMEは人間の貢献者に焦点を当てて簡潔であることができ、既存のREADMEやドキュメントを補完する正確なエージェント向けのガイダンスを提供します。別のプロプライエタリファイルを導入するのではなく、AGENTS.mdは誰でも利用できる名前とフォーマットを採用しています。コーディングエージェントを構築または使用していて、このフォーマットが役立つと感じた場合は、採用することをお勧めします。
1つのAGENTS.mdファイルは多くのエージェントで互換性があり、開発者にとって多用途なツールとなります。あなたが作成するエージェント定義は、openai/codex、apache/airflow、temporalio/sdk-java、PlutoLang/Plutoなど、成長するAIコーディングエージェントとツールのエコシステムとシームレスに連携できます。AGENTS.mdを効果的に使用するには、プロジェクトにファイルを追加し、エージェントが効果的に作業できるようにするために重要なセクションを含める必要があります。これらのセクションの人気のある選択肢には、プロジェクトの概要、ビルドおよびテストコマンド、コードスタイルガイドライン、テスト手順、セキュリティに関する考慮事項が含まれます。
AGENTS.mdは、OpenAI Codex、Amp、GoogleのJules、Cursor、Factoryなど、AIソフトウェア開発エコシステム全体の共同作業から生まれました。このフォーマットは現在、Linux Foundationの下でAgentic AI Foundationによって管理されており、使用されるコーディングエージェントに関係なく、開発者コミュニティ全体に利益をもたらすオープンフォーマットとして維持および進化させることを約束しています。
AGENTS.mdの主要機能
オープンフォーマット
複数のエージェントと互換性
コーディングエージェントのための詳細なコンテキスト
ネストされたAGENTS.mdファイルをサポート
プロジェクト固有の指示のためのガイダンス
コミュニティ主導の開発
Agentic AI Foundationによって管理
プロジェクト間のコラボレーションを促進
AGENTS.mdの使い方は？
AGENTS.mdを追加: プロジェクトにAGENTS.mdファイルを含めます。
重要なことをカバー: エージェントがプロジェクトで効果的に作業できるようにするセクションを追加します。
追加の指示を追加: 必要に応じて追加のガイダンスを提供します。
ネストされたファイルを使用: 大規模なモノレポの場合、サブプロジェクト用にネストされたAGENTS.mdファイルを実装します。
AGENTS.mdの使用例
- プロジェクトドキュメント
- オープンソースコラボレーション
- エージェント設定
- テスト手順
- ビルド手順
