前提を「いつも読む・必要なときに読む・探して読む」の3段に分ける

CLAUDE.md は、毎回の会話の始めに読み込まれます。Claude Code のドキュメントによると、作業しているフォルダとその上の階層にある CLAUDE.md と CLAUDE.local.md（自分だけの設定を書くファイル。共有しない）は起動時に読まれ、下の階層にあるものは、そのフォルダの作業を始めたときに読まれます。

長さの目安は1ファイル200行以内です。長くなると窓を多く使ううえに、守られにくくなるとされています。また、@ファイル名 で別のファイルを読み込ませる書き方がありますが、ドキュメントには「整理には役立つが、読み込んだファイルも起動時に全部読まれるので、窓の消費は減らない」とはっきり書かれています。

だから1段目には、ほぼすべての作業の判断に効くものだけを置きます。目安は「これを読まずに作業したら、事故が起きるか」。起きないなら、ここに置く必要はありません。

ドキュメントでは、コードの一部にしか関係しない指示は、パスを指定したルール^※1に移すよう勧めています。指定したファイルを扱うときだけ読み込まれるので、ふだんの窓を使いません。

たとえば「テストのファイルは〜の形で書く」というルールは、テストを書くときにしか要りません。1段目に置いておく理由はありません。

スキル^※2は、ふだんは名前と短い説明だけを見せておき、必要になったときに本文を読み込む仕組みです。記事の書き方、公開の手順、特定のツールのくせなど、決まった作業でしか使わない前提は、ここに移します。

どのスキルを呼ぶかは、AIが説明文を読んで判断します。だから説明文は「何のスキルか」より「どんな頼まれ方をしたときに使うか」を書くほうが効きます。ドキュメントによると、説明文と when_to_use（使う場面を補足する欄）は、一覧に載せるときに合わせて1,536文字で切られます。大事な使い方を先に書いておきます。

スキルの本文は、呼ばれたあとは会話の中に残ります。ドキュメントによると、会話が要約されるときにも、呼んだスキルは直近の分が要約のあとに付け直されます（1つにつき最初の5千トークンまで、全部で2万5千トークンまで）。

つまり、スキルの本文が長いと、呼んだあとの会話ではずっと窓を使い続けます。本文には判断に必要な手順を書き、決まった処理（変換、集計、整形）はスキルと一緒に置いたスクリプトに任せるほうが、窓も節約でき、結果もぶれません。

過去の記事、議事録、大きなコードの大部分のように、量が多すぎて読ませきれないものは、必要な部分だけを探して読ませる段に置きます。

Anthropic の記事では、これを「必要になったときに読む（just in time）」やり方として紹介しています。全部を先に読ませるのではなく、ファイルのパスや検索の手がかりだけを持たせておき、必要になったら道具で読み込む、という考え方です。Claude Code が grep（文字列でファイルの中身を探すコマンド）や glob（名前のパターンでファイルを探すこと）で必要なファイルだけを開くのも、このやり方です。

検索の質が、そのまま答えの質になります。何が読み込まれたのかを、あとから確かめられるようにしておくと安心です。

迷ったら、1段目から外してみて、困るかどうかを試すのがいちばん早いです。困ったら戻せばすみます。