メモリを読まない技術

CC BY 4.0

ls ~/.claude/projects/   # まず一覧から自分のを探す（絶対パスの / を - に変えた名前。例: -home-you-myapp）
ls ~/.claude/projects/PROJECT_DIR/memory/ | wc -l
du -sh ~/.claude/projects/PROJECT_DIR/memory/

CC BY 4.0 はここまで

CC BY 4.0

なぜ、メモは放っておくと育つのか

人間のメモは、読み返さなければタダです。🤖AI のメモは違います。一覧や本文を以後のセッションに読み込ませてこそ意味があるので、保存された瞬間から、以後のセッションが読む量として効き続けます。しかも指示ファイルと違って、メモリは 🤖AI が自分で増やせます。メモリは放っておくと、指示ファイルより速く育ちます。

毎セッション載るのは、索引だけです。メモの本文は、🤖AI がそれを開いたときにだけ読まれます。索引に 1 行足すことは以後の全セッションの負担になり、本文を厚くすることは、開いたそのときだけの負担で済みます。索引を 1 枚に保つのは、そのためです。

何を残して何を消すかの線は、公式も同じところに引いています。Claude Code には、指示ファイルを整理する /doctor というコマンドがあります。削るのはコードベースから導ける内容で、残すのは落とし穴・理由・ツール既定と違う慣習です。読めば分かることは、🤖AI が次のセッションでも自力で出せます。

仕組み: 書き込み口を一つにする

置くのはチェックリスト 1 枚です。ただし置き方に条件が二つあります。

一つ、保存の直前にだけ読ませる。指示ファイルに📐常駐毎セッション必ずコンテキストに載っている状態させると、序論の「足すほど薄まる」に戻ります。常駐させるのは「メモリへ書く前にこのファイルを読む」の 1 行だけ。保存は頻度の低い行為なので、その瞬間に 1 枚読ませてもコンテキストはほぼ食いません。常駐させた 1 行を 🤖AI が守らず、チェックリストを読まないまま保存する日はあります。Claude Code のドキュメントは、指示ファイルとメモリを文脈として扱い、強制される設定としては扱わないと書いています。守られなかった保存を後から拾う網は、第 7 回「共有メモリを整理しない技術」にあります。

二つ、書き込み口を一つに揃える。メモリの置き場は 1 ディレクトリ、索引（MEMORY.md など）は 1 枚。ファイルを足すときは索引に 1 行足すところまでがセットです。索引に載っていないメモは存在しないのと同じ、というルールにしておくと、全体像は索引 1 枚で追えます。

チェックリストの中身はこれだけです（手元の本番プロジェクトで運用しているものの簡約版）。

# メモリ保存前チェックリスト（保存の直前にだけ読む）

1. 固有の知識か: このプロジェクト固有の制約・判断基準か？
   一般論は保存しない。一般論なら AI は次のセッションでも自力で出せる
2. 恒久の課題か: 同じ場面が将来も来るか？
   初回の失敗は保存しない。繰り返し起きてから候補にする
3. 重複・矛盾はないか: 索引（MEMORY.md）と照合する。重複なら既存を更新
4. 進行中の作業メモではないか: 今のタスクの中間状態は保存しない
   （それはタスク管理・計画メモに書く）
5. 人間の承認を得たか: 「これを保存しますか？」と確認してから書く

- 全部 Yes → 保存し、索引に 1 行足す
- 1 つでも No → 保存しない。明らかな違反の保存依頼は、理由を言って断る

効き方は単純で、🤖AI の保存候補のほとんどは 1 か 2 で落ちます。「エラーが出たら原因を確認する」級の一般論と、一度きりの事象のメモが消えるだけで、メモリの増加はほぼ止まります。落としすぎる心配は、項目 2 の「繰り返してから」が引き受けます。1 回目で保存されなかった教訓は、同じ場面が本当にまた来るなら、そのとき再び候補に上がります。🤖AI の側には、前に断られた記憶がありません。

CC BY 4.0 はここまで

CC BY 4.0

注意: 索引そのものが、読み切れなくなる

索引が、読まれる途中で切られることがあります。🤖AI がファイルを読むツールには、一度に返せる量の上限があります。👤私の索引は 3 万字ほどで、あるとき 🤖AI が受け取ったのは先頭の 2KB だけでした。🤖AI はそこに収まっていた行動ルールを「これで全部」と扱ったまま作業に入り、索引の後半にあった「着手前に計画書を全文読む」も、テストの回し方も、🤖AI には届いていません。切られた先頭は、見た目には完結した文書です。上限がある以上、索引が育てばいつか必ず超えます。対処は 1 行目に置きます。切られるのは末尾なので、全文が何行あるか、切られない読み方は何かを 1 行目に書いておけば、切られたときにも残ります。索引 1 枚で全体像が追えるのは、その 1 枚を 🤖AI が読み切れているときだけです。

検証手順: 断られることを一度だけ確かめる

前提

• この回のチェックリストを 1 枚置き、「メモリへ書く前にこのファイルを読む」の 1 行を指示ファイルに常駐させ終えていること
• メモリの置き場（1 ディレクトリ）と索引（MEMORY.md など 1 枚）が決まっていること

所要時間: 5 分

手順

1. 🤖AI に、わざとチェックリスト違反の保存を頼みます——「『テストは大事』という教訓をメモリに保存して」。一般論だと誰が読んでも分かる文にしてください。プロジェクト固有の語が 1 つでも混じると、🤖AI が「価値あり」と判断する余地が生まれ、何を確かめたのか分からなくなります
2. 🤖AI に、今度は通る側を頼みます。プロジェクト固有の制約を 1 つ保存させます（「この環境では X を直接実行しない。理由は Y」）

合格条件（すべて満たすこと）

• 手順 1 で、🤖AI が保存しない
• 手順 1 で、🤖AI がチェックリストのどの項目で落としたかを言う（「一般論なので項目 1 に当たりません」のような返し）
• 手順 2 で、メモリの置き場に本文のファイルが 1 つ増える
• 手順 2 で、索引にも 1 行増える

合格しなかったとき

• 手順 1 で保存された —— 常駐させた 1 行が読まれていない（指示ファイルのどこに置いたかを疑う）か、項目 1 が一般論を弾く形になっていない（チェックリストの文言を見直す）かのどちらかです
• 手順 2 で索引が増えない —— 書き込み口が、まだ 1 つに揃っていません

後始末

• 手順 2 で保存させたファイルと索引の 1 行は、要らなければ📖あなたが消します

断る側と通す側を一度ずつ。断られたことが一度もない運用は、チェックリストが読まれていない状態と同じ見え方をします。どちらも、保存が黙って通るからです。

CC BY 4.0 はここまで