memory-reflect

Memory Reflect

最近のアクティビティを振り返り、価値ある知見を長期記憶にまとめます。

スリープ時の計算に着想を得ています。記憶の形成は、アクティブなセッション中ではなく、セッションの合間に最も適切に行われるという考え方です。

実行するタイミング

• Cron/ハートビート：定期的なバックグラウンドタスクとしてスケジュールします（推奨：1日1〜2回）
• オンデマンド：ユーザーが振り返り、統合、または最近の記憶の確認を依頼したとき
• 圧縮後：コンテキストウィンドウの圧縮イベントの後

手順

1. 最近の情報を収集する

最近何が変わったかを確認し、関連ファイルを読み込みます。

# Find recently modified notes — use json format for the complete list
# (text format truncates to ~5 items in the summary)
recent_activity(timeframe="2d", output_format="json")

# Read specific daily notes
read_note(identifier="memory/2026-02-27")
read_note(identifier="memory/2026-02-26")

# Check active tasks
search_notes(note_types=["task"], status="active")

2. 重要な情報を評価する

情報ごとに、次の点を確認します。

• 今後の作業に影響する決定事項ですか？ → 保持
• 学んだ教訓、または避けるべき失敗ですか？ → 保持
• 好み、または作業スタイルに関する知見ですか？ → 保持
• 関係性に関する情報（誰が何をするか、連絡先など）ですか？ → 保持
• 一時的な情報（天気の確認、ハートビートの実行、定型タスクなど）ですか？ → スキップ
• すでにMEMORY.mdや別の長期記憶ファイルに記録されていますか？ → スキップ

3. 長期記憶を更新する

既存の構成に従って、まとめた知見をMEMORY.mdに書き込みます。

• 新しいセクションを追加するか、既存のセクションを更新します
• 簡潔で事実に基づいた表現を使います
• 時系列の背景が分かるように日付を含めます
• 新しい情報で置き換えられた古い記述を削除または更新します

4. 振り返りを記録する

今日の日次ノートに簡潔な記録を追記します。

## Reflection (HH:MM)
- Reviewed: [list of files reviewed]
- Added to MEMORY.md: [brief summary of what was consolidated]
- Removed/updated: [anything cleaned up]

ガイドライン

• 情報を厳選してください。 目指すのは重複ではなく、要点の抽出です。MEMORY.mdは日次ノートのコピーではなく、精選された知恵を記録するものです。
• 話し方を保ってください。 エージェントにパーソナリティや魂を記したファイルがある場合、振り返りもその話し方に合わせます。
• 日次ノートは削除しないでください。 日次ノートは生の記録です。振り返りではそこから情報を抽出しますが、置き換えるものではありません。
• 追記ではなく統合してください。 MEMORY.mdにすでに関連トピックのセクションがある場合、重複する項目を追加せず、そのセクションを更新します。
• 不確かな点を明記してください。 重要そうでも確信が持てない情報は、完全に省くのではなく「（要確認）」などの注記を付けて追加します。
• 時間をかけて再構成してください。 MEMORY.mdが時系列の記録になっている場合、振り返りの際にトピック別のセクションへ再構成します。精選された知識は、生のログよりも価値があります。
• ファイルシステムの問題を確認してください。 情報収集の際に、再帰的な入れ子（memory/memory/memory/...）、孤立したファイル、肥大化がないか確認します。