AIの鬼
#新モデル Zenn AI

「CLAUDE.md は短い方が良い」を 1,510 回試して確かめた

「CLAUDE.md は短い方が良い」を 1,510 回試して確かめた(内容を表す図ではないイメージ画像)
イメージ

CLAUDE.mdは短く保つべき、という通説があります。X上では「200行以内が理想」といった言われ方もあり、長くなったら.claude/rules/に分割せよとも言われています。しかし実際に228行と1,040行のCLAUDE.mdで同じルールの守られ方を比較してみたところ、予想に反する結果が出ました。合計1,510回の試行を重ねたところ、CLAUDE.mdを短く保つことと、その中のルールが実際に従われるかどうかには、統計的に有意な相関がないことが分かったのです。ルールが1,040行の中ほどに埋まっていても、228行の先頭に置いたときと同じように守られていました。

この通説は、かつてのモデルのコンテキスト長と追従性を前提にした経験則だったと推測できます。現代のモデルはこの規模の文書なら普通に読み込んでいます。では全てをCLAUDE.mdに書けばいいのかというと、そうもいきません。人間が1,040行のMarkdownを保守するのがしんどく、変更の差分がレビューしづらく、チーム内での衝突も増えます。.claude/rules/に分割する意義は、モデルの精度にはなく、人間の保守性と運用効率にあるのです。測定結果では、一枚岩でも分割でもモデル側は同じ内容を受け取り、差はファイルパスのヘッダ分だけ(約3%のトークン増加)でした。

つまり分割を判断する基準は、精度ではなく別の三つです。条件ロードを使いたいなら分割は必須ですし、チーム開発で差分を閉じたいなら分割が効果的です。人間が読みやすい目次が欲しければ、ファイル名がそれになります。一方、小規模なプロジェクトで一人で運用しているなら、200行を超えたからといって焦って分割する理由はないのです。「短く保て」という焦燥感より、実務に合わせた構成を選ぶことが、ストレスなくルールを保守する最短経路です。

※ 上記は配信元記事をもとにAIの鬼編集部が要約・再構成したものです。正確な内容は出典元をご確認ください。

御社でもAIを使ってみませんか
まずはここから 御社でもAIを使ってみませんか? 御社の実際の業務を題材に、AIで何ができるかを一緒に考えます。 「ChatGPTの使い方」を教えるだけの研修ではありません。 AI研修・AI活用相談 →