メインコンテンツへスキップ
AGENTS.md ファイルは、プロジェクト内の配置場所に応じて自動的に適用される、前提情報に応じた指示を Cascade に与えるシンプルな方法です。これは、ディレクトリごとのコーディングガイドライン、アーキテクチャ上の判断、プロジェクトの規約を与える場合に特に役立ちます。

仕組み

AGENTS.md ファイル (または agents.md) を作成すると、Devin Desktop が自動的にそれを検出し、.devin/rules/ (およびレガシーな .windsurf/rules/) と同じ ルール エンジンに取り込みます。異なるのは、適用モードが frontmatter ではなくファイルの場所から推定される点です。
  • ルートディレクトリ: 常時適用 のルールとして扱われ、内容全体が毎回のメッセージで Cascade のシステムプロンプトに含まれます。
  • サブディレクトリ: <directory>/** という自動生成パターンを持つ glob ルールとして扱われ、その内容は Cascade がそのディレクトリ内のファイルを読み取るか編集する場合にのみ適用されます。
このように場所に基づいてスコープが決まるため、AGENTS.md は単一のグローバル設定ファイルを煩雑にせず、必要な範囲に絞ったガイダンスを提供するのに適しています。

AGENTS.md ファイルの作成

対象のディレクトリに、AGENTS.md または agents.md という名前のファイルを作成するだけです。このファイルはプレーンな Markdown で記述し、特別な frontmatter は必要ありません。

構成例

以下は、React コンポーネント用ディレクトリの AGENTS.md ファイルの例です。

検出とスコープの決定

Devin Desktop は、ワークスペース全体にある AGENTS.md ファイルを自動的に検出します。
  • ワークスペースのスキャン: ワークスペース内およびそのサブディレクトリ内にあるすべての AGENTS.md ファイルが検出されます
  • Git リポジトリのサポート: Git リポジトリの場合、Devin Desktop は親ディレクトリも Git ルートまで検索します
  • 大文字と小文字を区別しない: AGENTS.mdagents.md の両方が認識されます

自動スコープ

AGENTS.md の主な利点は、ファイルの場所に応じて自動的にスコープが決まることです。 つまり、異なる階層に複数の AGENTS.md ファイルを配置でき、それぞれのディレクトリに対して、より具体的なガイダンスを段階的に提供できます。

ベストプラクティス

AGENTS.md ファイルを最大限に活用するため、次の点を意識してください。
  • 指示は要点を絞る: 各 AGENTS.md には、そのディレクトリの目的に関連する指示だけを記載してください
  • 書式をわかりやすくする: 箇条書き、見出し、コードブロックを使うと、Cascade が指示を理解しやすくなります
  • 具体的に書く: あいまいなガイドラインよりも、具体的な使用例や明確な規約の方が効果的です
  • 重複を避ける: グローバルな指示をサブディレクトリのファイルに繰り返し書かないでください。親ディレクトリから継承されます

コンテンツガイドライン

ルールとの比較

AGENTS.mdルール はどちらも Cascade に指示を与えますが、用途は異なります。 シンプルで、場所に基づく指示が必要な場合は AGENTS.md を利用します。指示をいつどのように適用するかをより細かく制御する必要がある場合は、ルールを利用します。