|
| 1 | +# 実行チェックリスト |
| 2 | + |
| 3 | +## 📋 移行実行前の確認 |
| 4 | + |
| 5 | +### 準備フェーズ |
| 6 | + |
| 7 | +- [ ] `plan.md` の内容をレビュー完了 |
| 8 | +- [ ] 現在のブランチが正しいことを確認 (`git branch`) |
| 9 | +- [ ] 作業用ブランチを作成(推奨): `git checkout -b refactor/lucide-migration` |
| 10 | +- [ ] 最新の状態に更新: `git pull origin staging` |
| 11 | + |
| 12 | +--- |
| 13 | + |
| 14 | +## 🔄 移行実行フェーズ |
| 15 | + |
| 16 | +### ステップ 1: バックアップとコミット |
| 17 | + |
| 18 | +- [ ] 現在の状態をセーブ: `git add -A && git commit -m "backup: before lucide migration"` |
| 19 | +- [ ] コミットハッシュを記録: `git log --oneline -1` |
| 20 | + |
| 21 | +### ステップ 2: パッケージ置き換え |
| 22 | + |
| 23 | +- [ ] 現在のバージョンを確認: `pnpm list lucide-svelte` |
| 24 | + - 記録: `lucide-svelte@______` |
| 25 | +- [ ] 古いパッケージをアンインストール: `pnpm remove lucide-svelte` |
| 26 | +- [ ] 新しいパッケージをインストール: `pnpm add @lucide/svelte` |
| 27 | +- [ ] インストール完了を確認: `pnpm list @lucide/svelte` |
| 28 | + - 記録: `@lucide/svelte@______` |
| 29 | +- [ ] `pnpm-lock.yaml` が更新されたことを確認: `git status` |
| 30 | + |
| 31 | +### ステップ 3: コード修正 |
| 32 | + |
| 33 | +- [ ] インポート箇所を検索: `grep -r "from 'lucide-svelte" src/` |
| 34 | +- [ ] 各ファイルを修正(対象ファイル数: **\_**) |
| 35 | + - [ ] `src/routes/+page.svelte` |
| 36 | + - [ ] 修正前: `import ArrowRight from 'lucide-svelte/icons/arrow-right'` |
| 37 | + - [ ] 修正後: `import { ArrowRight } from '@lucide/svelte/icons'` |
| 38 | + - [ ] 保存完了 |
| 39 | + |
| 40 | +--- |
| 41 | + |
| 42 | +## ✅ 検証フェーズ |
| 43 | + |
| 44 | +### ステップ 4: 型チェック |
| 45 | + |
| 46 | +- [ ] TypeScript 型チェック実行: `pnpm check` |
| 47 | + - 結果: **\*\***\_\_\_**\*\*** |
| 48 | + - [ ] エラーなし ✅ |
| 49 | + - [ ] エラーあり (詳細: **\*\***\_\_\_\_**\*\***) |
| 50 | + |
| 51 | +### ステップ 5: ビルド確認 |
| 52 | + |
| 53 | +- [ ] ビルド実行: `pnpm build` |
| 54 | + - ビルド時間: **\_** 秒 |
| 55 | + - [ ] 成功 ✅ |
| 56 | + - [ ] 失敗 (エラー: **\*\***\_\_\_\_**\*\***) |
| 57 | +- [ ] ビルドレポートを確認 |
| 58 | + - lucide 関連のサイズ: **\_** KB |
| 59 | + - 前回との比較: **\_** KB (削減/増加) |
| 60 | + |
| 61 | +### ステップ 6: 開発サーバー確認 |
| 62 | + |
| 63 | +- [ ] 開発サーバー起動: `pnpm dev` |
| 64 | + - ポート: 5173 |
| 65 | + - [ ] 起動成功 ✅ |
| 66 | + |
| 67 | +- [ ] ブラウザで画面確認 |
| 68 | + - URL: http://localhost:5173 |
| 69 | + - [ ] ページ表示 OK ✅ |
| 70 | + - [ ] ArrowRight アイコン表示 OK ✅ |
| 71 | + - [ ] コンソールエラー: なし ✅ |
| 72 | + |
| 73 | +- [ ] ページ操作確認 |
| 74 | + - [ ] ナビゲーション動作 OK ✅ |
| 75 | + - [ ] アイコンレンダリング OK ✅ |
| 76 | + |
| 77 | +### ステップ 7: テスト実行 |
| 78 | + |
| 79 | +- [ ] ユニットテスト: `pnpm test:unit` |
| 80 | + - 結果: **\*\***\_\_\_**\*\*** |
| 81 | + - [ ] 全テスト成功 ✅ |
| 82 | + - [ ] 失敗 (テスト: **\*\***\_\_\_\_**\*\***) |
| 83 | + |
| 84 | +- [ ] E2E テスト: `pnpm test:integration` |
| 85 | + - 結果: **\*\***\_\_\_**\*\*** |
| 86 | + - [ ] 全テスト成功 ✅ |
| 87 | + - [ ] 失敗 (テスト: **\*\***\_\_\_\_**\*\***) |
| 88 | + |
| 89 | +### ステップ 8: Lint/Format チェック |
| 90 | + |
| 91 | +- [ ] Prettier チェック: `pnpm format` |
| 92 | + - [ ] 修正なし ✅ |
| 93 | + - [ ] 修正あり (ファイル数: \_\_\_\_) |
| 94 | + |
| 95 | +- [ ] ESLint チェック: `pnpm lint` |
| 96 | + - [ ] エラーなし ✅ |
| 97 | + - [ ] エラーあり (詳細: **\*\***\_\_\_\_**\*\***) |
| 98 | + |
| 99 | +--- |
| 100 | + |
| 101 | +## 📝 完了フェーズ |
| 102 | + |
| 103 | +### ステップ 9: 変更内容の確認 |
| 104 | + |
| 105 | +- [ ] 差分を確認: `git diff` |
| 106 | + - 修正ファイル数: \_\_\_\_ |
| 107 | + - 主要な変更: |
| 108 | + - `package.json` ✅ |
| 109 | + - `pnpm-lock.yaml` ✅ |
| 110 | + - `src/routes/+page.svelte` ✅ |
| 111 | + |
| 112 | +### ステップ 10: コミット |
| 113 | + |
| 114 | +- [ ] ステージング: `git add package.json pnpm-lock.yaml src/routes/+page.svelte` |
| 115 | +- [ ] コミット: |
| 116 | + ```bash |
| 117 | + git commit -m "refactor: migrate lucide-svelte to @lucide/svelte for Svelte 5" |
| 118 | + ``` |
| 119 | +- [ ] コミット完了確認: `git log --oneline -1` |
| 120 | + |
| 121 | +### ステップ 11: プッシュと PR |
| 122 | + |
| 123 | +- [ ] ローカル変更完了 |
| 124 | + - [ ] 全テスト成功 |
| 125 | + - [ ] ビルド成功 |
| 126 | +- [ ] リモートにプッシュ: `git push origin refactor/lucide-migration` |
| 127 | +- [ ] GitHub で PR を作成 |
| 128 | + - [ ] PR タイトル入力 |
| 129 | + - [ ] 説明文を追加(`plan.md` のリンク) |
| 130 | + - [ ] レビュアー指定 |
| 131 | + |
| 132 | +--- |
| 133 | + |
| 134 | +## 🚨 トラブルシューティング |
| 135 | + |
| 136 | +### エラーが発生した場合 |
| 137 | + |
| 138 | +| エラー | 原因 | 対策 | |
| 139 | +| ----------------------------------------- | --------------------- | ------------------------------------- | |
| 140 | +| **`Cannot find module '@lucide/svelte'`** | インストール失敗 | `pnpm install` を再実行 | |
| 141 | +| **型定義エラー** | TypeScript キャッシュ | `pnpm dlx tsc --noEmit` で確認 | |
| 142 | +| **ビルド失敗** | 未修正インポート | `grep -r "lucide-svelte" src/` で検索 | |
| 143 | +| **テスト失敗** | キャッシュ問題 | `pnpm store prune && pnpm install` | |
| 144 | + |
| 145 | +### ロールバック手順 |
| 146 | + |
| 147 | +エラーが解決しない場合: |
| 148 | + |
| 149 | +```bash |
| 150 | +# 最後のコミットに戻す |
| 151 | +git revert HEAD |
| 152 | + |
| 153 | +# または |
| 154 | +git reset --hard <backup-commit-hash> |
| 155 | + |
| 156 | +# lock ファイルも復元 |
| 157 | +pnpm install |
| 158 | +``` |
| 159 | + |
| 160 | +--- |
| 161 | + |
| 162 | +## 📊 記録 |
| 163 | + |
| 164 | +| 項目 | 値 | |
| 165 | +| -------------------- | ------------------------ | |
| 166 | +| **開始日時** | 2025-10-25 **_:_** | |
| 167 | +| **完了日時** | 2025-10-25 **_:_** | |
| 168 | +| **所要時間** | **\_** 分 | |
| 169 | +| **修正ファイル数** | **\_** | |
| 170 | +| **ビルドサイズ削減** | **\_** KB (**\_** %) | |
| 171 | +| **テスト成功率** | **\_** / **\_** ✅ | |
| 172 | +| **備考** | **\*\***\_\_\_\_**\*\*** | |
| 173 | + |
| 174 | +--- |
| 175 | + |
| 176 | +**チェックリスト作成日**: 2025-10-25 |
| 177 | +**バージョン**: 1.0 |
0 commit comments