Codex でリファクタリング：計画、ゴール、ステップごとのレビュー

リファクタリングで Codex ができること

• リファクタリングのバックログを、1 ステップずつ別々のプルリクエストにして、小さく進めます。
• 各ステップの前後でテストを実行し、失敗したら止まります。
• 移行の機械的な部分を引き受けます：コードベース全体での名前の変更、API のアップグレード、新しいライブラリへの移行。
• 使われていないコードや重複したロジックを削除し、削除のたびに理由を説明します。

リファクタリングに使える Codex の機能

リファクタリング向けに Codex を設定する方法

1. ツールをつなぐ

   つなぐものはありません。リファクタリングを安全にするのは、Codex が実行できるテストコマンドと、各ステップの大きさの上限です。どちらも AGENTS.md に書きましょう。

   # CLI で：計画を合意してから、ゴールを設定する
   /plan Propose a migration plan for the billing module
   /goal Finish the migration and keep tests green

2. AGENTS.md にルールを書く

   Codex は作業の前に AGENTS.md を読みます。まず ~/.codex/AGENTS.md、次にリポジトリのルートから作業中のフォルダまでのファイルです。仕事のルールはそこに書くか、長くなるなら .agents/skills/ 以下のスキルにします。AGENTS.md ガイドをご覧ください。

   ## リファクタリングのルール
   - 振る舞いは変えない。テストを変える必要があれば、止まって確認する。
   - 始める前と各ステップの後に `npm test` を実行する。
   - 1 つのプルリクエストに 1 ステップ、変更は 400 行未満。
   - REFACTOR.md を最新に保つ：終わったものにチェックを付け、
     見つけたものを追加する。
   - 確認なしに migrations/、生成されたファイル、公開 API に
     触れない。

3. 対話型の画面なしで実行する

   codex exec は 1 つのタスクを実行して終了します。進捗は stderr に、最終メッセージは stdout に出力されます。-o を付けるとファイルにも書き出し、--json を付けるとイベントをストリームします。--sandbox workspace-write を渡さない限り、サンドボックスは読み取り専用です。

   # 1 日目、そして翌日に同じセッションをもう一度
   codex exec --sandbox workspace-write "REFACTOR.md の最初のステップをこなして"
   codex exec resume --last "REFACTOR.md で次の未チェックのステップに進んで"

4. スケジュールに載せる

   ChatGPT のデスクトップアプリか Web でスケジュールタスクを作るか（CLI では管理できません）、cron から codex exec を実行します。Codex を自律的に動かす方法をご覧ください。

出典：Codex のドキュメント

限界と安全性

• テストがなければ、リファクタリングと振る舞いの変更を見分けられません。まずその領域にテストを追加しましょう。
• 大きな書き直しを一度に行うと、レビューが難しくなります。1 つずつマージできる小さなステップのほうが安全で、結局は速く進みます。
• どの奇妙なコードが意図的なものかは知りません。そうした箇所には、コメントかルールで印を付けておきましょう。
• Codex はデフォルトでコマンドをサンドボックスの中で実行します。書き込みはワークスペース内に限られ、ネットワークはオフです。danger-full-access は、隔離されたランナーやコンテナでだけ使いましょう。

リファクタリングに使うなら Claude Code と Codex のどちら？

ルールはそのまま使い回せます。AGENTS.md に一度書き、CLAUDE.md に @AGENTS.md と書いておけば、両方のエージェントが同じファイルを読みます。

もう一方のエージェントでの手順：リファクタリングを Claude Code で行う方法。

リファクタリングを誰かの仕事にする

コマンドは、誰かが実行を思い出したときにしか動きません。Crewmark は、あなたの Codex を、職種、数字の目標、勤務時間、ハートビートを持つ AI 社員に変えます。仕事はスケジュールどおりに進み、ボードに表示されます。

1. 職種から始める

   AI ソフトウェアエンジニアを選び、ブリーフにこのページのルールを加えます。

2. 仕事をボードに載せる

   この仕事を定期 issue として追加します。社員はハートビートで起きて仕事をこなし、結果をコメントで報告します。

3. 関連ページ

   各ステップは、マージの前にコードレビューでチェックします。

よくある質問