メインコンテンツへスキップ
見出し画像

第二の脳はどこに置く?CLAUDE.mdとメモリを比べた

    シリーズ「コードが書けない私が話題のアレを確かめる」その3

    コードが書けないレノンです。物販が本業の個人事業主で、非エンジニアです。

    今回はその2「Obsidianがあれば私の苦労は要らなかった?比べてみた」の続きです。
    Obsidian と比べたあとに残った疑問の答えを書きます。

    AIに毎回同じことを説明するのが面倒で、覚えてほしいことを説明書やメモリに書き足していく。
    それ、毎回の費用になっていませんか。

    私の場合、ある話題の関連部分だけでAIが一度に読める量の37%を毎回使う計算でした。
    別の仕事のセッションとメモリが混ざっていたこともあります。

    Claude Code には知識を置ける場所が最初から2つあります。

    • 説明書(CLAUDE.md):作業フォルダに置く説明書。セッションを開くたびに全文が自動で読み込まれる

    • メモリ(auto memory):AIが作業の途中で自分で書き足していく記憶。次のセッションでも読まれる

    私はナレッジをどちらにも置きませんでした。ふつうの文書ファイルのフォルダに置いています。
    今回はその理由を書きます。

    説明書に全部書かなかった理由

    全部はそもそも入らない

    「ナレッジをためるほど、AIは賢くならなかった」で書いたとおり、分ける前の68万字でもAIが一度に読める量の2倍以上ありました。今のナレッジは約105万字です。

    毎回の固定費になる

    説明書に書いたものはその話題を使わない日も毎回読まれます。
    ある話題の関連部分だけで一度に読める量の37%を毎回使う計算でした。
    文書のフォルダに置いておけば保管はタダ。説明書に写した瞬間に毎回の費用に変わります。

    上の階の説明書は下の全部に効く

    実際に測って分かったことがあります。
    子のフォルダでセッションを開くと親のフォルダの説明書も読まれます。

    親に知識を書けばその下にある関係ないプロジェクト全部で毎回読まれることになります。

    写すと静かに食い違う

    同じことを説明書とナレッジの2か所に書くと片方だけが直されます。そのうちどちらが正しいのか分からなくなります。

    書いても守られない

    説明書に「膨らませないように気をつける」と書いても効きませんでした。記録の上で5回、書いたのに守られなかった例があります。
    守らせたいことは説明書ではなく、「AIは賢いけど、「気をつけます」ではミスが直らない」で書いたスクリプトと検査にしました。

    メモリに置かなかった理由

    メモリはAIが自分で書き足す記憶です。便利そうに見えますが、実際に困ったことがありました。

    古くなっても気づかない

    メモリはAIが作業の途中で黙って書き足します。
    ナレッジの方が新しくなっても、メモリを合わせて書き直す仕組みはありません。古いまま残っていても、照らし合わせる人がいないので気づけません。

    別の仕事のセッションと同じメモリを読んでいた

    一番驚いたのはこれです。
    もしあなたが作業フォルダに日本語の名前を付けているなら、一度確かめてみてください。

    メモリの置き場所は作業フォルダの名前から自動で決まります。そのとき日本語の文字は記号に置き換えられます。
    たとえば同じ場所にある「経理」と「営業」のように、文字数が同じで日本語だけの名前は、どちらも同じ置き場所になります。

    ぶつかっていたのは2組。実際に別の仕事のセッションが同じメモリを読んでいました。
    片方の仕事で覚えたことが、もう片方の仕事の前提として読み込まれるということです。
    フォルダの名前を英字に変えて、ようやく解消しました。

    履歴も検査も無い

    ナレッジは git で版が残り、記録の前に検査が走り、毎日バックアップされます。メモリはそのどれにも入っていません。いつ何が書かれたのか追えません。

    AIの要約はAI自身では確かめられない

    以前AIに勧められるがまま決めてきたことを、「判断の事例集」にまとめようとしたことがあります。
    今後の判断の基準にするつもりでした。

    でも私はほとんどの判断に「それでお願いします」と答えていただけです。
    知識のないことを「これでいいですか?」と聞かれても、私には分からないからです。

    しかも記録もAIが要約して書いたものです。
    どんな場面でどう決めたのか、今さら思い出す手段がありませんでした。

    そこでAI得意の「予想して埋める」が始まると、予想が予想を呼びます。
    作った翌日には、ある数字が「確かめた基準」のように載っているのを見つけました。元の記録のすぐ隣には「その数字は効果としては見分けられていない」と書いてあったのにです。

    判断の基準を目指したのに、できたのはAIの自由帳でした。
    私が読んで使えないと判断して消しました。

    メモリもAIが自分で書くものです。
    AIが自分の言葉でまとめたものが、次のセッションで「事実」として読み込まれます。

    「節番号を振って検索すれば、どちらでもよいのでは?」

    ここまで書いて、私自身も一度こう思いました。

    ナレッジでやっているのは「節番号を振る → 検索する → 必要な範囲だけ読む」です。同じことを説明書やメモリでやればよいのではないか。

    答えは「方法は正しい。問題は置き場所」でした。


    画像

    説明書に置くとうまくいかない

    説明書は検索する前に全文が読み込まれています。
    セッションを開いた時点で丸ごと入るので、節番号を振っても費用は読み込んだ時点で払い終わっています。「必要なところだけ」が成り立ちません。

    メモリに置くと動くが損が多い

    メモリの中身も実は文書ファイルのフォルダです。最初に読まれるのは目次だけなので、節番号と検索は技術的にはできます。

    でも、それはナレッジのフォルダと同じものをもっと悪い場所に置くことになります。

    「メモリを git に入れれば解決するのでは?」

    これも考えました。解決するのは1つだけです。

    • 解決する:版の履歴が残る。消えても戻せる

    • 解決しない:置き場所がぶつかる。git に入れても混ざること自体は止まらない

    • 解決しない:フォルダの数だけ散らばる。メモリは作業フォルダごとに別々なので、15のプロジェクトなら15か所に分かれる

    • 解決しない:AIがいつでも黙って書き足す。記録は残っても誰も読まない

    • 解決しない:古い記憶が確かめる前に「事実」として読み込まれる

    git を足し、置き場所を1つにし、検査を足していくと、最後は今のナレッジのフォルダをメモリの場所に作り直すことになります。
    わざわざ悪い場所に作る理由がありませんでした。

    今の形

    • 説明書:「どこを見ればよいか」の案内と、やってはいけないことだけ。毎回読まれる説明書3つを合わせて約2万字、ナレッジ全体の約2%

    • メモリ:仕事の進め方の小さな好みだけ。たとえば「別のセッションに貼る2文は1つの枠にまとめて出す」。今は2件だけで、どちらも進め方の好みか「どこを見ればよいか」の案内です

    • 知識:ナレッジのフォルダにだけ置く。どのプロジェクトの説明書にも「ナレッジはここ」とだけ書いて、全員が同じものを見る

    親フォルダの説明書(CLAUDE.md)にも1行書きました。「知識はメモリに置かない。ナレッジに書く」。

    確かめられる場所に置く

    説明書を短くする話はよく見かけます。
    手順をスキルに分ける、目次だけを書く。それは私も同じです。

    ただメモリについては便利な置き場所として紹介されることが多いように思います。
    私は逆に別の仕事のセッションとメモリが混ざっていたことに後から気づきました。

    どちらが正しいというより、AIに運用させるなら確かめられる場所に置く。それが失敗から私が出した答えです。

     
     
    物販が本業の個人事業主。非エンジニア。 AIの使いっ走りだった私が見つけた、仕事の任せ方をシェアします。 Claude Codeで自分の仕事を自動化中。専門家の解説ではなく、うまくいかなかったことも含めた実録です。

    あなたへのおすすめ