【結論】解決策 / 実行コマンド
複数ファイル修正では、最初に候補一覧と依存関係を作り、ディレクトリまたは機能単位で変更します。
ライブラリ置換ではAPI差異、タイムゾーン、locale、bundle、テストを確認し、単純な文字列置換にしません。
# ターミナルで実行：作業ブランチを作成
git switch -c refactor/date-library
# ターミナルで実行：基準テストを記録
npm test
# ターミナルで実行：計画モードで起動
claude --permission-mode plan
# ターミナルで実行：変更後の差分を確認
git diff --stat && git diff具体的な手順・設定方法
置換対象と非対象を一覧化します。
一つのモジュールで試し、テストが通ってから範囲を広げます。
依存削除、lockfile、ビルド、型チェックを最後に確認します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
src/reporting内のmoment.js利用だけを調査してください。
date-fnsへ移行する計画を作り、タイムゾーン、locale、テストへの影響を明示してください。
承認後に一つのモジュールだけ移行し、関連テストを実行してください。注意点・よくあるエラーと対処法
一括変更前に未保存ファイルと未コミット差分を確認してください。
動的参照や設定ファイルは検索だけでは見落とす場合があります。
大きな変更を一度に実行せず、レビュー可能なコミットへ分割してください。