CLAUDE.md ファイルエンハンサー

このスキルは Claude Code プロジェクト向けの包括的な CLAUDE.md ファイル生成とエンハンスメント機能を提供します。既存ファイルを分析し、ベストプラクティスに対して検証し、プロジェクトタイプ、テックスタック、チームサイズに合わせてカスタマイズされたガイドラインを生成します。

機能

🆕 インタラクティブ初期化: リポジトリを探索し、プロジェクトタイプとテックスタックを検出し、確認を取ってからカスタマイズされた CLAUDE.md ファイルを作成するインテリジェントなワークフロー
✨ 100% ネイティブフォーマット準拠: 生成されるすべてのファイルは Claude Code の公式フォーマットに準拠しており、プロジェクト構造図、セットアップ手順、アーキテクチャセクション、ファイル構造の説明を含みます(/update-claude-md スラッシュコマンドと同様)
既存ファイルの分析: 現在の CLAUDE.md ファイルをスキャンして、構造、完全性、品質を評価
ベストプラクティスの検証: Anthropic ガイドライン(ファイル長、必須セクション、フォーマット標準)に対して確認
新規ファイル生成: 新しいプロジェクト用に CLAUDE.md ファイルを一から完全に作成
既存ファイルのエンハンスメント: 不足しているセクションを追加し、構造を改善し、最新のベストプラクティスに更新
モジュールアーキテクチャ: サブディレクトリ(backend/、frontend/、docs/)のコンテキスト固有の CLAUDE.md ファイルをサポート
テックスタックカスタマイズ: 特定のテクノロジー(TypeScript、Python、Go、React、Vue など)に合わせてガイドラインをカスタマイズ
チームサイズへの適応: チームサイズ(個人、小規模<10、大規模10+)に基づいて複雑さを調整
テンプレート選択: プロジェクトの複雑さと開発段階に基づいて適切なテンプレートを選択

入力要件

分析およびエンハンスメント用

既存の CLAUDE.md ファイル内容またはファイルパスを指定します:

{
  "mode": "enhance",
  "file_path": "CLAUDE.md",
  "content": "[既存の CLAUDE.md コンテンツ]",
  "project_context": {
    "type": "web_app",
    "tech_stack": ["typescript", "react", "node", "postgresql"],
    "team_size": "small",
    "phase": "mvp"
  }
}

新規ファイル生成用

プロジェクトコンテキストを指定します:

{
  "mode": "create",
  "project_context": {
    "type": "api",
    "tech_stack": ["python", "fastapi", "postgresql", "docker"],
    "team_size": "medium",
    "phase": "production",
    "workflows": ["tdd", "cicd", "documentation_first"]
  },
  "modular": true,
  "subdirectories": ["backend", "database", "docs"]
}

コンテキストパラメータ

type: プロジェクトタイプ(web_app、api、fullstack、cli、library、mobile、desktop)
tech_stack: テクノロジーの配列(例: ["typescript", "react", "node"])
team_size: solo、small(<10)、medium(10-50)、large(50+)
phase: 開発段階(prototype、mvp、production、enterprise)
workflows: 主要ワークフロー(tdd、cicd、documentation_first、agile など)

出力フォーマット

分析レポート

{
  "analysis": {
    "file_size": 450,
    "line_count": 320,
    "sections_found": [
      "Quick Navigation",
      "Core Principles",
      "Tech Stack",
      "Workflow Instructions"
    ],
    "missing_sections": [
      "Testing Requirements",
      "Error Handling Patterns"
    ],
    "issues": [
      {
        "type": "length_warning",
        "severity": "medium",
        "message": "推奨される 300 行を超えています(320 行)"
      },
      {
        "type": "missing_section",
        "severity": "low",
        "message": "'Testing Requirements' セクションの追加を検討してください"
      }
    ],
    "quality_score": 75,
    "recommendations": [
      "モジュールファイルに分割(backend/CLAUDE.md、frontend/CLAUDE.md)",
      "テスト要件セクションを追加",
      "ルートファイルを 150 行未満に削減"
    ]
  }
}

生成されたコンテンツ

完全な CLAUDE.md ファイルコンテンツまたは追加する特定のセクション:

# CLAUDE.md

このファイルは、このプロジェクトで Claude Code を使用する際のガイダンスを提供します。

## クイックナビゲーション

- [バックエンドガイドライン](backend/CLAUDE.md)
- [フロントエンドガイドライン](frontend/CLAUDE.md)
- [データベース操作](database/CLAUDE.md)
- [CI/CD ワークフロー](.github/CLAUDE.md)

## コア原則

1. **テスト駆動開発**: 実装前にテストを記述する
2. **型安全を最優先**: TypeScript strict モードを常に使用する
3. **コンポーネント合成**: 小さく再利用可能なコンポーネントを優先する
4. **エラーハンドリング**: 常に適切なログ記録を含めてエラーをハンドルする
5. **ドキュメント更新**: ドキュメントとコード変更を常に同期させる

[... テンプレートに基づいた追加セクション ...]

使用方法

例 1: 新規プロジェクト向け CLAUDE.md を初期化(インタラクティブ)

こんにちは Claude—「claude-md-enhancer」スキルを追加しました。このプロジェクトの CLAUDE.md ファイルがまだありません。作成を手伝ってもらえますか?

処理内容:

Claude が CLAUDE.md が存在するかをチェック(存在しない)
Claude が組み込みコマンドを使用してリポジトリを探索
Claude が分析: プロジェクトタイプ、テックスタック、チームサイズ、ワークフロー
Claude が発見内容を表示し、確認を求める
ユーザーが設定を確認
Claude がカスタマイズされた CLAUDE.md ファイルを作成
Claude がベストプラクティスでエンハンスメント

インタラクティブフロー:

✋ ユーザーが作成前に確認が必要
🔍 発見内容の完全な可視化
⚙️ 処理前に設定を調整するオプション

例 2: 既存の CLAUDE.md を分析

こんにちは Claude—「claude-md-enhancer」スキルを追加しました。現在の CLAUDE.md ファイルを分析して、何が不足しているか、または改善できるかを教えてもらえますか?

例 3: TypeScript プロジェクト用に新規 CLAUDE.md を生成

こんにちは Claude—「claude-md-enhancer」スキルを追加しました。TypeScript React プロジェクト向けの CLAUDE.md ファイルを作成してもらえますか? 5 人の開発者のチームで、PostgreSQL と Docker を使用し、TDD に従っています。

例 4: 既存ファイルをエンハンス

こんにちは Claude—「claude-md-enhancer」スキルを追加しました。既存の CLAUDE.md をエンハンスして、不足しているセクションを追加し、構造を改善してもらえますか? 現在のファイルはこちらです: [コンテンツを貼付]

例 5: モジュールアーキテクチャを生成

こんにちは Claude—「claude-md-enhancer」スキルを追加しました。フルスタックプロジェクト向けにモジュール化した CLAUDE.md セットアップを作成してもらえますか? バックエンド(Python/FastAPI)、フロントエンド(React)、データベース(PostgreSQL)の個別ファイルが必要です。

初期化ワークフロー(新規プロジェクト)

プロジェクトに CLAUDE.md が存在しない場合、このスキルはインテリジェントな初期化ワークフローを提供します。

ワークフローステップ

ステップ 1: 検出

スキルがプロジェクトルートに CLAUDE.md が存在するかをチェック
見つからない場合、初期化ワークフローが開始

ステップ 2: リポジトリ探索

Claude Code の組み込み explore コマンドを使用
プロジェクト構造、ファイル、ディレクトリを分析
設定ファイルを確認(package.json、requirements.txt、go.mod など)
既存ドキュメントを確認

ステップ 3: インテリジェント分析

プロジェクトタイプ検出: web_app、api、fullstack、cli、library、mobile、desktop
テックスタック検出: TypeScript、Python、React、FastAPI、PostgreSQL、Docker など
チームサイズ推定: プロジェクトの複雑さに基づいて(個人、小規模、中規模、大規模)
開発段階: prototype、mvp、production、enterprise
ワークフロー検出: TDD、CI/CD、ドキュメント優先、アジャイル
構造推奨: 単一ファイルまたはモジュールアーキテクチャ

ステップ 4: ユーザー確認 ✋

すべての発見内容を明確なフォーマットで表示
推奨される CLAUDE.md 構造を表示
ユーザーに設定の確認または調整を要求
ユーザーが明示的に承認してから処理を進める

ステップ 5: ファイル作成

確認された設定に基づいてカスタマイズされた CLAUDE.md を生成
推奨されている場合はモジュールファイルを作成(backend/、frontend/ など)
テクノロジー固有のベストプラクティスを適用

ステップ 6: エンハンスメント

生成されたコンテンツを検証
品質改善を追加
完全性を確保

ステップ 7: サマリー

作成されたファイルを表示
次のステップを提供
すぐに使用可能な状態に

インタラクティブ例

ユーザー: 「このプロジェクトに CLAUDE.md が必要です」

Claude: 「まず、プロジェクトを理解するためにリポジトリを探索します。
        [組み込みコマンドを使用して探索]

        探索に基づいて、以下の内容を検出しました:

        プロジェクトタイプ: フルスタックアプリケーション
        テックスタック: TypeScript、React、Node.js、PostgreSQL、Docker
        チームサイズ: 小規模(2-9 名)
        開発段階: MVP
        ワークフロー: TDD、CI/CD

        推奨構造: モジュールアーキテクチャ
        - Root CLAUDE.md (ナビゲーションハブ)
        - backend/CLAUDE.md (API ガイドライン)
        - frontend/CLAUDE.md (React ガイドライン)

        これらのファイルを作成してもよいでしょうか?」

ユーザー: 「はい、お願いします」

Claude: 「カスタマイズされた CLAUDE.md ファイルを作成しています...
        ✅ CLAUDE.md を作成(100 行)
        ✅ backend/CLAUDE.md を作成(150 行)
        ✅ frontend/CLAUDE.md を作成(175 行)

        プロジェクトが AI 支援開発の準備ができました!」

スクリプト

workflow.py

新規プロジェクト向けのインタラクティブ初期化ワークフローを管理します。

主要な関数:

check_claude_md_exists() - CLAUDE.md が存在するかを検出
generate_exploration_prompt() - Claude がリポジトリを探索するようガイド
analyze_discoveries() - 探索結果を分析
generate_confirmation_prompt() - ユーザー確認プロンプトを作成
get_workflow_steps() - 完全なワークフローステップを取得

analyzer.py

既存の CLAUDE.md ファイルを分析して、構造、セクション、品質の問題を特定します。

主要な関数:

analyze_file() - CLAUDE.md 構造を解析して分析
detect_sections() - 存在するセクションと不足しているセクションを特定
calculate_quality_score() - ファイル品質をスコア化(0-100)
generate_recommendations() - 実行可能な改善提案を生成

validator.py

CLAUDE.md ファイルをベストプラクティスと Anthropic ガイドラインに対して検証します。

主要な関数:

validate_length() - ファイル長をチェック(>300 行の場合は警告)
validate_structure() - 必須セクションが存在することを確認
validate_formatting() - markdown フォーマット品質をチェック
validate_completeness() - 重要な情報が含まれていることを確認

generator.py

テンプレートに基づいて新しい CLAUDE.md コンテンツまたは不足しているセクションを生成します。

主要な関数:

generate_root_file() - メイン CLAUDE.md オーケストレーターを作成
generate_context_file() - コンテキスト固有のファイルを作成(backend、frontend など)
generate_section() - 個別のセクションを生成(テックスタック、ワークフローなど)
merge_with_existing() - 新しいセクションを既存ファイルに追加

template_selector.py

プロジェクトコンテキストに基づいて適切なテンプレートを選択します。

主要な関数:

select_template() - プロジェクトタイプとチームサイズに基づいてテンプレートを選択
customize_template() - テックスタックに合わせてテンプレートを適応
determine_complexity() - 適切な詳細度を計算
recommend_modular_structure() - サブディレクトリの組織を提案

ベストプラクティス

クリティカル検証ルール ⚠️

「完成を宣言する前に、常に出力を公式ネイティブ例に対して検証してください。」

CLAUDE.md 生成を確定する前に:

出力を /update-claude-md スラッシュコマンドのフォーマットと比較
Claude Code の公式ドキュメントで必須セクションを確認
すべてのネイティブフォーマットセクションが存在することを確認(Overview、Project Structure、File Structure、Setup & Installation、Architecture など)
examples/ フォルダのリファレンス例に対して相互確認

新規プロジェクトの場合

最小テンプレート(50-100 行)から始めて、必要に応じて成長させる
主要なコンポーネントが 3 つ以上のプロジェクトではモジュールアーキテクチャを使用
テックスタックリファレンスをすぐに含める
チームが 5 人を超える前にワークフロー手順を追加

エンハンスメント用

変更前に分析 - 現在の構造を最初に理解
カスタムコンテンツを保持 - 置き換えるのではなく拡張するのみ
変更後に検証 - 改善が既存パターンを壊していないことを確認
Claude Code でテスト - ガイドラインが意図した通りに機能することを確認

一般的なガイドライン

ルートファイルを簡潔に - 最大 150 行、ナビゲーションハブとして使用
コンテキスト固有のファイルを使用 - backend/CLAUDE.md、frontend/CLAUDE.md など
重複を避ける - 各ガイドラインは 1 回のみ表示
外部ドキュメントへリンク - 公式ドキュメントをコピーしない
定期的に更新 - 四半期ごと、またはスタック変更時にガイドラインを見直す

制限事項

技術的な制約

正確なテンプレート選択のための有効なプロジェクトコンテキストが必要
テックスタック検出はキーワードベース、手動で調整が必要な場合がある
モジュールファイル生成は標準ディレクトリ構造を想定

スコープの境界

CLAUDE.md 構造に焦点、プロジェクト固有のビジネスロジックではない
ベストプラクティス推奨は一般的、業界固有のカスタマイズが必要な場合がある
検証はガイドラインベース、承認なしの自動修正はない

使用しない場合

Claude 以外の AI ツール向け(これは Claude Code 固有)
Claude Code または類似の AI アシスタントを使用していないプロジェクト
高度に専門化されたドメインガイドラインが必要な場合(法律、医療コンプライアンス)

テンプレートカテゴリー

サイズ別

最小(50 行) - 個人開発者、プロトタイプ、ハッカソン
コア(100-150 行) - 小規模チーム、MVP、標準プロジェクト
詳細(200-300 行) - 大規模チーム、本番システム、エンタープライズ

プロジェクトタイプ別

Web アプリ - フロントエンド中心(React、Vue、Angular)
API - バックエンドサービス(REST、GraphQL、マイクロサービス)
フルスタック - 統合フロントエンド + バックエンド
CLI - コマンドラインツールとユーティリティ
ライブラリ - 再利用可能なパッケージとフレームワーク
モバイル - React Native、Flutter、ネイティブ iOS/Android

テックスタック別

TypeScript/Node - モダン JavaScript エコシステム
Python - Django、FastAPI、Flask
Go - Gin、Echo、ネイティブサービス
Java/Kotlin - Spring Boot、エンタープライズ Java
Ruby - Rails、Sinatra

品質メトリクス

ファイル品質スコア(0-100)

以下に基づいて計算:

長さの適切性(25 ポイント) - 短すぎたり長すぎたりしない
セクション完全性(25 ポイント) - 必須セクションが存在
フォーマット品質(20 ポイント) - 適切な markdown 構造
コンテンツの特異性(15 ポイント) - プロジェクトに合わせ、汎用的ではない
モジュール編成(15 ポイント) - 適切な場合はサブディレクトリファイルを使用

推奨事項の優先度

クリティカル - 必須セクションの欠落、ファイルが長すぎる(>400 行)
高 - 重要なセクションの欠落、フォーマットの問題
中 - オプションセクションの追加可能、軽微な改善
低 - あると便利な拡張、スタイルの提案

高度な機能

モジュールアーキテクチャサポート

コンテキスト固有のファイルを自動生成:

project-root/
├── CLAUDE.md                 # ルートオーケストレーター(100-150 行)
├── backend/
│   └── CLAUDE.md            # バックエンド固有(150-200 行)
├── frontend/
│   └── CLAUDE.md            # フロントエンド固有(150-200 行)
├── database/
│   └── CLAUDE.md            # データベース操作(100-150 行)
└── .github/
    └── CLAUDE.md            # CI/CD ワークフロー(100-150 行)

テックスタック検出

以下から自動検出:

package.json(Node.js/TypeScript)
requirements.txt または pyproject.toml(Python)
go.mod(Go)
Cargo.toml(Rust)
pom.xml または build.gradle(Java)

チームサイズへの適応

詳細度を調整:

個人: 最小限のガイドライン、効率重視
小規模(<10): コアガイドライン、ワークフロー基本
中規模(10-50): 詳細なガイドライン、チーム協調
大規模(50+): 包括的なガイドライン、プロセス実施

リファレンス

Anthropic Claude Code ドキュメント: https://docs.claude.com/en/docs/claude-code
CLAUDE.md ベストプラクティス: コミュニティパターンと Anthropic ガイダンスに基づく
CLAUDE.md の例: examples/ フォルダで、異なるプロジェクトタイプとチームサイズをカバーする 6 つのリファレンス実装を参照

バージョン

バージョン: 1.0.0 最終更新: 2025 年 11 月 互換性: Claude Code 2.0+、Claude Apps、Claude API

覚えておいてください: 目標は Claude をより効率的でコンテキスト認識できるようにすることであり、官僚制度を作ることではありません。シンプルに始めて、実際の使用状況に基づいて反復し、可能な場合は品質チェックを自動化してください。

ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ

SKILL.md 本文

CLAUDE.md ファイルエンハンサー

機能

入力要件

分析およびエンハンスメント用

新規ファイル生成用

コンテキストパラメータ

出力フォーマット

分析レポート

生成されたコンテンツ

使用方法

例 1: 新規プロジェクト向け CLAUDE.md を初期化(インタラクティブ)

例 2: 既存の CLAUDE.md を分析

例 3: TypeScript プロジェクト用に新規 CLAUDE.md を生成

例 4: 既存ファイルをエンハンス

例 5: モジュールアーキテクチャを生成

初期化ワークフロー(新規プロジェクト)

ワークフローステップ

インタラクティブ例

スクリプト

workflow.py

analyzer.py

validator.py

generator.py

template_selector.py

ベストプラクティス

クリティカル検証ルール ⚠️

新規プロジェクトの場合

エンハンスメント用

一般的なガイドライン

制限事項

技術的な制約

スコープの境界

使用しない場合

テンプレートカテゴリー

サイズ別

プロジェクトタイプ別

テックスタック別

品質メトリクス

ファイル品質スコア(0-100)

推奨事項の優先度

高度な機能

モジュールアーキテクチャサポート

テックスタック検出

チームサイズへの適応

リファレンス

バージョン

詳細情報