---
name: claudemd-optimizer
description: |
  Optimize CLAUDE.md files based on Claude 4 best practices from Anthropic's official documentation. Use when reviewing or improving CLAUDE.md, creating new project instructions, analyzing prompt effectiveness, or applying Claude 4 model-specific optimizations. Triggers: "CLAUDE.mdを最適化", "プロジェクト指示を改善", "optimize CLAUDE.md", "review system prompt".
alwaysApply: false
---

# CLAUDE.md Optimizer

Claude 4公式ベストプラクティスに基づき、CLAUDE.mdファイルを最適化するスキル。

## Execution Flow

### 1. Read target CLAUDE.md
既存の内容を確認。なければ新規作成を提案。

### 2. Analyze against Claude 4 principles
詳細は `claude4-principles.md` を参照。主要評価軸:
- **明示性**: 指示が具体的か。修飾語（"as many as possible"）を使っているか
- **コンテキスト**: なぜそのルールが必要か説明しているか
- **構造**: XMLタグで整理されているか（必要な場合）
- **過剰防止**: 過度なエンジニアリングを抑制する指示があるか

### 3. Apply optimizations
チェックリストは `checklist.md` を参照。主要な最適化:
- 曖昧な指示 → 明示的・具体的な指示に変換
- ルールのみ → 理由（なぜ）を追加
- 過度な冗長性 → 簡潔かつ必要十分に
- 不足している重要指示を追加（過剰エンジニアリング防止など）

### 4. Report improvements
変更点とClaude 4原則への対応を説明。

## Output Format
課題 → 改善案 → 変更点（テーブル形式）の順で報告。

## Reference Files
- `claude4-principles.md`: Claude 4モデル固有のベストプラクティス詳細
- `checklist.md`: CLAUDE.md最適化チェックリスト