メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

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

AGENTS.md

ルールを追加する最も簡単な方法は、プロジェクトのルートディレクトリに AGENTS.md ファイルを配置することです。
# プロジェクトルール

- Use TypeScript for all new files
- Follow the existing patterns in src/components/
- Always run `npm run lint` before committing
- Use pnpm, not npm or yarn
- Write tests for all new utility functions
Devin CLIはこのファイルを自動的に読み込みます。
AGENTS.md は、プロジェクトルールを定義する方法として推奨されています。読みやすく、バージョン管理でき、複数のAIツールで利用できます。

グローバルルール

ユーザー設定ディレクトリに AGENTS.md ファイルを配置すると、すべてのプロジェクトに適用されるルールを作成できます。
~/.config/devin/AGENTS.md
グローバルルールは、どのプロジェクトで作業している場合でも、すべてのセッションの開始時に読み込まれます。どこでも共通して適用したい個人的な設定に利用してください。
# My Global Rules

- Always write commit messages in conventional commit format
- Prefer functional patterns over imperative code
- Run tests before suggesting a task is complete
グローバルルールはプロジェクトルールと併用でき、両方が同時に読み込まれてアクティブになります。この場所では AGENT.md にも対応しています。
Claude Codeを利用する場合、Devin CLI は ~/.claude/CLAUDE.md もグローバルルールとして読み取ります。

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

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

他ツールのルール

別のAIコーディングツールを使っている場合でも、Devin CLIは既存のルールを読み取れます。
Devin CLIは .cursorrules.cursor/rules/*.md を読み取ります。Cursorのルールでは、frontmatterを使って有効化を制御できます。
---
description: "React component guidelines"
globs: "src/components/**/*.tsx"
alwaysApply: false
---

hooksを使った関数コンポーネントを使用します。クラスコンポーネントは決して使用しません。
有効化の動作:
  • alwaysApply: true — 常にアクティブ
  • globs が指定されている — 一致するファイルを扱っているときにアクティブ
  • description のみ — Agentが適用するかどうかを判断
  • 上記のいずれでもない — ユーザーが手動でトリガーする必要があります
Devin CLIは .windsurf/rules/*.md.windsurf/global_rules.md を読み取ります。サブディレクトリのサポート: .windsurf/rules/ ディレクトリは、ルートだけでなくプロジェクト内の複数の階層に配置できます。workspaceルートのルールはセッション開始時に読み込まれます。サブディレクトリ内のルールは遅延的に検出されます。つまり、agentがそのディレクトリ内のファイルにアクセスすると、その場所で見つかった .windsurf/rules/ (および親ディレクトリをたどってworkspaceルートまでにあるもの) が自動的に読み込まれます。これにより、プロジェクトの無関係な部分にあるルールでagentの前提情報が汚染されるのを防げます。Windsurfのルールでもfrontmatterを利用できます。
---
description: "API design rules"
trigger: always_on
---

すべてのAPIエンドポイントは、一貫したエンベロープ形式のJSONを返す必要があります。
トリガー値: 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) で、特定のツール形式からの読み込みを有効または無効にできます。
{
  "read_config_from": {
    "cursor": true,
    "windsurf": true,
    "claude": true
  }
}
AGENTS.md は常に参照され、無効化することはできません。

ルールの有効化タイプ

外部形式から読み込まれたルールでは、有効化の挙動が異なる場合があります。
TypeBehavior
Always-onすべてのセッションでアクティブ。ユーザーによる操作は不要
Glob-activatedエージェントが特定のパターンに一致するファイルを扱う場合にアクティブ
Agent-decidedルールの説明に基づいて、適用するタイミングをエージェントが判断
User-invocableユーザーが明示的にトリガーした場合にのみアクティブ
AGENTS.md のルールは常に「常時適用」です。

ベストプラクティス

ルールは簡潔に保つ

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

具体的に書く

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

使用例を含める

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

バージョン管理する

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