Claude CodeでSourceを安全にリファクタリングする方法

【結論】Sourceを限定し、Plan・Test・Diffで安全に修正

Claude CodeでSourceを操作する際は、変更するFileだけでなく、守るInterfaceと検証方法も指定します。

Source全体の自動書換えではなく、影響調査、計画、最小Diff、Regression testの順で進めます。

# ターミナルで作業Branchを作成
git switch -c refactor/source-scope
# Claude CodeをPlan Modeで起動
claude --permission-mode plan

具体的な手順・設定方法

1. 公開API、Data format、Performance条件を明示します。

2. 参照箇所を検索し、変更影響を一覧化します。

3. 編集後は対象Testだけでなく、関連するIntegration testも実行します。

# ターミナルで参照箇所を検索
rg -n 'legacyFormat' src test
# ターミナルで差分のWhitespace errorを確認
git diff --check

実践プロンプト / 活用テクニック

移行ではAdapterを挟み、段階的にCall siteを切り替えるとRollbackしやすくなります。

削除候補は使用箇所がないことを静的検索とTestの両方で確認します。

legacyFormat関数の置換計画を作成してください。
Call site、公開Interface、互換性Risk、移行順、必要なTestを示してください。
まだ削除せず、最小Diffで段階移行できる案にしてください。

注意点・よくあるエラーと対処法

AIが未使用と判断したSourceでも、Reflection、Dynamic import、Configurationから参照される場合があります。

検索結果だけで削除せず、Runtime logとCoverageを確認します。

大規模Refactorでは一つのCommitにまとめず、機械変換と意味変更を分離してください。