「CLAUDE.md が200行を超えると Claude Code が指示を無視し始める」——そういう話を note.com で読んだ。ソースは単一記事で、数値の根拠は書かれていなかった。

信じるか無視するか迷ったが、どちらも腑に落ちない。ならば自分のリポジトリで確かめる方が早い。

結論

行数そのものが問題ではなかった。効いているのは「構造・密度・位置」の3軸だった。

ただし「200行で必ず壊れる」という断定は自分の観察では確認できなかった。現時点の masatoman.net CLAUDE.md は114行で動いており、問題のある指示すり抜けは行数でなく書き方に起因していた。

前提（自分の環境）

「200行実験」と書いたが、正確には「現行ファイルで何が起きているかを観察し、行数と指示効果の関係を推論した」が正しい。数値化した遵守率は計測していない。

通りやすかった指示:

通りにくかった指示:

sns-automation の CLAUDE.md（58行）は逆に問題が少ない。ほぼコマンドと環境変数の列挙であり、Claude が迷う余地がない書き方になっている。

行数を減らせば解決すると思っていたが、試しに後半のルールをいくつか前に移動させると通りやすくなった。行数に変化はない。

位置（ファイル内のどこにあるか）と形式（リスト vs. 説明文）の方が行数より影響が大きい。

Claude Code が CLAUDE.md を読むとき、ファイル全体を均等に重み付けしているわけではないと推測できる。冒頭に近い・箇条書きになっている・明示的な命令形で書かれているルールほど、セッション中に参照されやすい。

「200行で壊れる」説がなぜ出てきたかを推測すると:

① 密度（1ルールあたりの行数）

② 構造（リスト vs. 説明文の比率）

③ 位置（ファイル内の優先度配置）

この3軸が整っていれば、100行でも200行でも「指示が消える」現象は減らせると考えている。