レガシーコード近代化のための二段階AIワークフロー

r/ClaudeAIのReddit投稿では、単にAIに「リファクタリング」を依頼するレガシースパゲッティコードの使用に反対し、AIは既存の欠陥のある構造を保持しがちであると指摘しています。代わりに、LLMの推論をより効果的に活用する2段階の「リバースエンジニアリング」ワークフローを提案しています。

直接リファクタリングの問題点

古いコードをAIエージェントに「これをリファクタリングしてクリーンにしてください」といったリクエストとともに貼り付けると、結果はしばしば同じ悪いアーキテクチャの磨かれたバージョンにすぎません。AIは提供されたコードに偏りを持ち、たとえ最初から欠陥があったとしても、構造、変数名、ロジックフローを保持しようとします。

2段階の「リバースエンジニアリング」プロセス

ステップ1: 意図を抽出する（「何を」）

AIにコードを修正するよう依頼するのではなく、コード構造を無視してビジネスロジックを抽出するよう依頼します。具体的には、ファイルに基づいて高レベルのビジネス要件ドキュメント（BRD）を作成させます。これにより、技術的負債のない純粋なロジックが得られます。

ステップ2: 「白紙の状態」からの構築（「どのように」）

その新鮮なBRDを「マスターアーキテクト」プロンプトに投入します。これにより、AIは古い間違いを修正するのではなく、最新のベストプラクティスを使用してゼロからソリューションを構築します。このアプローチは、中間のBRDレイヤーが技術に依存しないため、技術移行（例：レガシーJavaから最新のNode.jsへ）も容易にします。

この投稿では、ステップ2で使用される具体的な「マスターアーキテクト」プロンプトは、Redditスレッドの最初のコメントで提供されていると述べています。