CLAUDE.mdの肥大化を3層構造で83%軽くした — 実測と試行錯誤の記録

• URL: https://zenn.dev/pepabo/articles/claude-code-rules-skills-split
• 日付: 2026-04-20
• トピック: programming, ai-llm
• 出典Tier: Tier 3（ペパボ社員Zennブログ・実測データ付き）

要約

2000行近くに肥大化したCLAUDE.mdを2ヶ月かけてCLAUDE.md/rules/.md/skills/.mdの3層構造に整理し、起動時コンテキスト消費を約83%削減。24スキル→16スキルに統廃合、@importを12→3に削減、SuperClaude Frameworkの既知原則集を削除。

主要な主張

• 3層構造: ①CLAUDE.md（エントリーポイント・最重要ルールのみ150行）、②~/.claude/rules/.md（恒常ルール・ドメイン別15ファイル）、③skills/.md（呼び出し時のみ読み込むワークフロー・40ファイル）
• 削減した内容: Claude既知の原則（SOLID等）の削除、冗長な例示（✅/❌）の削除、類似スキルの統合
• chezmoi管理: rules/をchezmoi管理下に移行することでマルチマシン間の同期問題を解消
• 教訓: SuperClaudeのモジュールを全部有効にするだけで重くなる。スキルは使われなくても読み込まれる