階層型メモリ

Alius Agent は階層型メモリシステムを通じてセッション間で知識を永続化します。メモリはプロジェクトメモリとグローバルメモリの2つのスコープに分かれ、それぞれが複数のストレージ層を含みます。

プロジェクトメモリ vs グローバルメモリ

スコープ説明
プロジェクトメモリ.alius/memory/ に保存、現在のワークスペースにバインド
グローバルメモリプロジェクト間で共有される一般的な知識

ストレージ層

Alius のメモリシステムには以下のストレージ層があります：

ストレージ層タイプ説明
ConversationStoreワーキングメモリ現在のセッションの会話履歴を保存
SessionStoreワーキングメモリ現在のセッションの状態とメタデータを保存
MemoryStore一般メモリプロジェクトレベルの事実と知識のストレージ
EpisodicStoreエピソードメモリ過去のランからの経験記録 — 何が機能したか、しなかったか
SemanticStoreセマンティックメモリ抽出されたプロジェクトの事実 — アーキテクチャ決定、API 契約、命名規約
ProceduralStore手続き的メモリ操作プロセスとステップの記録

コンテキストメモリ（ワーキングメモリ）

アクティブなセッション中の短期メモリ。現在の会話コンテキスト、最近のツール出力、アクティブなプラン状態を保存します。

  • 現在のセッションにスコープ
  • セッション終了時にクリア
  • 各ターンに即時コンテキストを提供
  • ConversationStore と SessionStore で管理

エピソードメモリ

過去の経験の記録 — 何が機能したか、しなかったか、以前のランで何を学んだか。

  • セッション間で永続化
  • 開発ラウンドからの教訓をキャプチャ
  • 同じ間違いの繰り返しを回避
  • EpisodicStore で管理

セマンティックメモリ

プロジェクトについて抽出された事実と知識 — アーキテクチャ決定、API 契約、命名規約、ドメイン知識。

  • セッション間で永続化
  • プロジェクトのナレッジベースを構築
  • コードを再読することなくプロジェクトコンテキストを理解可能に
  • SemanticStore で管理

手続き的メモリ

操作プロセスとステップの記録 — 特定の種類のタスクを達成するための標準手順。

  • セッション間で永続化
  • 成功した操作パターンを記録
  • ワークフロー自動化の基盤
  • ProceduralStore で管理

検索エンジン

RetrievalEngine はメモリ層から関連情報を検索し、Agent の現在のコンテキストをサポートする役割を担います。

メモリの管理

/memory save <text>     # 事実や教訓を保存
/memory list            # 保存されたメモリを表示
/memory clear           # グローバルメモリをクリア（確認が必要）

メモリがどのように役立つか

  1. 迅速な再開 — コンテキストが保持され、説明を繰り返す必要がない
  2. 経験からの学習 — 過去のランが将来の決定を導く
  3. プロジェクト知識の構築 — 事実がプロジェクト固有のナレッジベースに蓄積
  4. 自己進化 — 各反復で Agent がプロジェクトに対してより効果的に

ランタイムメモリ vs ワークスペースドキュメント

Alius は2つの異なるデータストアを区別します：

場所内容説明
.alius/memory/ランタイムメモリデータセッション、会話、経験、事実など
.alius/workspace/ワークスペースドキュメント設計ドキュメント、仕様、ステータス記録など

これらは異なるディレクトリに保存され、異なる目的にサービスします。メモリはランタイムが自動管理するデータであり、ワークスペースドキュメントはプロジェクトの設計と計画資料です。

メモリとプライバシー

すべてのメモリはローカルの .alius/memory/ ディレクトリに保存されます。リモートストレージを明示的に設定しない限り、外部サービスにデータが送信されることはありません。