Claudeの作業メモリとCLAUDE.mdを1ページに収める理由

このサイトでは、AIを提供しているAnthropic社自身の教材「Claude Academy」を読み、そこに書かれている考え方を自分の運用にどう当てはめたかをシリーズで書いていきます。1回目のテーマは、セッションの始め方と、指示書（CLAUDE.md）の分量です。

セッションは何を読んで始まるか

Claude Codeは、作業を始めるたびにCLAUDE.mdという指示書ファイルを自動で読み込みます。公式は、変更を加える意図がなくまず概要だけ知りたいときは、細かく計画を立てる前に調べる担当だけを動かす方法もあると説明しています。また、作業を続けたいときは会話を要約して圧縮し、新しい作業を始めるときはいったん会話を空にする、という2つの使い分けがあり、今どれだけの分量を読み込んでいるかは専用のコマンドで確認できるとされています。

この「毎回自動で読み込まれる」という性質が、次の節の話につながります。自動で読まれるからこそ、そこに書く分量には責任が伴うということです。

なぜCLAUDE.mdを「1ページ」に近づけるべきなのか

公式は、CLAUDE.mdを「1ページ以内」に収めるべきだと述べています。理由は単純で、この指示書は作業を始めるたびに全文読み込まれるため、古くなった内容や冗長な説明は、役に立たないままAIの理解力を消費し続けるからです。

もう1つ、公式が紹介している研究があります。長い文章の中間に置かれた事実は、冒頭や末尾に置いた場合より正確に扱われにくくなる、というものです。この性質があるため、公式は最も重要な指示ほど、指示書の最初と最後に置くべきだとしています。逆に言えば、毎回必ず実行してほしいことは、AIへの文章での指示に頼らず、決まった動作として自動化してしまうほうが確実だということです。

実際にどう当てはめたか

自分の運用ノートを数えてみたところ、自分で決めていた上限にはまだ収まっていたものの、公式が言う「1ページ」よりはずっと大きい分量になっていました。中身を見直すと、ノートの冒頭に「作業を始める前に、まずこの記録とあの記録を読むこと」という指示が書かれていましたが、その同じ範囲は、セッションが始まった瞬間に自動で読み込まれる仕組みがすでに担当していました。つまり、AIに文章で「読んでください」と頼んでいた部分は、頼まなくてもすでに終わっている作業だったのです。

そこで、その指示を「この範囲は自動で読み込み済みなので、次に進んでください」という1文に書き換えました。二重に読み込む分の負担が減っただけでなく、指示書を「1ページ」に近づけるという公式の方向性にも、一歩沿う形になりました。次にこの指示書を見直すときは、真ん中あたりに埋もれている長い説明を、必要なときだけ開く別のファイルへさらに逃がす作業に進む予定です。

このあとも読み解きを続けます

Claude Academyには、CLAUDE.mdの分量以外にも、スキルの作り方や、検査の役割を分ける考え方など、まだ読み解いていない章がたくさん残っています。このページは「公式知見の読み解き」シリーズの1回目です。これから同じ形式（公式の主張と出典を先に置き、自分の運用にどう当てはめたかを1つ添える形）で数を増やしていく予定です。