> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Memories とルール

> Cascade の会話間で前提情報を保持するために、自動生成される Memories と、Enterprise チーム向けにグローバル、ワークスペース、システムの各レベルでユーザーが定義できるルールを利用できます。

`Memories` は、会話間で前提情報を共有・保持するためのシステムです。

Devin Desktop には、これを実現する仕組みが 2 つあります。Cascade が自動生成する **Memories** と、ユーザーがグローバル、ワークスペース、またはシステム レベルで手動定義する **ルール** です。

<div id="memories-rules-workflows-or-skills">
  ## Memories、ルール、ワークフロー、それともスキル？
</div>

Devin Desktop では、Cascade をカスタマイズする方法がいくつかあります。自分に合ったものを、この表で選んでください。

| Feature                                        | What it does                                   | How it's activated                                                            | When to use it                                              |
| ---------------------------------------------- | ---------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------- |
| **[ルール](#rules)**                              | Cascade に*どう振る舞うか*を伝える (例: 「npm ではなく bun を使う」) | `always_on`、`glob`、`model_decision`、または `manual` ([以下を参照](#activation-modes)) | コーディング規約、スタイルガイド、プロジェクト上の制約                                 |
| **[AGENTS.md](/ja/desktop/cascade/agents-md)** | 設定不要で使える、場所ごとに適用されるルール                         | 自動 — ルート = 常時適用、サブディレクトリ = glob                                               | frontmatter なしで、ディレクトリごとの規約を適用したい場合                         |
| **[ワークフロー](/ja/desktop/cascade/workflows)**    | 繰り返し利用する複数ステップのタスク向けプロンプトテンプレート                | `/[workflow-name]` スラッシュコマンドによる**手動のみ**                                       | デプロイ、PR レビュー、リリースチェックリスト                                    |
| **[スキル](/ja/desktop/cascade/skills)**          | 補助ファイル (スクリプト、テンプレート) を含む複数ステップの手順             | モデルが動的に呼び出す、または `@mention`                                                    | Cascade が参照ファイルを必要とする複雑なタスク — **特におすすめ**                    |
| **[Memories](#memories)**                      | 会話中に Cascade が自動生成する前提情報                       | 関連する場合に自動で取得                                                                  | Cascade に単発の情報を覚えさせたい場合。長く使う知識には、ルールまたは AGENTS.md を優先してください |

<Tip>
  **推奨:** Cascade に確実に再利用してほしい知識は、自動生成された Memories に頼るのではなく、ルールとして記述するか、repo 内の `AGENTS.md` に追加してください。ルールはバージョン管理でき、チームで共有でき、いつ有効にするかを明示的に制御できます。
</Tip>

<div id="how-to-manage-memories">
  ## Memories の管理方法
</div>

Memories とルールは、Cascade の右上にあるスライダーメニューの `Customizations` アイコンをクリックするか、右下の「Devin - 設定」から、いつでもアクセスして設定できます。既存の Memories を編集するには、その Memories をクリックしてから `Edit` ボタンをクリックするだけです。

<video autoPlay controls muted loop playsInline className="aspect-video" src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/memories-rules.mp4?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=f264942bd2e40966555454624f1958b4" data-path="desktop/assets/windsurf/cascade/memories-rules.mp4" />

<div id="memories">
  ## Memories
</div>

会話中、Cascade は、記憶しておくと役立つ前提情報に出会うと、自動的に Memories を生成して保存できます。

また、Cascade にいつでも Memories を作成するよう依頼できます。`"create a memory of ..."` とプロンプトするだけです。

Cascade が自動生成した Memories は、作成されたワークスペースに関連付けられ、`~/.codeium/windsurf/memories/` にローカルで保存されます。Cascade は、それらが関連していると判断したときに取得します。あるワークスペースで生成された Memories は別のワークスペースでは利用できず、リポジトリにコミットされることもありません。

<Tip>自動生成された Memories の作成と利用でクレジットが消費されることはありません。</Tip>

<Note>
  自動生成された Memories は、ローカルのマシン上にのみ保存されます。Cascade に何かを継続的に記憶させてチームと共有したい場合は、代わりに `.devin/rules/` (またはレガシーな `.windsurf/rules/`) の [ルール](#rules) またはリポジトリの `AGENTS.md` に書き込むよう Cascade に依頼してください。
</Note>

<div id="rules">
  ## ルール
</div>

ユーザーは、Cascade が従う独自のルールを明示的に定義できます。

ルールはグローバル、ワークスペース、またはシステムレベルで定義でき、[AGENTS.md](/ja/desktop/cascade/agents-md) ファイルから検出されることもあります。

| スコープ                                                   | 場所                                                            | 注記                                                                                                                                     |
| ------------------------------------------------------ | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| グローバル                                                  | `~/.codeium/windsurf/memories/global_rules.md`                | 単一のファイルで、すべてのワークスペースに適用されます。常時適用。6,000 文字まで。                                                                                           |
| ワークスペース                                                | `.devin/rules/*.md` (推奨) または `.windsurf/rules/*.md` (フォールバック) | ルールごとに 1 つのファイルがあり、それぞれに独自の[有効化モード](#activation-modes)があります。各ファイルは 12,000 文字まで。ワークスペースルートにあるレガシーな単一ファイル `.windsurfrules` も引き続き読み込まれます。 |
| [AGENTS.md](/ja/desktop/cascade/agents-md)             | ワークスペース内の任意のディレクトリ                                            | 同じルールエンジンで処理されます。ルートレベル = 常時適用、サブディレクトリ = そのディレクトリに対する auto-glob。                                                                      |
| [System (Enterprise) ](#system-level-rules-enterprise) | OS 固有 (例: `/etc/devin/rules/`、レガシーな `/etc/windsurf/rules/`)   | IT によって配備され、エンドユーザーは読み取り専用です。                                                                                                          |

<div id="rules-discovery">
  ## ルールの検出
</div>

Devin Desktop は、柔軟に管理できるよう、複数の場所からルールを自動的に検出します。`.devin/` ディレクトリが推奨される場所であり優先され、`.windsurf/` は後方互換性のためのフォールバックとして維持されています:

* **現在のワークスペースとそのサブディレクトリ**: 現在のワークスペースとそのサブディレクトリ内にある、すべての `.devin/rules` (およびレガシーな `.windsurf/rules`) ディレクトリ
* **Git リポジトリ構造**: Git リポジトリでは、Devin Desktop は親ディレクトリ内のルールを見つけるために、git root ディレクトリまでさかのぼって検索します
* **複数ワークスペースのサポート**: 同じワークスペースで複数のフォルダが開かれている場合、ルールは重複を排除したうえで、最短の相対パスで表示されます

<div id="rules-storage-locations">
  ### ルールの保存場所
</div>

ルールは、以下のいずれかの場所に保存できます (`.devin/` が推奨され、`.windsurf/` より優先されます) 。

* 現在のワークスペースディレクトリ内の `.devin/rules` または `.windsurf/rules`
* ワークスペース内の任意のサブディレクトリ内の `.devin/rules` または `.windsurf/rules`
* 親ディレクトリ内の `.devin/rules` または `.windsurf/rules` (git リポジトリの場合は git ルートまで)

新しいルールを作成すると、保存先は必ずしも git ルートではなく、現在のワークスペースの `.devin/rules` ディレクトリになります。

ルールの利用を開始するには、まず Cascade の右上にあるスライダーメニューで `Customizations` アイコンをクリックし、`Rules` パネルに移動します。ここで、`+ Global` または `+ Workspace` ボタンをクリックすると、それぞれグローバルレベルまたはワークスペースレベルの新しいルールを作成できます。

<Tip>使い始める際の参考として、Devin Desktop チームが厳選したルールテンプレートの例を [https://windsurf.com/editor/directory](https://windsurf.com/editor/directory) で確認できます。</Tip>

ワークスペースのルールファイルは、1 ファイルあたり 12,000 文字までです。グローバルルールファイルは 6,000 文字までです。

<div id="activation-modes">
  ### 有効化モード
</div>

各ワークスペース ルールは、フロントマター内の`trigger`フィールドで有効化モードを指定します。これにより、ルールの内容が**いつ**Cascadeに渡されるか、また**前提情報ウィンドウをどれだけ消費するか**が決まります。

| モード       | `trigger:` の値    | Cascadeに反映される方法                                                                     | 前提情報コスト                   |
| --------- | ---------------- | ----------------------------------------------------------------------------------- | ------------------------- |
| **常時有効**  | `always_on`      | ルールの全文が、すべてのメッセージでシステムプロンプトに含まれます。                                                  | すべてのメッセージ                 |
| **モデル判断** | `model_decision` | システムプロンプトには`description`のみが表示されます。Cascadeは、その説明に関連性があると判断した場合にのみ、ルールファイル全体を読みます。    | `description`は常時、全文は必要時のみ |
| **Glob**  | `glob`           | Cascadeが`globs`パターンにマッチするファイル (例: `*.js`、`src/**/*.ts`) を読んだり編集したりしたときに、ルールが適用されます。 | マッチしたファイルに触れたときのみ         |
| **手動**    | `manual`         | ルールは**システムプロンプトに含まれません**。Cascadeの入力欄で`@rule-name`と入力して有効化します。                       | @メンション時のみ                 |

<Note>
  グローバルルールファイル (`global_rules.md`) とルートレベルの`AGENTS.md`ファイルではフロントマターを利用しません。これらは常に有効です。
</Note>

フロントマター付きのワークスペース ルールの例:

```markdown theme={null}
---
trigger: glob
globs: **/*.test.ts
---

All test files must use `describe`/`it` blocks and mock external API calls.
```

<div id="best-practices">
  ### ベストプラクティス
</div>

Cascade がルールに効果的に従えるようにするために、次のベストプラクティスに従ってください。

* ルールはシンプルで簡潔、かつ具体的にしてください。長すぎたり曖昧だったりすると、Cascade が混乱する可能性があります。
* 一般的なルール (例："良いコードを書く") を追加する必要はありません。こうした内容は、すでに Cascade のトレーニングデータに組み込まれています。
* 箇条書き、番号付きリスト、Markdown を使ってルールを記述してください。長い段落で書くよりも、Cascade が従いやすくなります。例えば:

```
# Coding Guidelines 
- My project's programming language is python
- Use early returns when possible
- Always add documentation when creating new functions and classes
```

* XMLタグは、ルールを伝えたり、類似したルールをまとめたりするのに効果的です。たとえば:

```
<coding_guidelines>
- My project's programming language is python
- Use early returns when possible
- Always add documentation when creating new functions and classes
</coding_guidelines>
```

<div id="system-level-rules-enterprise">
  ## システムレベルのルール (Enterprise)
</div>

Enterprise組織では、すべてのワークスペースに全体的に適用され、管理者権限を持たないエンドユーザーは変更できないシステムレベルのルールを導入できます。これは、組織全体のコーディング標準、セキュリティポリシー、コンプライアンス要件を徹底するのに最適です。

システムレベルのルールは、OSごとのディレクトリから読み込まれます。`Devin` ディレクトリが優先されて優先順位も高く、レガシーの `Windsurf` ディレクトリはフォールバックとして維持されます:

**macOS:**

```
/Library/Application Support/Devin/rules/*.md
/Library/Application Support/Windsurf/rules/*.md   # レガシーフォールバック
```

**Linux/WSL：**

```
/etc/devin/rules/*.md
/etc/windsurf/rules/*.md   # レガシーフォールバック
```

**Windows:**

```
C:\ProgramData\Devin\rules\*.md
C:\ProgramData\Windsurf\rules\*.md   # レガシーフォールバック
```

お使いのオペレーティングシステムに対応する適切なディレクトリに、ルールファイル (`.md` ファイル) を配置してください。システムは、これらのディレクトリ内のすべての `.md` ファイルを自動的に読み込みます。

<div id="how-system-rules-work">
  ### システムルールの仕組み
</div>

システムレベルのルールは、ユーザー定義のルールを上書きすることなく、Cascade に追加の前提情報を提供するため、ワークスペースルールおよびグローバルルールと統合されます。これにより、組織は標準的な基準を定めながら、チームごとにプロジェクト固有のカスタマイズを追加できます。

Devin Desktop UI では、システムレベルのルールは "System" ラベル付きで表示され、エンドユーザーが削除することはできません。

<Note>
  **重要**: システムレベルのルールは、IT チームまたはセキュリティチームが管理してください。デプロイ、更新、コンプライアンス対応は、組織のポリシーに従って社内チームが確実に行うようにしてください。その際は、Mobile Device Management (MDM) や Configuration Management などの標準的なツールやワークフローを利用できます。
</Note>