memory-defrag

メモリーのデフラグ

明確さ、効率、関連性を高めるためにメモリーファイルを再編成します。知識を対象にした、ファイルシステムのデフラグのようなものです。

実行するタイミング

• 定期的：cron で毎週または隔週に実行します（推奨）
• 必要に応じて：ユーザーからメモリーの整理、再編成、デフラグを依頼されたとき
• しきい値：MEMORY.md が約 500 行を超えたとき、または統合されないまま日次メモが蓄積したとき

プロセス

1. 現状を監査する

すべてのメモリーファイルを一覧にします。

MEMORY.md           — long-term memory
memory/             — daily notes, tasks, topical files
memory/tasks/       — active and completed tasks

各ファイルについて、行数、最終更新日時、トピックの範囲、情報の古さを記録します。

2. 問題を特定する

次のようなよくある問題がないか確認します。

問題	兆候	対処
肥大化したファイル	300 行を超え、多くのトピックを扱っている	トピックごとにファイルを分割する
情報の重複	同じ事実が複数の場所にある	1 か所に統合する
古い項目	完了した作業、古い日付、解決済みの問題への言及がある	削除するか、アーカイブする
孤立ファイル	memory/ 内にあり、参照も更新もされていないファイル	確認し、統合または削除する
矛盾	ファイル間で情報が矛盾している	正しい情報に基づいて解決する
整理不足	関連情報がファイル間に散在している	トピックごとに再構成する
再帰的なネスト	memory/memory/memory/... ディレクトリ	ネストされたディレクトリを削除する（インデクサーのバグによる生成物）

3. 変更を計画する

編集する前に、簡潔な計画を書きます。

## Defrag Plan
- [ ] Split MEMORY.md "Key People" section → memory/people.md
- [ ] Remove completed tasks older than 30 days from memory/tasks/
- [ ] Merge memory/bm-marketing-ideas.md into memory/competitive/
- [ ] Update stale project status entries in MEMORY.md

4. 実行する

変更を 1 つずつ適用します。

• 分割：大きなファイルからセクションを抜き出し、トピックに特化したファイルに分けます
• 統合：関連する小さなファイルを、まとまりのあるドキュメントにまとめます
• 削減：関連性がなくなった情報や正確でなくなった情報を削除します
• 再構成：ファイルを適切なディレクトリに移動し、わかりやすい名前に変更します
• 更新：古くなった事実、日付、ステータスを修正します

5. 検証して記録する

変更後に、次のことを行います。

• 情報が失われていないことを確認します（変更前と変更後を比較します）
• ファイル間の相互参照を更新します
• 今日の日次メモに実施内容を記録します。

## Memory Defrag (HH:MM)
- Files reviewed: N
- Split: [list]
- Merged: [list]
- Pruned: [list]
- Net result: X files, Y total lines (was Z lines)

ガイドライン

• 生の日次メモを保持します。 memory/YYYY-MM-DD.md ファイルは監査記録なので、削除も変更もしないでください。
• 15～25 個の、トピックに特化したファイルを目指します。 少なすぎるとファイルが肥大化し、多すぎると情報が細分化されます。最適なバランスを目指してください。
• ファイル名は一目で内容がわかるものにします。 people.md、project-status.md、competitive-landscape.md のような説明的な名前を使い、notes-2.md のような名前は避けてください。
• 整理しすぎないでください。 通常、ディレクトリは 1 階層で十分です。memory/tasks/ や memory/competitive/ は問題ありませんが、memory/work/projects/active/basic-memory/notes/ は避けてください。
• 完了したタスク：status: done のタスクは、完了から 14 日を超えたら削除できます。得られた知見は、振り返りを通じてすでに MEMORY.md に記録されているはずです。
• 破壊的な変更の前に確認します。 情報がまだ関連しているか判断に迷う場合は、削除せず (review needed) タグを付けて残してください。