CLAUDE.md レビュー は何をしますか？
CLAUDE.md を監査し、実際に出力品質を損なう障害モードを特定します。
前提: CLAUDE.md はあらゆるセッションでコンテキストに読み込まれるため、すべての行が常に rent（価値）を支払うか、トークンを消費するかのどちらかです。「モデルが指示に従わない」問題のほとんどは、指示そのものの問題です。
手順
- 対象ファイル（デフォルト
./CLAUDE.md）を読み込みます。さらに~/.claude/CLAUDE.mdや、プロジェクト内に存在する任意のネストされた**/CLAUDE.mdも確認します（最も近いものが優先されます）。 - 以下の各次元についてスコアを付け、問題のある具体的な行を引用します。
- 下部のレポート形式に従って出力します。「より具体的にしてください」ではなく、具体的な書き換え案を提案します。
チェック項目
具体性 — 最も効果の高い次元です。
- 検証不可能な指示をフラグ付けします：「きれいなコードを書く」、「ベストプラクティスに従う」、「注意する」、「適切な命名を使う」。
- すべてのルールは diff を読むだけでチェックできる必要があります。「40行を超える関数をリファクタリングする」はチェック可能ですが、「関数を短く保つ」はチェックできません。
名前付きアンカー。
- 「config」、「API層」、「通常のパターン」などを参照するルールは、毎回セッションごとに再発見を強制します。実際のパスに置き換えてください：
src/config/env.ts、src/api/client.ts。 - 言及されているすべてのパス、コマンド、ファイル名がまだ存在することを確認します。存在しないものは報告してください — 削除されたファイルを指す
CLAUDE.mdは積極的に誤った情報を与えます。
陳腐化。
- リポジトリに一致しなくなったバージョン番号、モデル名、ツールコマンド。
- 削除されたフレームワーク、スクリプト、ディレクトリに対する指示。
package.json、Makefile、pyproject.tomlなどとビルド/テスト/リンクコマンドのクロスチェック — 間違ったテストコマンドは、何もないよりはるかに悪いです。
ブロート（肥大化）とレント（負債）。
- コード自体から導出可能なもの（ファイルツリーの一覧、依存関係リスト、関数の説明の再掲など）。Claude はリポジトリを読めます。
- 特定のタスクにのみ適用される長い手順：それらはスキルに属します（スキルは使用時にのみ読み込まれます）。毎回のターンでコンテキストに置いておく必要はありません。
- すべてのソフトウェアに当てはまる一般的なアドバイス — このプロジェクトについて何も教えてくれません。
矛盾。
- 互いに矛盾するルール、またはコードの実際の動作と矛盾するルール。両方をフラグ付けし、どちらが優先されるかを尋ねます。
- 優先順位の驚き：ネストされた
CLAUDE.mdや~/.claude/CLAUDE.mdが作者の意図を上書きする場合。
不足しているもの。 指摘する価値のあるギャップ（存在しない場合）：
- テスト、ビルド、リンクの実行方法 — 変更の自己検証に必要な3つの要素。
- 明らかでないプロジェクトの制約（触れてはいけないディレクトリ、生成されたファイル、必要なマイグレーション手順）。
- コードをざっと読んだだけでは見えない、本当に驚くような規約。
出力形式
## CLAUDE.md レビュー — <パス> (<行数> 行)
**判定:** <一文>
### 阻害要因
- L<n>: <引用行> → <具体的な書き換え案>
### 修正推奨
- L<n>: <引用行> → <具体的な書き換え案>
### 削除（毎セッションでコンテキストを消費し、何も生み出さない）
- L<n>–<m>: <内容と理由>
### 不足
- <ギャップ> → <追加すべき行の提案>
**編集後の推定サイズ:** <N> 行（<M> 行から）
ルール
- 実際の行番号と実際のテキストを引用します。発見事項を埋めるために発明しないでください。
- セクションに発見事項がない場合は「なし。」と書きます — クリーンなファイルは有効な結果です。
- 書き換えよりも削除を優先します。最高の
CLAUDE.mdは、人が実際に読めるほど短いものです。 - 依頼がない限りファイルを編集しないでください。まず報告します。