CLAUDE.md の肥大化・重複・漏れを防ぐ習慣
CLAUDE.md は、使い続けるうちに散らかっていきます。長くなりすぎる、同じルールが2か所にある、書いたはずのことが守られない。
私に実際に起きたことと、防ぐために続けている習慣を紹介します。
指示が漏れ出した
あるとき、伝えたはずの指示が守られなくなってきました。
漏れていることを部長（部門ごとのフォルダで動く Claude Code）に伝えると、返ってきたのは、CLAUDE.md の中身が多くなって全部は読み切れていなかった、という答えでした。
さらに調べてもらうと、もう1つ問題が見つかりました。上のフォルダの CLAUDE.md と、その下のフォルダの CLAUDE.md に、同じルールが重ねて書かれ、無駄な部分ができていたのです。
そこで私は、CLAUDE.md の整理を頼みました。長くなりすぎた中身と重なっていたルールを片づけて、ルールが漏れずに無駄なく作業できる形にしてほしい、と。
長さと重なりが起こすこと
長くなるほど守られにくくなることは、Claude Code の公式の説明にも書かれています。
同じルールが2か所にあるだけなら、食い違いは起きません。ただ、Claude Code に同じことを2回読ませることになり、その分が無駄になります。
困るのは、微妙に違うルールが2か所にある場合です。公式の説明にも、2つのルールが食い違うと、Claude Code がどちらかを選んでしまうことがある、とあります。
なお、まわりのルールが違う部門に書き写すと、同じルールでも受け取り方がずれることはあります。私が書き写して失敗した話は、こちらの記事で解説しています。
関連記事：Claude Code では方針と指示が上から下に流れる
整理の手順書と点検の職人
今、制作部門（サイトを作る部門）で使っているのは、CLAUDE.md を整理する手順書（スキル）。この手順書は、同じルールが2か所に書かれていないかも確かめます。
企画部門（アイデアと構成を考える部門）には、同じ整理の手順書に加えて、CLAUDE.md を点検する寡黙な職人（サブエージェント）もいます。頼まれた仕事を黙々とこなす担い手です。
使い方は、こちらの記事へ。
関連記事：点検はスキルとサブエージェントに任せ、決めるのは社長
場所が伝わらないと読まれにくい
別の形の漏れもありました。あるチャットで足したルールが、別のチャットでの作業に届きませんでした。
原因は、CLAUDE.md とは別のファイルにルールを足したのに、毎回読まれる CLAUDE.md にその場所が書かれていなかったこと。
毎回自動では読まれないファイルは、どこにあるかが伝わらなければ、読まれにくくなります。
まず、ルールを足したファイルの場所を、CLAUDE.md に書いて案内するようにしました。
ただし、公式の説明では、言葉で場所を案内しただけのファイルは、Claude Code が開くと判断したときにだけ読まれます。
そのため、書いた記事をブラウザで確かめるときに使うプログラムが、毎回部長にそのルールを読み直すよう知らせる形にもしました。
CLAUDE.md を分けて軽くするときの考え方は、こちらの記事で解説しています。
分けた先のファイルが散らかったときの整理の仕方は、こちらの記事で紹介しています。
関連記事：保留メモは溜めない、変わりやすいことは別のファイルに
決めたあとは整理を頼む
話し合いでたくさんのことを決めると、CLAUDE.md には次々とルールが書き足されていきます。計画なしに増築を重ねた建物のようなもの。
増築を重ねた建物がぐらつき、使いにくくなるように、CLAUDE.md も、気づけば不安定になったり、効率が悪くなったりしています。だから私は、話し合いのあとに整理を頼むことにしています。
定期的に声をかける
もう1つの習慣は、定期的な声かけです。肥大化していないか、大丈夫かと、部長に尋ねるようにしています。
作業の区切りと終わりに投げている問いかけは、こちらの記事で紹介しています。
