レガシーコードを「資産」へ変える：Windsurfによる構造的リファクタリングの極意
多くのエンジニアが「レガシーコード」という言葉に恐怖を感じるのは、それが単に古いからではない。「意図が不明なまま、副作用への恐怖に支配されて修正できない」という、認知コストの暴走こそが真の敵だからだ。
Codeiumが開発した「Windsurf」は、単なるAIエディタではない。プロジェクトのコンテキストを文脈として理解し、リポジトリ全体を俯瞰する「自律的ナビゲーター」だ。本稿では、このツールを使い倒し、ドキュメントなきレガシーコードを解読し、安全に再設計するための「プロの現場の作法」を伝授する。
—
1. Windsurfによる「解読」のパラダイムシフト：Cascadeの真髄
レガシーコードと対峙する際、最もやってはいけないのが「いきなりコードを書き換えること」だ。Windsurfの核である Cascade を使い、まずは「推論」から始める。
Cascadeへのプロンプト戦略：構造を「見える化」する
AIにただ「解説して」と頼むのは素人だ。プロジェクトの依存関係の骨格を抽出させるための指示（システムプロンプト的なアプローチ）を徹底する。
アクション：ドキュメント生成プロンプトのテンプレート
1. このモジュールにおける「純粋関数」と「副作用を持つ関数」を分類せよ。
2. データフロー図をMermaid記法で出力せよ。
3. なぜこの設計が選択されたのか、当時の技術的負債や制約を推測し、現状のボトルネックを特定せよ。
これにより、Windsurfは`@workspace`を通じてリポジトリ内の関数呼び出しグラフを静的解析し、頭の中に「動く仕様書」を構築する。
—
2. 開発スピードを極限まで高める：アーキテクト級ショートカットと設定
Windsurfの力を引き出すには、指先とエディタの同期率を100%にする必要がある。
隠れたキーボードショートカット
- `Cmd + I` (Ctrl + I): Cascade Invoke。コンテキストを維持したまま、カーソル位置の周囲をAIに書き換えさせる。
- `Cmd + K` (Ctrl + K): In-line Edit。小規模なリファクタリング（変数名の置換やロジックの抽出）にはこちら。
- `Cmd + Shift + L`: Context Selection。特定のファイルを明示的にコンテキストに追加する。リポジトリが肥大化している際、AIの迷走を防ぐ必須操作。
推奨設定：`.windsurf/config.json` のベストプラクティス
チーム全体で開発体験を統一するため、プロジェクトルートに設定を置く。
{
“windsurf.ai.context.exclude”: [
“/dist/“,
“/node_modules/“,
“/.git/“,
“/vendor/”
],
// AIの推論精度を上げるため、巨大な自動生成ファイルはコンテキストから除外する
“windsurf.ai.model.temperature”: 0.2,
// リファクタリング時は創造性よりも正確性を重視し、温度を下げるのが鉄則
“windsurf.ai.inline.enable”: true
}
—
3. チーム開発における「知識の共通化」ルール
個人の生産性向上で止まれば、それは個人の趣味に過ぎない。チーム全体でレガシーコードを攻略するルールを定義する。
「設計の意思」をコードで語る：`.cursorrules` の活用
WindsurfはCursorの思想を継承しているため、プロジェクト直下の`.cursorrules`（または`.windsurf/rules`）が強力な武器になる。
プロジェクトの設計指針（これをAIに読み込ませる）
- 責務の分離: 1関数10行以内を厳守すること。
- 命名規則: 副作用がある場合は `unsafe_` 接頭辞を付けること。
- 型定義: 既存の型が不明な場合、anyを使わず `unknown` を活用して型安全を確保すること。
これを置いておくだけで、新メンバーがAIを使ってコードを書く際も、ベテランの設計思想が強制的に反映される。
—
4. 安全なリファクタリングのための「境界テスト」生成
レガシーコードの修正で最も怖いのはデグレだ。Windsurfの真骨頂は、「修正と同時にテストを書かせる」ことにある。
1. 既存挙動のキャプチャ: 修正対象の関数をWindsurfに読み込ませ、「この関数の現在の入力値と出力値のパターンを、Jestのテストケースとして出力してくれ」と命じる。
2. 検証: 生成されたテストを走らせ、グリーンになることを確認する。
3. 安全な改修: テストを通過させながら、Cascadeを使って段階的にリファクタリングを行う。
—
結論：AIエディタは「航海士」である
Windsurfは、あなたの代わりにコードを書くツールではない。複雑なレガシーコードという暗い海を渡るための、極めて優秀な「航海士」だ。
あなたがテックリードとしてやるべきことは、AIに答えを求めることではなく、AIに対して「どこを、なぜ、どう変えたいか」という問いを正しく投げ続けることだ。このツールを導入することで、これまで数週間かかっていたレガシーシステムのリプレイスや機能追加は、数日の集中作業へと劇的に短縮される。
今すぐリポジトリのルートに`.windsurf`ディレクトリを作り、チームの知見をコード化することから始めてほしい。コードは、読まれるのを待っている。AIと共に、それを「資産」へと昇華させよう。