Claude 5時代のCLAUDE.md断捨離：80%削減で性能を最大化する最適化術

エンジニアの皆さんは、日々の開発で「CLAUDE.md」が肥大化し、もはや何が書かれているのか把握できないスパゲッティ状態に陥った経験はないだろうか。かつては、LLMの挙動を制御するために、禁止事項や詳細な手順を事細かに記述することが「プロンプトエンジニアリングの正解」とされていた。しかし、2026年7月24日にAnthropicが発表した知見は、その常識を根底から覆した。Claude Opus 5やFable 5といった次世代モデルにおいて、システムプロンプトを80%以上削減しても性能低下が測定されなかったという事実は、我々がこれまで「過剰な制約」でモデルの判断力を縛り付けていたことを示唆している。

私自身、数ヶ月前に書いた「テストは必ず先に書け」という指示と、最近追加した「小さな修正ならテストを省略してよい」という指示が、CLAUDE.mdの中でデッドロックを引き起こしていることに気づいた。モデルは文脈から意図を汲み取れる能力を持っているにもかかわらず、我々が与えた矛盾する指示の調停に貴重な推論リソースを浪費させているのだ。これは、コードベースにおける技術的負債と全く同じ構造である。AnthropicのThariq Shihipar氏が指摘するように、制約の多くは「最悪のケース」を回避するために導入されたものだが、今のモデルは周囲の文脈から自律的に判断できる。今こそ、CLAUDE.mdを「命令書」から「最小限の判断基準」へと昇華させるべきタイミングである。

具体的には、以下の6つの常識転換が求められている。まず、ルールを列挙するのではなく、周囲のコードの密度や命名規則に合わせるという「判断基準」への書き換えが必要だ。次に、ツールの使い方は例示ではなく、インタフェース設計で伝える。さらに、手順書はCLAUDE.mdから切り出し、スキル（.claude/skills/）へ移管する。これらを実行することで、モデルは「指示の解釈」ではなく「コードの理解」に集中できるようになる。これは、単なるプロンプトの軽量化ではない。モデルの推論能力を最大限に引き出すための、エンジニアリングの再定義なのである。

CLAUDE.mdを最適化するための具体的な手順は、単なる削除作業ではない。まずは「棚卸し」から始める必要がある。wcコマンドやgrepを用いて、現在どれだけの行数が存在し、どこに「絶対」「必ず」「禁止」といった強い語が含まれているかを可視化する。公式の目安は1ファイル200行未満だ。これを超える場合、モデルの追従性は確実に低下する。棚卸しした内容は、A（目的）、B（環境の注意点）、C（禁止ルール）、D（手順）、E（覚え書き）の5つに分類し、それぞれ適切な場所へ再配置する。

特に重要なのは、不可逆な操作（ファイル削除や本番反映など）のガード以外、禁止ルールを「判断基準」に書き換えることだ。例えば「コメントを書くな」という指示は、「周囲のコードのコメント密度や命名、イディオムに合わせる」という柔軟な指示に変えるべきである。これにより、モデルは文脈に応じた適切な判断を下せるようになる。また、手順やチェックリストはスキル（SKILL.md）へ移し、CLAUDE.mdにはその参照だけを残す。これにより、コンテキストウィンドウを節約し、モデルが本当に必要な情報にアクセスしやすくなる。

以下に、見直しのための分類基準を整理した。

最後に、これらの手順を自動化するスキル「claudemd-tune」を導入することを強く推奨する。このスキルは、棚卸しレポートを自動生成し、矛盾や重複を洗い出した上で、提案書を作成するワークフローを内包している。手動でgrepを叩く時代は終わった。我々エンジニアが明日から取るべき対策は、CLAUDE.mdを「聖典」として崇めるのをやめ、常に変化し続けるコードベースに合わせて、動的に最適化し続ける「運用対象」へと変えることだ。あなたのCLAUDE.mdは、モデルを助けているのか、それとも足かせになっているのか。今すぐその目で確かめてほしい。