はじめに

使われていないコードや重複したロジック、実態に合わなくなった抽象化、肥大化したファイル、古い実装パターンがコードベースに蓄積すると、変更のたびに余計な手間がかかります。そのような場合は、リファクタリングで技術的負債を減らすことを検討してください。リファクタリングでは、技術スタックの移行にまで作業を広げず、既存のシステムの構造を改善します。

Codex はまず、複雑になった箇所の構造を把握し、レビューしやすい小さな変更に分けてコードを整理できます。使われていない処理経路の削除、大きなモジュールの整理、重複した処理経路の統合、フレームワークの古い使い方の見直しを進めながら、変更ごとの検証を強化できます。

既存のコードベースをそのまま改善するために、次のことを目指します。

1. 使われていないコード、役目を終えたヘルパー、古いフラグ、不要になった互換性維持用のコードを削除します。
2. ヘルパーを抽出する、コンポーネントを分割する、副作用を伴う処理を責務の明確な箇所に移すなどして、見通しの悪いモジュールを小さくします。
3. 古い実装パターンを、リポジトリの現在の規約に沿った実装に置き換えます。たとえば、フレームワークの新しい基本機能、より明確な型、より単純な状態の流れ、標準ライブラリのユーティリティを使います。
4. 外部から見た動作を維持しながら、次の変更にかかる手間を減らします。

進め方

1. 編集を始める前に、Codex に対象範囲を調べてもらいます。見通しの悪いモジュール、重複したロジック、使われていないコード、テスト、公開インターフェースが保証する動作、リポジトリの現状に合わなくなった古い実装パターンを洗い出してもらいます。
2. 一度に取り組む課題は一つに絞ります。たとえば、使われていないコードを削除する、制御フローを簡素化する、古い実装パターンを更新する、大きなファイルを担当範囲が明確な小さな単位に分割する、といった課題から選びます。
3. Codex がファイルを変更する前に、現在の動作、構造をどう改善するか、動作が変わっていないことを確認するために必要な最小限の検証を説明してもらいます。
4. すべての変更を一つの差分にまとめず、変更のたびに差分をレビューし、その変更に必要な最小限の検証を実行します。
5. 技術スタックの変更、依存関係の移行、アーキテクチャの変更は、今回のコード整理を完了するために必要な場合を除き、別のタスクとして扱います。

ExecPlans の活用

コードのモダナイゼーションに関するクックブックでは、ExecPlans を紹介しています。ExecPlans は、Codex が作業の全体像を把握し、目指す状態を明確にして、変更ごとの検証結果を記録するための文書です。 リファクタリングが複数のモジュールやセッションにまたがる場合に役立ちます。削除したもの、更新した実装パターン、維持する必要があったインターフェースの仕様、引き続き保留している項目を記録しておきます。

繰り返す作業でのスキルの活用

スキルは、複数のリポジトリ、サービス、チームで同じルールに従ってコードを整理するときに役立ちます。フレームワーク専用のスキルがあれば活用し、リスクの高い変更にはセキュリティや CI のスキルも組み合わせます。使われていないコードの削除、モジュールの切り出し、古い実装パターンの更新について実績のあるチェックリストがあれば、チーム用のスキルを作成します。 複数のコードベースで同じ手順で実装を更新することになったら、最初にうまくいった手順を Codex と一緒に再利用可能なスキルにまとめられます。