| name | migration-guide |
| description | Use when user wants to migrate content from CLAUDE.md to rules, split memory, or reorganize memory structure. Also use when user says 分離したい, 移行したい, リファクタリング, 整理したい. CLAUDE.md から rules フォルダへの移行ガイドで、分離すべき条件、移行手順、ステップバイステップの説明を提供する。 |
| context | fork |
| user-invocable | false |
Migration Guide スキル
CLAUDE.md から rules フォルダへコンテンツを移行する方法を提供。
Instructions
このスキルは CLAUDE.md の内容を rules フォルダに移行する判断基準と手順を説明します。
移行が必要なサイン
警告サイン
| サイン | 説明 | 対応 |
|---|
| CLAUDE.md が300行超 | 肥大化 | 即座に分離検討 |
| 特定ファイル用のルールが混在 | 非効率 | paths 条件で分離 |
| セクションが50行超 | 読みづらい | 個別ファイルに分離 |
| 頻繁な更新 | 変更影響が大きい | 独立管理 |
チェックリスト
□ CLAUDE.md の行数を確認
□ 特定ファイル形式向けのルールがあるか
□ 独立したトピック（テスト、セキュリティなど）があるか
□ 更新頻度が高いセクションがあるか
移行判断マトリクス
| 内容 | CLAUDE.md に残す | rules に移行 |
|---|
| プロジェクト概要 | ✓ | |
| 技術スタック | ✓ | |
| 開発コマンド | ✓ | |
| コーディング規約（概要） | ✓ | |
| コーディング規約（詳細） | | ✓ |
| テスト規約 | | ✓ |
| セキュリティ規約 | | ✓ |
| API 設計ガイド | | ✓ |
| フレームワーク固有ルール | | ✓ |
| DB 操作ルール | | ✓ |
移行手順
Step 1: 現状分析
wc -l CLAUDE.md
/memory
Step 2: 分離対象の特定
CLAUDE.md を読み、以下を特定:
- 50行以上のセクションをマーク
- 特定ファイル向けのルールをマーク
- 独立トピックをマーク
Step 3: rules ディレクトリ作成
mkdir -p .claude/rules
Step 4: ルールファイル作成
各トピックごとにファイルを作成:
---
paths:
- "適用対象のパスパターン"
---
# ルール名
移行した内容をここに記載
Step 5: CLAUDE.md の更新
移行した内容を削除し、参照を追加:
# プロジェクト名
## 概要
（残す内容）
## 詳細ルール
詳細なルールは `.claude/rules/` を参照:
- コードスタイル: `rules/code-style.md`
- テスト: `rules/testing.md`
- セキュリティ: `rules/security.md`
Step 6: 検証
/memory
移行例
Before: 肥大化した CLAUDE.md
# my-project
## 概要
...
## 技術スタック
...
## TypeScript ルール（50行以上）
...詳細な型定義ルール...
...エラーハンドリング...
...命名規則...
## テストルール（80行以上）
...テスト構成...
...モック方法...
...カバレッジ基準...
## セキュリティ（40行）
...認証...
...認可...
After: 分離後
CLAUDE.md（簡潔化）:
# my-project
## 概要
...
## 技術スタック
...
## ルール参照
詳細なルールは `.claude/rules/` を参照。
.claude/rules/typescript.md:
---
paths:
- "**/*.ts"
- "**/*.tsx"
---
...（移行した内容）...
.claude/rules/testing.md:
---
paths:
- "**/*.test.ts"
- "**/*.spec.ts"
---
...（移行した内容）...
.claude/rules/security.md:
---
# paths なし = 全ファイルに適用
---
# セキュリティルール
...（移行した内容）...
移行時の注意点
やるべきこと
- 移行前に CLAUDE.md をバックアップ
- 段階的に移行（一度に全部やらない）
- 移行後に
/memory で確認
- 実際の作業で動作確認
避けるべきこと
- 内容の重複（同じルールを複数箇所に書かない）
- 過度な細分化（ファイルが多すぎると管理困難）
- paths 条件の複雑化（シンプルに保つ）
トラブルシューティング
ルールが適用されない
1. paths 条件を確認
2. ファイルパスがパターンにマッチするか確認
3. /memory でロード状態を確認
複数ルールが競合
1. 内容を統合
2. より具体的な paths を設定
3. 一方を削除
Examples
段階的移行
Week 1: テストルールを移行
Week 2: セキュリティルールを移行
Week 3: API ルールを移行
Week 4: 残りを整理
最小移行
CLAUDE.md から最も大きいセクションだけを移行:
