Claudemd Optimizer

CLAUDE.md の配置場所（5箇所）

CLAUDE.mdは以下の場所に配置でき、すべてマージして適用される：

矛盾チェック: 複数のCLAUDE.mdが存在する場合、内容が矛盾していないか確認する。矛盾がある場合はユーザーに報告して解消方法を提案する。

Step 2: 注意コスト分析

CLAUDE.mdの各セクション・各行を以下の 5カテゴリ に分類する：

KEEP（CLAUDE.mdに残す）

セッション開始直後から必要で、かつClaudeの行動を変える内容：

• Bashコマンド: Claudeが推測できないdev/build/test/lintコマンド
• デフォルトと異なるコードスタイル: プロジェクト固有のスタイルルール
• テスト指示: 推奨テストランナーとテスト方針
• リポジトリのエチケット: ブランチ命名規約、PR規約、コミット規約
• アーキテクチャ決定: プロジェクト固有の設計方針
• 環境の癖: 必須環境変数、特殊な設定
• 落とし穴: 一般的な落とし穴や明白でない動作
• Skills/subagentsの名前: 利用可能なスキルのディスカバリー用リスト
• 行動原則・パーソナリティ指定（3〜5行）
• プロジェクト固有の制約・禁止事項

RULES（.claude/rules/ に移動）

特定のファイルパターンでのみ適用すべき指示：

• コーディング規約・スタイルガイド → rules/coding-style.md
• テスト方針・テストの書き方 → rules/testing.md
• コミットメッセージ・PR規約 → rules/git.md
• インフラ・IaC関連 → rules/infra.md
• API・エンドポイント設計 → rules/api.md

SKILLS（.claude/skills/ に移動）

ドメイン知識や低頻度ワークフロー：

• 特定の技術ドメインの詳細知識
• 低頻度だが手順が複雑なワークフロー
• 外部ツール連携の手順書
• ユーザーが明示的に呼び出す作業手順

HOOKS（.claude/settings.json のhooksに設定）

毎回確実に実行すべき検証・フォーマットの指示：

• 「コミット前にlintを実行すること」→ PreToolUse hook（matcher: Bash）
• 「ビルドが通ることを確認すること」→ PostToolUse hook（matcher: Edit|Write）
• 「フォーマットを整えること」→ PostToolUse hook（matcher: Edit|Write）
• 「型チェックを実行すること」→ PostToolUse hook（matcher: Edit|Write）

REMOVE（削除）

以下は書かなくてよい：

• Claudeがコードを読むことで理解できるもの
• 標準言語規約（Claude既知のベストプラクティス）
• 詳細なAPIドキュメント（@docs/api.md リンクで代替）
• ファイルごとのコードベースの説明
• 頻繁に変わる情報
• 長い説明またはチュートリアル
• 「きれいなコードを書く」のような自明なプラクティス
• linterで自動強制可能なルール（Prettier/ESLintなど）
• 冗長な説明・同じ内容の繰り返し
• 過去のbugfix経緯（コード・gitログに残っている）
• 使い方の説明（README向けの内容）

Step 3: 移行プランの提示

分析結果をユーザーに提示する：

## CLAUDE.md 最適化プラン

### 現状
- 行数: XXX行（目標: 200行以下）
- 推定トークン数: 約XXXトークン

### 分析結果

| カテゴリ | 件数 | 内容（抜粋） |
|---|---|---|
| KEEP | X件 | Bashコマンド、アーキテクチャ決定、落とし穴 |
| RULES | X件 | コーディング規約→coding-style.md、テスト方針→testing.md |
| SKILLS | X件 | ドメイン知識→skills/domain.md |
| HOOKS | X件 | lint実行→PreToolUse、ビルドチェック→PostToolUse |
| REMOVE | X件 | 一般的ベストプラクティスX項目、冗長な説明X項目 |

### 最適化後の見込み
- CLAUDE.md: XXX行 → XX行（XX%削減）
- 作成される rules ファイル: X個
- 作成される skills ファイル: X個
- 追加される hooks: X個

### 作成ファイル一覧
- `.claude/rules/coding-style.md`（paths: src/**/*.ts）
- `.claude/rules/testing.md`（paths: **/*.test.*）
- `.claude/skills/<skill-name>/SKILL.md`
- `.claude/settings.json`（hooksを追加）

ユーザーに確認を取り、承認を得てから Step 4 に進む。

Step 4: 移行の実行

ユーザーの承認後、以下の順序で実行する：

4-1. rules ファイルの作成

.claude/rules/ ディレクトリを作成し、各rulesファイルを生成する。

rulesファイルのフォーマット（YAML リスト形式）：

---