Skip to main content
Rules は、プロジェクト内で Devin CLI の動作を規定する永続的な指示です。各セッションの開始時にエージェントの前提情報へ注入されるため、チーム全体で一貫した動作を保てます。 Rules の一般的な用途には、コーディング標準、アーキテクチャのガイドライン、推奨ライブラリ、テストの慣行、プロジェクト固有の制約などがあります。 コーディング品質を高め、完了までの時間を短縮し、コストを抑えるために、可能な限り Skills を代わりに利用することを強く推奨します。Skills は、関連する場合にのみ前提情報へ注入されます。Rules と AGENTS は、できるだけ小さく保つべきです。 推奨パターンは、特定の状況でモデルが利用すべき Skills を参照するために Rules を使うことです。

​
AGENTS.md

ルールを追加する最も簡単な方法は、プロジェクトのルートディレクトリに AGENTS.md ファイルを配置することです。
Devin CLIはこのファイルを自動的に読み込みます。
AGENTS.md は、プロジェクトルールを定義する方法として推奨されています。読みやすく、バージョン管理でき、複数のAIツールで利用できます。

​
グローバルルール

ユーザー設定ディレクトリに AGENTS.md ファイルを配置すると、すべてのプロジェクトに適用されるルールを作成できます。
グローバルルールは、どのプロジェクトで作業している場合でも、すべてのセッションの開始時に読み込まれます。どこでも共通して適用したい個人的な設定に利用してください。
グローバルルールはプロジェクトルールと併用でき、両方が同時に読み込まれてアクティブになります。この場所では AGENT.md にも対応しています。
Claude Codeを利用する場合、Devin CLI は ~/.claude/CLAUDE.md もグローバルルールとして読み取ります。

​
AGENTS.local.md を使った個人用ルール

共同作業者と共有したくない個人的な指示 — たとえば、好みの作業スタイル、テストの進め方、レビューの方針など — がある場合は、AGENTS.md の隣に AGENTS.local.md ファイルを作成してください:
このファイルは、AGENTS.md と同じく常時適用され、あわせて読み込まれます。ローカルのまま保持するため、.gitignore に追加してください:
これは .devin/config.local.json と同じ命名規則です。.local. という接尾辞は、コミットすべきではない個人用のオーバーライドであることを示します。

​
サポートされているファイル名

Devin CLI は、以下のいずれのファイルからでもルールを読み込みます。 これらはすべて同じように扱われ、内容は常時適用なルールとして読み込まれます。 これらのファイルは、プロジェクト内の複数の階層 (ルートに限りません) に配置できます。workspace ルートにあるファイルは、セッション開始時に読み込まれます。サブディレクトリ内のファイルは、エージェントがそのディレクトリ内のファイルにアクセスしたときに遅れて検出されるため、前提情報は codebase の該当部分に絞られた状態に保たれます。 また、CLAUDE.md を除き、これらのファイルはすべてのプロジェクトに適用できるよう global config directory に配置することもできます。CLAUDE.md は ~/.claude/CLAUDE.md からグローバルに読み込まれます。 インストール済みのプラグインもルールを提供できます。具体的には、プラグイン ルートにある常時適用の AGENTS.md と、trigger frontmatter を持つ rules/*.md ファイルです。

​
.devin ディレクトリ内のルール

Devin CLI は .devin/ ディレクトリからもルールを読み込みます。各ファイルには 1 つのルールを記述します。 これらのファイルでは .windsurf/rules/*.md と同じ frontmatter を使用するため、trigger の値 always_on、manual、model_decision、agent、glob はすべて利用できます。 .devin/ が推奨される場所であり、.windsurf/ よりも優先されます。.devin/global_rules.md と .windsurf/global_rules.md の両方が存在する場合、Devin CLI は .devin/global_rules.md のみを読み込みます。.devin/rules/ と .windsurf/rules/ のルールファイルは、どちらも読み込まれます。 他のプロジェクトルールと同様に、これらのディレクトリは、workspaceルートと現在のディレクトリの間にある各ディレクトリで読み込まれます。ホームディレクトリ (~/.devin/rules/*.md、~/.devin/global_rules.md) に配置すれば、すべてのプロジェクトに適用することもできます。

​
他ツールのルール

別のAIコーディングツールを使っている場合でも、Devin CLIは既存のルールを読み取れます。
Devin CLIは .cursor/rules/*.md と .cursor/rules/*.mdc を読み取ります。Cursorのルールでは、frontmatterを使って有効化を制御できます。
有効化の動作:
  • alwaysApply: true — 常にアクティブ
  • globs が指定されている — 一致するファイルを扱っているときにアクティブ
  • description のみ — エージェントが適用するかどうかを判断
  • 上記のいずれでもない — ユーザーが手動でトリガーする必要があります
Devin CLIは .windsurf/rules/*.md と .windsurf/global_rules.md を読み取ります。Devinネイティブの.devin/ の同等機能が優先されます。サブディレクトリのサポート: .windsurf/rules/ ディレクトリは、ルートだけでなくプロジェクト内の複数の階層に配置できます。workspaceルートのルールはセッション開始時に読み込まれます。サブディレクトリ内のルールは遅延的に検出されます。つまり、エージェントがそのディレクトリ内のファイルにアクセスすると、その場所で見つかった .windsurf/rules/ (および親ディレクトリをたどってworkspaceルートまでにあるもの) が自動的に読み込まれます。これにより、プロジェクトの無関係な部分にあるルールでエージェントの前提情報が汚染されるのを防げます。Windsurfのルールでもfrontmatterを利用できます。
トリガー値: always_on, manual, model_decision, agent, glob
Devin CLIは .claude/ ディレクトリを読み取ります。
Devin CLIは .codeiumignore ファイルをサポートしていません。Codeiumの自動補完を利用していてignoreパターンを設定している場合、それらのパターンはDevin CLIには適用されません。

​
インポートの制御

設定ファイル (~/.config/devin/config.json — Windows では %APPDATA%\devin\config.json — または .devin/config.json) で、特定のツール形式からの読み込みを有効または無効にできます。
AGENTS.md、AGENTS.local.md、AGENT.md、および .windsurfrules の標準的なプロジェクトルールは、既定で参照されます。それらのインポートを無効にするには、"agents_standard": false を設定します。

​
ルールの有効化タイプ

外部形式から読み込まれたルールでは、有効化の挙動が異なる場合があります。 AGENTS.md のルールは常に「常時適用」です。

​
ベストプラクティス

ルールは簡潔に保つ

長く冗長なルールは、エージェントの注意を散漫にします。最も重要なことに絞ってください。

具体的に書く

「適切なパッケージマネージャーを利用する」よりも、「pnpmを利用する」のほうが効果的です。具体的な指示のほうが従いやすくなります。

使用例を含める

説明だけでなく、期待するパターンを示してください。

バージョン管理する

ルールはリポジトリで管理し、チーム全体が同じガイドラインの恩恵を受けられるようにしてください。
一般的なルールの多くでは、代わりに skills の利用を検討してください。skills を使うと、適用するタイミングや方法をより細かく制御できます。