同じ指示は、Claude Codeのどの層に書くべきか？CLAUDE.md・Skill・サブエージェント・フックを実測で比較する
この記事で分かること
Claude Codeにおいて、同じ指示をCLAUDE.md・Skill・サブエージェント・フックのどの層に書くべきかを実測比較している。各保存先の役割と、指示の影響範囲や実行タイミングの違いが具体的な測定結果として示されている。設定ファイルの設計時に、どの層に何を書くべきかの選び分け基準が得られる。
詳細要約
Claude Codeで同じ指示を繰り返し書かずに済む設定層は、優先度と適用範囲が異なる。最も使えるのは「CLAUDE.md」で、プロジェクト全体のルールやコーディング規約を常時適用できる。次に実用的なのは「フック」で、特定のファイル変更時やコマンド実行前に自動で指示を差し込める。Skillは再利用可能な指示セットとして、サブエージェントは役割分担として使い分けるが、実測ではCLAUDE.mdとフックの併用が指示の重複削減に最も効果的だった。