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

# Memory

> Alter にチャット、workspace、会議をまたいで役立つ事実を覚えさせ、必要なときに呼び出せるようにします

<Info>
  **Memory** は Alter の持続的なリコール層です。大事な事実を短く保存し、新しいチャットに最も関係の深い内容を自動で持ち込みます。保存済みの Memory だけでは足りない場合は、過去のチャットや会議の文字起こしも検索できます。
</Info>

## Memory とは

Memory は、すべてのチャットや会議を丸ごとコピーする仕組みではありません。Alter が保存するのは、**短くて単独で意味が通る事実**です。たとえば好み、目標、決定事項、今後の会話で役に立ちそうな細かな前提などです。

Alter があなたのために持っているノートだと考えるとわかりやすいです。

* **Personal Memory** は workspace をまたいであなたについて回ります。あなた自身のこと、作業スタイル、プロジェクト横断の好みのような長く使う事実に向いています。
* **Workspace Memory** は 1 つの workspace にとどまります。プロジェクトの目標、慣例、決定事項、最近の変更点に向いています。

元のチャットや会議の文字起こしは、通常の Alter 履歴にそのまま残ります。Memory は必要に応じてそれらのソースに戻れますが、置き換えるものではありません。

## Memory を使い始める

Memory を早く役立つ状態にするいちばんの近道は、新しいチャットのたびに同じ説明を繰り返すことではありません。**すでにある履歴から先に Memory を埋めること**です。

<Tip>
  **最初は Memory Catch-Up から始めてください。** 新しい Hub チャットで **Memory に先行スタートを与える** を選びます。Alter が直近 30 日間のチャットと会議を見直し、すでに保存されている内容と比べたうえで、長く残す価値がある事実を一括で追加または更新します。項目ごとの承認は必要ありません。
</Tip>

Catch-Up を実行するとよい場面:

* **Use Memory** を初めてオンにした
* Memory の設定が空なのに、すでに何週間も Alter を使っている
* しばらく離れて戻ってきたので、最近の目標や決定事項を取り込みたい
* 新しい workspace を開いたので、最近の作業からプロジェクトの文脈を持ち込みたい

Catch-Up は、過去 30 日分を一度だけ埋めるためのバックフィルです。その後は、日常の Memory 学習がチャットに合わせて内容を新しく保ちます。

完全な手順はこちら: [Memory Catch-Up](/ja/workflows/memory-catch-up)

## 日常の作業で Memory が役立つ場面

<CardGroup cols={2}>
  <Card title="すばやく始める" icon="bolt">
    保存済みの関連事実が新しい Ask Anything チャットに入るので、毎回同じ説明をしなくて済みます。
  </Card>

  <Card title="状況を見失わない" icon="compass">
    今の目標、これまでの決定、最近の会議で何が出たかをそのまま尋ねられます。
  </Card>

  <Card title="プロジェクトを混ぜない" icon="folder">
    Workspace Memory が、あるプロジェクトの文脈を別のプロジェクトに混ぜないようにします。
  </Card>

  <Card title="必要なときだけ振り返る" icon="clock-rotate-left">
    保存済みの事実だけでは足りないとき、Alter は過去のチャットや文字起こしを検索できます。
  </Card>
</CardGroup>

## 何が記憶されるか

Alter は保存する事実をいくつかの種類に分けます。

| 種類             | 向いている内容          | 例                                   |
| -------------- | ---------------- | ----------------------------------- |
| **Preference** | 安定して続く好みややり方     | "簡潔な箇条書き要約を好む"                      |
| **Fact**       | 長く残す価値がある情報      | "ステージング環境のアプリは staging.example.com" |
| **Goal**       | 現在進行中の優先事項や計画    | "8 月までに onboarding の再設計を出荷する"       |
| **Decision**   | すでに決めたこと         | "分析ストアには Postgres を使う"              |
| **Recent**     | 押さえておきたい最近の変化    | "デフォルトモデルを Claude Sonnet に切り替えた"    |
| **Experience** | 過去の仕事から得た検証済みの学び | 雑談からではなく、リコールの流れで整理されることが多い         |

Alter は選別して保存します。秘密情報、認証情報、機微な個人データ、一時的な段取り、リマインダー、生の文字起こしの貼り付け、あとで簡単に見直せるだけの細部は保存しません。

## Memory の仕組み

Memory は、3 つの層が連携して動きます。

### 1. Memory Brief（自動リコール）

永続的な **Ask Anything** チャットでは、モデルが返答する前に、Alter が最新メッセージへ小さな Memory Brief を付けることがあります。

* この brief は保存済み Memory からローカルで作られ、追加のモデル呼び出しはありません。
* 上限は約 **240 tokens** なので軽量です。
* 優先されるのは、ピン留めした好み、長く使う事実、目標、決定事項、Personal と現在の workspace の最近の変更です。
* すでに現在の会話に含まれている事実は省かれます。
* 会話がすでにコンテキスト上限に近い場合、この brief は付きません。

この brief は、Alter が文脈を保って答える助けになります。Memory に保存される内容自体は変えません。

### 2. ターン後の自動学習

Ask Anything の返答が完了したあと、Alter はそのターンを小さくバックグラウンドレビューできます。

* 1 ターンあたり検討される候補事実は最大 **1 件**です。
* **Ask before saving** がオフなら、現在のチャットであなたが直接述べた事実は自動保存されることがあります。
* Tools の出力や、以前にリコールした履歴から学んだ事実は、引き続き承認が必要です。
* 承認なしで保存が行われた場合、Alter は **Undo** 付きの通知を表示します。

このレビューがチャットに追加メッセージを投稿することはありません。すでに受け取った返答を待たせることもありません。

### 3. Memory ツール（明示的なリコールと編集）

会話で Memory が使える場合、Alter は **Memory** ツールを使って次のことができます。

* **Recall** 保存済みの事実、最近のチャット、会議の文字起こしを呼び出す
* **Analyze** 抜粋だけでは足りないとき、呼び出したソース全体を分析する
* **Remember** 短い新しい事実を 1 件保存する
* **Replace** 古くなった保存済み事実を置き換える
* **Forget** 明示的に削除を求めた保存済み事実を忘れる

読むことや分析すること自体では、Memory には書き込まれません。

<Note>
  **Memory Catch-Up** は、最近の履歴から Memory を立ち上げるための標準の方法です。カスタム action や一部の Hub フローでも、このツールを明示的にリンクできます。[Memory Catch-Up](/ja/workflows/memory-catch-up) と [Memory を管理](/ja/how-to/manage-memory) も参照してください。
</Note>

## Personal と workspace のスコープ

| スコープ          | 保存される形                | 見える場所                       | 向いている内容                          |
| ------------- | --------------------- | --------------------------- | -------------------------------- |
| **Personal**  | ユーザー全体の事実             | workspace をまたぐ Ask Anything | 好み、プロフィール情報、プロジェクト横断の目標          |
| **Workspace** | 1 つの workspace に紐づく事実 | その workspace 内のチャット         | プロジェクト慣例、workspace の目標、ローカルな決定事項 |

実際に使ううえで大事なルール:

* 保存時にスコープを指定しなければ、Alter はより狭い境界である**現在の workspace**を優先します。
* どこでも使いたい事実は、明示的に **Personal** にしてください。
* workspace を削除すると、その workspace の保存済み Memory も削除されます。
* 削除済み workspace の Memory は、確認したり forget したりできるよう、Settings の **Deleted workspaces** に表示され続けます。

## Memory が使える場所

Memory は、通常のユーザー主体の Ask Anything 会話で使うことを前提に設計されています。

| コンテキスト                            | Memory Brief  | 自動学習     | Memory ツール                |
| --------------------------------- | ------------- | -------- | ------------------------- |
| 永続 Ask Anything チャット              | はい。有効時のみ      | はい。有効時のみ | はい。有効時のみ                  |
| workspace 付きの QuickHub / Hub チャット | はい            | はい       | Personal + workspace スコープ |
| 一時的な会話やタスク会話                      | いいえ           | いいえ      | いいえ                       |
| 読み取り専用の会話                         | 読める場合のみ brief | 書き込みなし   | 読み取り専用リコール                |
| Settings で Memory が無効             | いいえ           | いいえ      | いいえ                       |

カスタム **Alter Actions** は、Action Editor の **Tools** セクションで Memory ツールをリンクできます。Memory がすべての action に自動でグローバル追加されることはありません。

## Alter と Memory について話す

特別な構文は要りません。自然な言い方で大丈夫です。

* "今の目標は何だっけ？"
* "私について何を覚えている？"
* "onboarding について何を決めた？"
* "コードはタブインデントが好きだと覚えておいて。"
* "Kubernetes 移行の目標は忘れて。中止したから。"
* "今週の会議で pricing について何が出た？"

役立つコツ:

* 特定の保存済み事実を修正したり削除したりする前に、まず Alter にそれを **recall** させる
* 目標や計画が終わって Memory から外したいときは、**forget** または **remove** と明示する
* 保存済み要約だけでなく根拠を見たいなら、**source** を求めるか **open the meeting** と頼む

## Memory Catch-Up

**Memory Catch-Up** は、次のチャットで新しく話す内容だけに頼るのではなく、既存の履歴から Memory を育てるために Alter が推奨する方法です。

新しい Hub チャットでは、Alter が **Memory に先行スタートを与える** を提案することがあります。これを選ぶと、信頼済みの組み込み **Memory Catch-Up** action が起動し、次のことを行います。

* 直近 **30 日間** の個人チャットと会議を確認する
* active な workspace がある場合は、その workspace のチャットと会議も含める
* その期間を完全にページ送りして読み切る。他の workspace は対象外
* 役立つ内容を、すでに保存されている内容と比較する
* 証拠が明確なら、新しい事実を **Remember** し、古い事実を **Replace** する
* 固定されたレビュー範囲を持つ信頼済み Alter action なので、項目ごとの承認なしで保存する

Catch-Up は Memory を削除したり forget したりできません。Memory が無効だった場合は、この実行のために **Use Memory** をオンにします。

|         | 日常の Memory         | Memory Catch-Up            |
| ------- | ------------------ | -------------------------- |
| 向いている用途 | チャットを続ける中での継続学習    | 直近 30 日からの立ち上げや更新          |
| 確認する履歴  | 現在のターン、または明示的なリコール | 固定された 30 日間のチャットと会議        |
| 項目ごとの承認 | ソースと設定による          | 信頼済み action として保存し、毎回は聞かない |
| 削除      | forget できる         | Catch-Up 中は forget できない    |

完全な手順はこちら: [Memory Catch-Up](/ja/workflows/memory-catch-up)。

## プライバシーとローカル保存

<Info>
  保存済み Memory は、ほかの Alter データと同じくあなたの Mac に残ります。Memory だけを別バックアップとしてクラウド同期することはありません。
</Info>

つまり次のようになります。

* 保存済みの事実は、それが作成されたデバイス上の Alter ローカルデータベースに入ります。
* Memory を forget すると、保存済み事実とその出典リンクは削除されますが、元のチャットや文字起こしは削除されません。
* クラウドモデルを使う場合、モデルに送られる Memory Brief やリコール内容を含め、アクティブな会話はそのプロバイダーの通常のリクエスト経路に従います。
* **Use Memory** をオフにすると、新しいリコールと保存は止まります。ただし既存の項目は残るので、あとで再びオンにできます。

ローカルデータ全般については、[ローカルデータとプライバシー](/ja/references/local-data-and-privacy) を参照してください。

## Settings の要点

**Settings → Memory** を開きます。Settings の General セクションにある、脳アイコンの項目です。

| 設定                    | デフォルト | 役割                                                     |
| --------------------- | ----- | ------------------------------------------------------ |
| **Use Memory**        | On    | リコール、自動学習、Memory ツールを有効にする                             |
| **Ask before saving** | Off   | オフなら現在のチャットの事実は自動保存されることがあり、Tools やリコール履歴の事実は引き続き承認が必要 |

Memory の設定画面では、検索、フィルタ、ソース確認、個別項目の forget も行えます。

完全な管理ガイドはこちら: [Memory を管理](/ja/how-to/manage-memory)。

## ユースケース

### 好みを一貫させる

回答の整え方、使っている技術スタック、重視しているカレンダーなどを一度 Alter に伝えます。Personal の好みはピン留めでき、Memory Brief にもよく出てきます。

### プロジェクトごとに目標と決定を追う

製品やクライアントの workspace では、進行中の目標や決定事項をそこに保存します。すると、workspace の背景を説明し直さなくても "このプロジェクトの目標は？" と聞けます。

### 会議のあとですぐ再開する

録音された会議のあとで、"最近の会議で X について何を決めた？" と尋ねられます。Alter は文字起こしと保存済み Memory の両方を検索できます。

### 忙しい Mac で Memory をすばやく立ち上げる

新しい Hub チャットから **Memory Catch-Up** を実行し、つまり **Memory に先行スタートを与える** を選んで、直近 30 日のチャットと会議を一気にバックフィルします。そのあと Settings で微調整し、日常学習に最新状態を保たせます。

### action に長く効く文脈を渡す

Action Editor で **Memory** を、保存済み事実を読んだり、このワークフローのために過去のチャットや会議を検索したりする必要がある action にリンクします。

## 関連ドキュメント

* [Memory Catch-Up](/ja/workflows/memory-catch-up) — 直近 30 日の履歴から Memory を投入する推奨の方法
* [Memory を管理](/ja/how-to/manage-memory) — 設定、確認、forget、ソース
* [会議](/ja/workflows/meetings) — Memory が検索できる文字起こし
* [Alter Actions](/ja/workflows/alter-actions) — Memory をカスタムワークフローにリンクする
* [より大きなタスクにはワークスペースを使用する](/ja/getting-started/workspaces-basics) — プロジェクト単位の Memory
* [コンテキストウィンドウの管理](/ja/how-to/managing-context-window) — 短いリコールと完全なコンテキストの違い