legacy-to-ai-ready

レガシーコードをAI対応に

Claude Code の設定を生成して、レガシーコードベースをAI対応プロジェクトに変換します。

クイックスタート（5分でセットアップ）

ほとんどのプロジェクトでは、まず CLAUDE.md だけを用意します。

1. 分析：python scripts/analyze_codebase.py [path]
2. ビルドコマンド、コードスタイル、アーキテクチャの概要を記載した CLAUDE.md を作成
3. 完了 — Claude がプロジェクトの規約に沿ってコードを書けるようになります

必要になった場合にのみ、設定を拡張してください。

対話形式での情報収集

設定を生成する前に、次の質問をしてください。

プロジェクトの範囲：

• これはどのようなプロジェクトですか？（ウェブアプリ、API、CLI、ライブラリ）
• 主な言語とフレームワークは何ですか？
• チームの規模はどのくらいですか？（個人、小規模チーム、エンタープライズ）

課題：

• 新しい開発者がよく犯す間違いは何ですか？
• 常に従うべきパターンは何ですか？
• 頻繁に繰り返す操作は何ですか？

連携のニーズ：

• 使用している外部サービスは何ですか？（データベース、API、クラウド）
• CI/CD パイプラインはありますか？（GitHub Actions、Jenkins）
• コード品質ツールはありますか？（リンター、フォーマッター）

設定の決定ツリー

Start
│
├─ Small project / Solo dev
│  └─ CLAUDE.md only
│
├─ Team project
│  ├─ Multi-language? → Add .claude/rules/
│  ├─ Complex domain? → Add .claude/skills/
│  ├─ Code reviews? → Add .claude/agents/
│  └─ Repeated tasks? → Add .claude/commands/
│
└─ Enterprise / Large team
   └─ All configurations + MCP servers + Hooks

生成する設定

設定	目的	作成するタイミング
CLAUDE.md	プロジェクトのメモリ（共有）	常に（必須）
CLAUDE.local.md	個人設定（Git で無視）	個人向けのカスタマイズ
.claudeignore	Claude がアクセスすべきでないファイル	機密ファイルがある場合
.claude/rules/	パス固有のルール	複数モジュールのプロジェクト
.claude/skills/	ドメイン知識	複雑なビジネスロジック
.claude/agents/	タスクの専門家	レビュー／デバッグを繰り返す場合
.claude/commands/	クイックプロンプト	よく使うワークフロー
.claude/settings.json	フック＋権限	自動フォーマット、セキュリティ
MCP servers	外部ツール	データベース／API との連携

ワークフロー

フェーズ 1：自動分析

python scripts/analyze_codebase.py [project-path]

スクリプトが検出する項目：

• 言語とフレームワーク
• ディレクトリ構造のパターン
• 開発ツール（リンター、フォーマッター）
• Git コミットのパターン
• 環境変数
• コードスタイルの指標
• CI/CD の設定（GitHub Actions など）
• 機密ファイル（.env、認証情報について警告）

出力内容：

• 作成すべき設定の推奨
• 機密ファイルに関するセキュリティ警告
• 推奨する .claudeignore のパターン

フェーズ 2：コンテキストの収集

Claude が読むべきもの：

1. 代表的なソースファイル 3～5 個 — 命名規則やパターンを把握します
2. テストファイル — テストの手法を把握します
3. 設定ファイル — package.json、tsconfig など
4. README／ドキュメント — プロジェクトの概要
5. 最近のコミット — コミットのスタイルを把握します

フェーズ 2.5：既存のリソースを探す

独自の設定を作成する前に、既存のスキルや MCP サーバーを検索します。

1. スキルのマーケットプレイスを検索する — SkillsMP、SkillHub.club、Claude Skills Hub
2. GitHub リポジトリを確認する — awesome-claude-skills、テーマ別のスキル集
3. 関連する MCP サーバーを探す — Glama、MCP Market、公式レジストリ

ソースの一覧については、references/resource-discovery.md を参照してください。

ヒント：Git コミット、コードレビュー、データベースのパターンなど、多くの一般的なニーズに対応する、適切に保守されたスキルがすでに利用可能です。

フェーズ 3：設定の生成

1. CLAUDE.md（必須）

プロジェクトのルートに作成し、次の内容を記載します。

• クイックリファレンスコマンド（ビルド、テスト、リンター）
• 命名規則
• アーキテクチャの概要
• テストのガイドライン
• Git ワークフロー

references/claude-md-patterns.md を参照してください。

2. ルール（複数モジュールの場合）

次の場合に .claude/rules/ を作成します。

• 複数の言語で異なる規約が必要
• モジュールごとに異なるパターンがある（フロントエンド／バックエンド）
• パス固有の要件がある

references/rules-patterns.md を参照してください。

3. スキル（複雑なドメインの場合）

次の場合は .claude/skills/ を作成します。

• ドメイン固有のワークフローがある（データベース、API パターン）
• チームの知識を保存する必要がある
• 複雑な手順を繰り返し実行する

references/skills-patterns.md を参照してください。

4. サブエージェント（専門的なタスクの場合）

次の用途には .claude/agents/ を作成します。

• コードレビューの自動化
• デバッグ支援
• セキュリティ監査
• ドキュメント生成

references/agents-patterns.md を参照してください。

5. コマンド（よく使う操作の場合）

次の用途には .claude/commands/ を作成します。

• Git コミットのワークフロー
• PR レビュープロセス
• デプロイ手順
• テストの実行

references/commands-patterns.md を参照してください。

6. フック（自動フォーマットが必要な場合）

次の用途には .claude/settings.json を設定します。

• ファイル編集時の自動フォーマット
• 保護対象のファイル
• コマンドのログ記録

references/hooks-patterns.md を参照してください。

7. MCP サーバー（外部連携の場合）

次の用途には MCP を設定します。

• データベースへのアクセス
• GitHub との連携
• Slack 通知
• カスタムの社内ツール

references/mcp-patterns.md を参照してください。

フェーズ 4：検証

1. Claude に一般的なタスクを実行するよう依頼します
2. プロジェクトの規約に従っていることを確認します
3. 見つかった不足点に基づいて反復します

出力構成

最小構成（小規模プロジェクト）：

project/
├── CLAUDE.md
└── [existing files]

標準構成（チームプロジェクト）：

project/
├── CLAUDE.md
├── .claude/
│   ├── rules/
│   │   └── code-style.md
│   └── commands/
│       └── commit.md
└── [existing files]

完全構成（エンタープライズ）：

project/
├── CLAUDE.md              # Shared project memory
├── CLAUDE.local.md        # Personal (git-ignored)
├── .claudeignore          # Files to protect
├── .claude/
│   ├── settings.json      # Hooks + permissions
│   ├── rules/
│   ├── skills/
│   ├── agents/
│   └── commands/
└── [existing files]

参考資料

参考資料	読むタイミング
examples.md	実際の完全な例
resource-discovery.md	既存のスキルと MCP サーバーを探す
advanced-patterns.md	移行、チームでの共同作業、モノレポ
claude-md-patterns.md	CLAUDE.md の作成
rules-patterns.md	モジュール固有のルール
skills-patterns.md	ドメイン知識
agents-patterns.md	タスク別の専門エージェント
commands-patterns.md	クイックプロンプト
hooks-patterns.md	自動フォーマット
mcp-patterns.md	外部ツール

テンプレートと同梱スキル

テンプレート：

• assets/CLAUDE.md.template - プロジェクトメモリのテンプレート
• assets/settings.json.template - フック設定
• assets/claudeignore.template - ファイルの除外パターン

対象プロジェクトにインストールする同梱スキル：

• assets/skill-creator/ - プロジェクト固有の新しいスキルを作成するためのもの
• assets/skill-downloader/ - 追加のスキルをダウンロードするためのもの
• assets/resource-scout/ - 既存のスキルと MCP サーバーを見つけるためのもの

同梱スキルのインストール

これらのスキルを対象プロジェクトの .claude/skills/ ディレクトリにコピーします。

cp -r assets/skill-creator [target-project]/.claude/skills/
cp -r assets/skill-downloader [target-project]/.claude/skills/
cp -r assets/resource-scout [target-project]/.claude/skills/

これにより、対象プロジェクトで次のことが可能になります。

1. resource-scout - カスタムスキルを作成する前に、既存のスキルと MCP サーバーを見つけます
2. skill-downloader - GitHub またはアーカイブからスキルをダウンロードしてインストールします
3. skill-creator - ドメインに合わせたカスタムスキルを作成します

言語別クイックリファレンス

TypeScript/JavaScript

• 抽出：eslint、prettier、tsconfig
• フック：prettier による自動フォーマット
• スキル：API パターン、コンポーネントパターン

Python

• 抽出：black、ruff、mypy、pyproject.toml
• フック：black/ruff による自動フォーマット
• スキル：API パターン、ORM パターン

Go

• 抽出：gofmt、golangci-lint
• フック：gofmt による自動フォーマット
• スキル：エラー処理パターン

Rust

• 抽出：rustfmt、clippy
• フック：rustfmt による自動フォーマット
• スキル：エラー処理、非同期処理のパターン