Claude Codeを毎日のように回していると、ある日ふと気付く瞬間がきます。
「あれ？ この情報、Claudeのメモリにも書いてあるし、プロジェクトの設計md（ドキュメント）にも書いてあるな…どっちが正しいんだろう？」
これが「メモリ vs プロジェクトmd 二重管理問題」です。今夜、筆者はまさにこの問題に派手にハマって、Claude Code内部のメモリ30本を5本に集約し、既存ドキュメント間の矛盾15箇所を解消する大手術をやりました。
※ 本記事は Claude Code（筆者が使用中のAIアシスタント）が筆者の実体験を元に執筆しています。
その実例ベースで、「メモリに書くべきこと」と「プロジェクトmdに書くべきこと」を境界線3分類で整理する戦略をまとめます。
社長：「いやー、これ完全に俺の運用の盲点やったわ。メモリばっか増やして、肝心の設計mdを見に行ってなかった。」
凛：「設計mdに『同じ事故しないように』って書いてあったのに、メモリだけ見て同じ事故再現しかけたんでしょ？ いつ学ぶの？」
策：「凛さん、その通りです。今夜の事件は『AIエージェント運用で必ず直面する構造的な落とし穴』なので、丁寧に解剖していきましょう。」
📌 目次（クリックでジャンプ）
1.【問題提起】Claude Codeで起きる「メモリと設計mdの二重管理」とは
1-1. そもそも「メモリ」と「設計md」は何が違うのか
Claude Codeを使い込んでいくと、ルールやノウハウを保存する場所が2つできます。
| 保存場所 | 中身 | 将弘さん（人間）から見えるか |
|---|---|---|
Claude Codeのメモリ（~/.claude/projects/...../memory/） |
「過去のやり取りで学んだこと」「個人の好み」「事故事例」 | ❌ 基本見えない（ターミナルで開けば見えるが日常的じゃない） |
プロジェクトmd（02_YouTube事業部/QMC/CLAUDE.md 等） |
「チャンネル運営ルール」「制作手順」「制作テンプレ」 | ✅ Finderで普通に開ける |
メモリは「Claude側の内側の知識」、プロジェクトmdは「人間も読める外側のドキュメント」。本来この2つは役割が違うはずです。
Claude：「メモリは積み重ね型の学習記録です。一方プロジェクトmdは、人間とAIが共同編集する正典（SSoT＝Single Source of Truth）として機能します。」
策：「ところが、運用していると同じ情報がどっちにも書かれてしまう瞬間が来るんですよね…。」
1-2. なぜ二重管理になるのか
シナリオはこうです。
- ある日、AIが小さな事故を起こす（例：「30分動画を作って」と頼んだら、間の工程をすっ飛ばした）
- 同じ事故を二度と起こさないために、AIがメモリに「同じ事故防止ルール」を書く
- ところが、そのルールは既にプロジェクトmdに書いてある（過去に同じ事故が起きて記録済み）
- 結果、同じルールがメモリと設計mdの両方に存在する状態が積み重なる
これを半年も続けると、メモリ20本以上 vs 設計md側にも同じ情報という二重管理が完成します。
1-3. 何が問題か：矛盾が起きた時にカオスになる
二重管理の最悪な点は、運用ルールが進化した時にどちらか片方だけ更新されて齟齬が出ることです。
たとえば「音源の冒頭フェードインは15秒」というルールがメモリに書いてあって、後で「冒頭フェードインは廃止・即音」に変わったとします。設計md側は更新したけど、メモリには「フェードイン15秒」のまま残る。
次に新人AIエージェント（or新しいセッション）が起動した時、メモリの古いルールと設計mdの新しいルールのどっちを信じるかでカオスが発生します。
社長：「あ、これマジで起きたわ。今夜まさにこのパターンで一回ミスりかけた。」
凛：「で、AIが古いメモリ拾って『フェードイン15秒で作りますね！』って勝手にやり始めたの？」
社長：「いや、寸前で止めたけど、危なかった。」
2.【AIで変わった】今夜起きた事件と「メモリ整理術だけじゃ足りない」気付き
2-1. 事件：BGM動画作業中に発覚した「同じ事故が設計mdに記録済み」の事実
筆者は副業でYouTube BGMチャンネルを複数運営しています。今夜、あるチャンネルの動画制作で「音源をループして3時間にして」とClaude Codeに頼んだら、AIが間にあるはずのFilmora動画編集工程を飛ばして、いきなり3時間化に進もうとしました。
「あれ？ 順番違うよ。30分音源を作ったら、人間がFilmoraで動画にしてから、それを3時間にするって流れだろ？」と指摘したら、AIが返してきた答えがすごかった。
策：「申し訳ありません、設計mdの該当行を読み飛ばしていました。実は CLAUDE.md に『絶対飛ばし禁止』として明記されていて、過去に同じ事故事例まで記録されていました。」
つまり——同じ事故が過去に既に起きていて、設計mdに「二度とやるな」って書いてあったのに、AIは読みに行ってなかったわけです。
2-2. なぜAIは設計mdを読まなかったのか：「メモリだけで十分」という錯覚
AIが設計mdを読まなかった原因は明確でした。
- AI内部のメモリには「ある程度の情報」が書いてあった
- メモリだけで判断すると「いけそう」に見えた
- そのまま実装に進んでしまった
- 結果、設計mdの「同じ事故警告」セクションを素通り
ここから学ぶべきは：AIのメモリが充実すればするほど、外側の設計mdを読まなくなるという落とし穴です。
2-3. 「メモリ棚卸し」だけでは解決しない理由
「じゃあメモリを整理すれば解決するんじゃ？」と思うかもしれません。実際、月1回のメモリ棚卸しは有効です（この記事で別途解説しています）。
ですが今回の問題は別軸です。「メモリと設計md、そもそもどっちに書くべきか」が曖昧だから、整理しても整理しても重複が再発するんです。
棚卸しはコップの水を捨てる作業。境界線を引かなければ、水は何度でも溢れます。
凛：「つまり、棚卸し以前の問題なのよ。『どっちに書くか』のルールを先に決めないと、永遠にいたちごっこ。」
Claude：「これは構造設計の問題です。情報設計におけるSSoT（Single Source of Truth）原則が機能していない状態と言えます。」
3.【具体例】メモリ30本→5本に集約した「境界線3分類」戦略
今夜の作業で実際にやったことを公開します。4時間ほどの大手術で、結果はこうなりました。
| 整理前 | 整理後 |
|---|---|
| メモリ約30本（あるYouTubeチャンネル関連） | 5本（横断・索引・概要のみ） |
| 設計md内に古い記述（v11.0時代の旧仕様）が残存 | 矛盾15箇所を全部解消 |
| 「どこに書いてあるか分からない」状態 | 「設計md＝チャンネル個別ルール／メモリ＝横断ルール」と境界線確立 |
その鍵になったのが、境界線3分類です。
3-1. A分類：「チャンネル個別ルール」は設計mdに統合（メモリ削除）
タイトル公式、サムネ生成ルール、タグ運用、ファイル命名規約、サムネサイズ、過去動画の事故事例——こういう「そのチャンネル限定のルール」は、メモリじゃなく該当チャンネルの設計mdに統合します。
理由： – 将弘さん（人間）が見えないと意味がない情報 – そのチャンネルを触る時にしか参照されない情報 – 後で「あれ、どこに書いたっけ？」になりやすい情報
整理前は「サムネのサイズ仕様」がメモリにあって設計mdには簡略版しかなかった。今は設計mdに完全版を移して、メモリは削除しました。
3-2. B分類：「複数チャンネル横断ルール」はメモリに残す
「配信プラットフォームの登録は毎週金曜まで」「内部処理はトリガーワード以降ノンストップで進める」「アップロード後は手動で改変コンテンツ宣言する」——こういう「全チャンネル/全プロジェクトに共通するルール」は、特定の設計mdに書いても他のmdが参照できないので、メモリに残します。
理由： – 1つの設計mdに書くと他で見落とされる – メモリはセッション開始時に必ず読み込まれる – 横断的に効くべきルールはメモリが向いている
3-3. C分類：「外部データへの索引」もメモリに残す
「競合チャンネルの偵察データはこのフォルダのこのJSONにある」「過去の分析レポートはこの場所にある」——こういう「外部に実体があって、その場所を覚えておくためのポインタ」もメモリに残します。
理由： – 実データは別の場所にある（jsonファイル、CSVなど） – メモリはその「住所録」として機能 – 設計mdに書くと住所が変わった時に更新漏れしやすい
3-4. 振り分けの判定フロー
迷ったらこのフローで判定：
そのルールは…
├── 1つのチャンネル/プロジェクトに特化してる？
│ └── YES → A分類（設計mdに統合）
├── 複数チャンネルで使う？
│ └── YES → B分類（メモリ残置）
└── 外部データへの参照？
└── YES → C分類（メモリ残置）
ここまでで「学習にもう少し時間が欲しい」と思った方へ、参考までに：
PR / アフィリエイトリンク
通勤や作業の合間にAI設計やドキュメント整理の基礎を耳で学べる本が結構出ています。文字を追う気力がない日でも、流しっぱなしで頭に残るので筆者も使っています（業界相場ベース：類似の「ながら学習」サービスはどれも月額1,500円前後ですが、Audibleは無料体験期間中なら実質ゼロ円で1冊読めるのが入口として強い）。
4.【じゃあどうやる？】今日から始める5ステップ手順
Step 1：矛盾の洗い出し（30分）
まず「メモリと既存設計md、それぞれに同じテーマで書かれている箇所」を並べて比較します。
今夜の例で言うと、こうやりました：
# メモリ一覧
ls ~/.claude/projects/.../memory/ | grep -i qmc
# 設計md一覧
ls "02_YouTube事業部/QMC/" | grep ".md"
両方を見比べて、同じテーマの記述を抽出。「メモリ20本 vs 設計md 2本」みたいな歪な分布が見えます。
ここでさらにAIに「メモリ側と設計md側で矛盾してる記述を全部洗い出して」と頼むと、矛盾15箇所みたいな具体的なリストが出てきます。
Step 2：完全重複の即削除（5分）
メモリの中身と設計mdの中身を見比べて、95%以上同じ内容のものはメモリ側を即削除します。
判断基準： – 設計mdに同じ情報が完全にある → メモリ削除OK – 設計md側が部分的だが、メモリの細部に新しい情報がある → Step 3へ – 設計mdに何も書いてない → Step 3へ
Step 3：追記が必要なものを統合（1-2時間）
設計md側が不完全なら、メモリの内容を設計mdに追記してからメモリを削除します。
ここでのコツ： – 「どのセクションに追記するか」を明確に決めてから始める – 既存セクションを破壊しないよう、新規見出しで境界化 – メモリの内容をそのままコピペじゃなく、要点を凝縮して本文化
Step 4：横断ルールはメモリに残す（5分）
B分類（複数チャンネル/プロジェクトで使うルール）はメモリに残置します。ここでは何も削らない。
Step 5：索引（MEMORY.md）を最新に更新（10分）
メモリのインデックスファイル（MEMORY.md）から、削除したメモリへのリンクを全部削除し、残ったメモリだけのスッキリした目次にします。
ここで便利なのが、AIにそのまま依頼することです：
「~/.claude/projects/.../memory/MEMORY.md を開いて、feedback_qmc_* セクションを整理して。削除済みメモリへのリンクは全部消して、残ったメモリだけのリストにして」
5分で完了します。
社長：「これ、夜にやり始めて気付いたら4時間経ってたわ…でもめっちゃスッキリした。」
策：「全工程をAIに任せれば1人作業ですが、それでも構造の判断は人間がした方が良いです。Step 1の『振り分け表を作る』ところまでは人間が舵を取りましょう。」
副業全体の効率化も、こういう小さな整理から
副業を複数並行している人ほど、ドキュメント管理のカオスが時間を奪っています。実際、「3時間で動画3本作るはずが、ファイル探しと『あれ、どこに書いたっけ』で2時間溶けた」みたいな経験は誰しもあるはず。
整理術を磨きたい人、もしくは「自分でやる時間がない、誰かに発注したい」という人にはこちらが入口として最適です：
PR / アフィリエイトリンク
副業の「整理術」自体を売る人もいれば、整理を依頼する人もいます。業界相場ベース：1回1,000円〜10,000円くらいで「フォルダ整理代行」「ドキュメント設計レビュー」などが取引されています。
5. よくある質問（FAQ）
Q1：メモリと設計mdの境界線、もっとシンプルにできない？
A： 究極的には「人間が見たい情報か？」で振り分けてOK。人間が見るなら設計md、AI内部だけで完結するならメモリ。これだけでも8割の振り分けは正しくなります。
Q2：プロジェクトmdが複数あって、どれに統合するか迷う
A： 入口（CLAUDE.md）と詳細（OPERATIONS.md）と運営（テンプレ群）の3階層に分けて、詳細ルールはOPERATIONS.md、運用フローはCLAUDE.md、テンプレは個別ファイルという棲み分けが安定します。
Q3：メモリ整理は何ヶ月に1回がベスト？
A： 「事故が起きた直後」がベスト。月1ルーチンは保険として有効ですが、事故直後の方が記憶が鮮明で整理の質が高くなります。
Q4：AIに任せて勝手に整理させていい？
A： 「分類判定」までは人間がやるべきです。AIに「これはA分類でいい？」と聞きながら進める方が、後で「これメモリに残しておけば良かった」みたいな後悔が減ります。実装（追記＋削除）はAIに任せてOK。
Q5：他のAIエージェント（ChatGPT、Cursor等）でも同じ問題は起きる？
A： はい、起きます。ただしClaude Codeほどメモリ機能が強力じゃないツールでは、メモリ依存度が低いので二重管理にはなりにくいです。逆に言うと、Claude Codeを使い込んでいる人ほどこの問題に必ず遭遇します。
6. まとめ｜伝えたかったこと
今夜の事件と整理作業で確信したこと：
- メモリと設計mdの二重管理は、Claude Codeを使い込むほど避けられない構造的な問題
- 「メモリ棚卸し」だけでは解決しない。境界線の設計が先
- A分類（個別ルール）／B分類（横断ルール）／C分類（外部データ索引）の3分類で振り分ければ、ほぼ全てのケースをカバーできる
- 整理は事故直後がベスト。記憶が鮮明なうちに分類判定だけは人間がやる
凛：「Claude Codeを真面目に使ってる人ほど、半年に1回はこれをやることになる。覚悟しておいて。」
策：「逆に言えば、この整理ができる人は『単にAIを使う人』から『AIの環境を設計する人』にレベルアップしたとも言えます。」
社長：「俺もまだまだやけど、今夜のこの作業は、たぶん来週の作業時間を3時間は節約してくれる。整理は投資や。」
次に読むべき記事
- 【2026年最新】Claude Codeメモリ棚卸し術｜40代非エンジニアがAIに同じミスを2度させない5つの仕組み — メモリ単体の整理術（月1ルーチン）
- 【2026年最新】AIに古い情報を読ませない｜Claude Code × ドキュメント設計5原則 — そもそも古い情報を残さないための設計原則
- 【2026年最新版】散らかったデスクトップを5分で片付ける！Claude Code × フォルダ整理術7ステップ完全ガイド — ドキュメントだけじゃなくファイル整理にも応用できる入口
Claude Code をまだ触ったことがない人へ
ここまで読んで「ちょっと触ってみたい」と思った方は、Anthropic公式の紹介プログラムからどうぞ。1週間の無料体験ができます。
PR / アフィリエイトリンク
⚠️ 業界相場ベース：AIエージェント系の有料プランは月額20ドル前後（約3,000円）からが相場で、Claude Code はこの Pro プラン（月20ドル）に同梱されています。上記の紹介リンク経由の1週間無料枠を使えば、この記事で書いたような「ドキュメント整理大手術」レベルの作業が課金前にひと通り試せます。筆者の体感では、半年使い込んだ今、月3,000円は十分に元が取れているレベルの時間圧縮効果があります。
※ 本記事は Claude Code（筆者が使用中のAIアシスタント）自身が、筆者の実体験を元に執筆しています。
※ 本記事にはアフィリエイトリンクが含まれます。
