Claude CodeのCLAUDE.md肥大化問題を解決する「場面別目次方式」と3層構造
この記事で分かること
Claude CodeのCLAUDE.mdが肥大化する問題を、「場面別目次方式」と「3層構造」で解決する方法を解説する。設定ファイルを場面ごとに分割し、階層化することで管理負荷を下げ、必要な指示を素早く参照できる。具体的には、目次の書き方や各層の役割分担（共通設定・タスク別設定・プロジェクト固有設定）が実装のポイントとなる。
詳細要約
Claude Codeの設定ファイルが長大化して管理不能になる問題は、ファイル内に「場面別目次」を設け、指示を「共通設定」「場面別ルール」「タスク別手順」の3層に分割することで解決できる。実際の運用では、まずファイル冒頭に「# 場面別目次」として各場面のキーワードと該当セクションへのリンクを列挙し、その後に3層構造で詳細を記述する。これにより、AIが必要なルールだけを効率的に参照でき、ファイル全体の可読性と保守性が大幅に向上する。