Communitygithub.com

TerminallyLazy/Tree-Ring-Memory

フレームワーク非依存、ローカルファーストのAIエージェント向けメモリライフサイクル:Rust CLI、SQLite/FTSによる想起、忘却、監査、統合、DOX/Revolveアダプター、TUIを提供します。

Tree-Ring-Memory とは?

Tree Ring Memoryは、エージェントの学習を年輪のように保存する、ライフサイクル認識型メモリレイヤーです。フレームワークに依存せず、ローカルで動作するRust CLIツールとして提供され、SQLiteと全文検索(FTS)による高速な想起、忘却、監査、統合機能を備えています。エージェントはプロジェクトの開始時やアーキテクチャ変更時などにメモリを参照し、ユーザーの好みや決定事項、教訓、警告などを適切なリング(例:cambium, outer, heartwood, scar, seed)に分類して保存します。DOX(AGENTS.md同期)やRevolve(評価結果同期)といったソースアダプターにより、プロジェクト成果物からの構造化された知識の取り込みも可能で、TUIモードも提供します。機密情報の自動除外や、エージェント主導の意図的なメモリ書き込み(自律的なスクレイピングは行わない)をポリシーとしており、プライバシーとセキュリティを重視した設計が特徴です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add TerminallyLazy/Tree-Ring-Memory

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Tree Ring Memory

Tree Ring Memory を、トランスクリプトのダンプではなく、ライフサイクルを認識したメモリレイヤーとして使用します。

Tree Ring Memory は、年輪のように意味のあるエージェントの学習を保存します:

  • 新しい作業は詳細に残る
  • 古い学習は安定した環に圧縮される
  • 重要な警告は傷跡として見えるまま残る
  • 永続的な真実は心材となる
  • 未確定の将来の作業は種として残る
  • 機密データはデフォルトでブロック、編集、または除外される

いつ想起するか

以下の前にメモリを想起します:

  • プロジェクトの開始または再開
  • アーキテクチャ、ストレージ、セキュリティ、プライバシー、またはリリース動作の変更
  • 以前の失敗が影響する可能性があるワークフローの繰り返し
  • ユーザーの修正への応答
  • 以前の好みや制約に依存する決定
  • Tree Ring Memory または AGENTS.md 契約があるリポジトリ内のファイル編集
  • 意味のある作業の終了と、何を記憶すべきかの判断

可能な場合は、プロジェクトスコープで狭いクエリを使用します。ソースにリンクされ、信頼性が高く、非置換の結果を優先します。

いつ記憶するか

将来の作業に役立つ可能性が高い情報を記憶します:

  • ユーザーが永続的な好みを述べた場合
  • ユーザーがエージェントを修正した場合
  • 決定が行われ、現在のセッションを超えて存続すべき場合
  • 実装の教訓がテストや本番動作によって検証された場合
  • 失敗したアプローチを繰り返すべきでない場合
  • セキュリティ、プライバシー、リリース、またはデータ損失の警告が表示された場合
  • 有用なプロジェクトの慣習が発見された場合
  • 将来のアイデアを後で再検討すべき場合

メモリは簡潔に保ちます。会話全体ではなく、教訓、決定、または警告を保存します。

教訓が評価、チェックポイント、実験、ブランチ、インシデント、またはレビュー済みの実行アーティファクトから得られた場合、単なる remember の代わりに tree-ring evidence を使用します。

プロジェクトアーティファクトに構造化されたガイダンスや評価結果がすでに含まれている場合は、ソースアダプターを使用します:

tree-ring dox sync --source-root . --dry-run
tree-ring revolve sync --source-root revolve --dry-run
tree-ring integrations scan --source-root .

アダプターコマンドは最初に --dry-run で実行します。簡潔でソースにリンクされたサマリーのみを同期します。インポートされたメモリをソースの AGENTS.md、Revolve レコード、評価、PR、イシュー、またはテストアーティファクトよりも権威があると扱わないでください。

ローカルインストールによって公開された正確な CLI コマンドを使用します:

tree-ring --help
tree-ring dox sync --help
tree-ring revolve sync --help
tree-ring evidence --help

プロジェクトがプロジェクトローカルバイナリで初期化された場合、生成された .tree-ring/CLI.md リファレンスを優先し、必要に応じて --root .tree-ring を含めます。

このスキルがハーネスネイティブのブリッジファイルを通じてロードされた場合、そのブリッジはポインターとしてのみ扱います。プロジェクトローカルの .tree-ring/SKILL.md と .tree-ring/CLI.md が存在する場合はそれらを読み、コマンドがインストールされたプロジェクトルートに一致するようにします。ユーザーが明示的に設定しない限り、グローバルな Tree Ring の設定が現在のリポジトリに適用されると想定しないでください。

エビデンスの結果マッピング:

  • promoted: サポートされたエビデンスからの永続的な心材
  • rejected: 再利用可能な失敗またはロールバックされたアプローチの傷跡
  • deferred: 有望だが未解決のオプションの種
  • observed: 外側の環の評価結果

リングの選択

以下のリングを使用します:

  • cambium: アクティブまたは最近のタスクコンテキスト
  • outer: 最近の決定とタスクの教訓
  • inner: 古い圧縮されたプロジェクト知識
  • heartwood: 永続的で信頼性の高い真実とユーザーの好み
  • scar: 重要な否定的記憶、失敗、退行、拒否されたアプローチ、警告
  • seed: 未解決のアイデア、仮説、フォローアップ、将来の作業

弱いエビデンスから heartwood に昇格させないでください。ユーザーが永続性を確認するか、エビデンスが強力でない限り、outer または seed を優先します。

イベントタイプ

具体的なイベントタイプを優先します:

  • user_preference
  • decision
  • lesson
  • warning
  • correction
  • file_change
  • tool_result
  • summary
  • hypothesis

ホスト統合がより厳格なイベントタイプ名を持つ場合は、最も近いローカル同等のものを使用します。

保存しないもの

以下を保存しないでください:

  • シークレット
  • 認証情報
  • トークン
  • 秘密鍵
  • 生の思考連鎖
  • 一時的なスクラッチパッドのメモ
  • 永続的な真実としての未検証の主張
  • 明示的なユーザー指示なしのプライベートな健康、財務、法的、または個人識別情報の詳細
  • 短い許容スニペットを超える著作権のあるソーステキスト

有用なメモリに機密資料が含まれている場合、役立つコンテキストを残して編集されたサマリーを保存します。

ソースとスコープ

プロジェクトとスコープを意図的に設定します:

  • リポジトリ固有のルール、決定、警告、教訓にはプロジェクトスコープを使用
  • エージェントプロファイルの動作にはエージェントスコープを使用
  • 永続的なユーザーの好みやクロスプロジェクトのガイダンスにのみグローバルスコープを使用
  • ファイルパス、イシュー ID、PR ID、実行 ID、ドキュメントパスなどのソース参照を含める
  • 評価結果には tree-ring evidence ... --evidence-ref <ref> を使用
  • 簡潔な AGENTS.md サマリーには tree-ring dox sync を使用
  • 昇格、拒否、延期、または観察された評価レコードには tree-ring revolve sync を使用
  • 新しいエージェントハーネスを設定する前に tree-ring integrations scan を使用

メモリはソースドキュメントを置き換えるものではありません。リポジトリに AGENTS.md、プロジェクトドキュメント、テスト、アーキテクチャレコード、またはホスト固有の指示ファイルがある場合、それらのソースを直接読み、権威あるものとして扱います。

DOX または Revolve のソースレコードが変更された場合、--dry-run で対応する同期アダプターを再実行し、生成されたメモリを検査し、サマリーが有用でソースにリンクされている場合にのみ書き込みコマンドを実行します。

エージェント媒介更新

Tree Ring Memory は、自律的にチャットをスクレイピングしたり、バックグラウンドで永続メモリを書き込んだりしません。アクティブなエージェントが、Tree Ring コマンドが必要なタイミングを判断し、意図的に CLI を呼び出す責任を負います。

ブリッジファイルは、Tree Ring とそのコマンドリファレンスを発見するためだけに使用します:

  • プロジェクトレベルのブリッジは .tree-ring/SKILL.md と .tree-ring/CLI.md を指すべき
  • グローバルブリッジはオプトインのユーザー設定として扱うべき
  • TUI イベントストリームのパルスは表示信号であり、永続メモリではない

メモリを書き込む前に、教訓が永続的で、有用で、プライバシーに安全で、ユーザーの指示またはソースエビデンスに基づいていることを確認します。

忘却と修正

メモリが間違っている、プライベートである、古くなっている、または置き換えられている場合:

  • 永続的な形状は有用だが詳細が安全でない場合は編集
  • 保持すべきでない場合は削除
  • 新しい決定が置き換える場合は旧メモリを破棄
  • すべての忘却操作に明示的な理由を付けることを優先

以前に想起されたという理由だけで、誤りと判明したメモリを保持しないでください。

クローズアウトの習慣

意味のある作業の終了時に、以下を自問します:

  • 何を決定したか?
  • 何を学んだか?
  • 将来のエージェントが繰り返すべきでないことは何か?
  • ユーザーは永続的な好みを述べたか?
  • 後で再検討する価値のある将来の種はあるか?
  • 保存しない方が良い機密のメモリはあるか?

将来の作業を実質的に改善する答えだけを記憶します。

関連スキル