Claude Code起動時に読むべき設定はCLAUDE.mdとrules

Claude Codeは起動時にCLAUDE.mdとrulesを全文読みむので、プロジェクトに依存せず使う情報はここに置く。

rulesに分割するメリットとしては、パス限定ルールを記述できる点と、ディレクトリ構造を利用してマークダウンよりも明示的に情報を階層化できる点かと思う。

~/.claude/rules/
├── frontend/
│   ├── react.md
│   └── styles.md
├── backend/
│   ├── api.md
│   └── database.md
└── general.md

CLAUDE.mdやrulesは全文を読む特性上、コンテキストを圧迫しやすい。コンテキスト消費をうまくおさえるには、プロンプトの詳細を必要になるまで伏せられるskills, slash commands, subagentsの活用を検討したほうがいい。

なお、パス限定ルールは、条件に一致するパスを操作するまでコンテキストを消費しないらしいが（Oikonさんによる検証）、「ユーザー設定」レベルで効果的に扱うのは難易度が高めだと思う。たとえば、tsファイル限定でフロントエンド用のルールをユーザーレベルで読み込ませると、CLIを作っているプロジェクトにフロントエンドのコンテキストが混入する。まずはskillsで様子見してもよさそうだ。もしファイルパスの一致で確実に読み込ませたい内容であればパス限定ルールが活躍するだろう。

ユーザーが判断したタイミングで読み込ませたい内容はslash commands

実験した限り、slash commandsを削除しても/contextに表示されるコンテキストの消費量は変わらなかった。つまり、slash commandsは呼び出すまでコンテキストを消費しない。

コンテキスト消費の特徴と、ユーザーが明示的に実行する簡潔な指示テンプレートという目的をふまえると、ユーザーが判断したタイミングで読み込ませたい内容はslash commandsに書くべき言える。

たとえばgit commitする手順やルールは /git:commit のようにslashコマンドを呼ぶまで概要すら知らなくていいはずだ。

• 変更をすべてコミットせずに、意味のある範囲でできるだけ小さくコミットしてね
• commit logにはwhyを残してね

といった情報は実際にコミットを始めるまで知らなくていい。

逆に「ユーザーの利用言語を問わず日本語で返事すること」みたいな全体に影響するルールはCLAUDE.mdに書いておくべきだ。

Claude Codeが自動判断して読み込む内容はskillsかsubagents

slash commandsはコンテキスト消費を限界まで遅延できる一方で、Claude Codeが自動呼び出ししない欠点がある。

それを補うのがskillsやsubagentsだ。 Claude Codeはskillsやsubagentsの全体ではなくdescription（概要）だけをあらかじめ読む。概要から必要性を判断して全体を読む流れをとることで、コンテキスト消費をぎりぎりまで最小にしつつ、複雑な機能を発揮できる。

じゃあskillsとsubagentsはどう使いわけるのとなるが、ここでまたコンテキストの使い方に注目したい。

---
name: git-commit
description: Stage meaningful diffs and create Conventional Commits with WHY-focused messages. Use when agent needs to commit code changes.
---

Execute `/git:commit` slash command`

重複の排除

同じ内容が複数の場所に書かれていたら、一箇所にまとめて参照する形にする。

• slash commandとskillで重複 → skillからslash commandを呼び出す形に統一
• 複数のsubagentsで共通のルール → 常に必要ならCLAUDE.mdへ、特定条件で必要ならskillsとして切り出す

読み込みタイミングの最適化

CLAUDE.mdやrulesに書いてあるが、常に必要ではない内容は移動を検討する。

• 特定タスクでしか使わない詳細な手順 → slash commandsへ
• 自動判断で発動させたい専門知識 → skillsへ
• 独立したコンテキストで処理させたいタスク → subagentsへ