codex-plan-review

Codex CLIを使ったplanファイルレビュー

planファイルの実現可能性、技術的妥当性、抜け漏れやリスクについて、Codex CLIを使って客観的にレビューします。

実行手順

• レビューループ（最大5回）によりコンテキストが大きくなる場合があります。コンテキスト使用量に注意してください。

1. 開発日誌の取得（コンテキストにある場合）

会話のコンテキスト内にesa URLの開発日誌が言及されている場合、以下の手順で取得してください：

1.1 post番号の抽出

esa URLからpost番号を抽出（例：https://yasuhisa.esa.io/posts/1234 → 1234）

1.2 YAMLの直接取得

esa-llm-scoped-guard fetch コマンドでYAMLを直接取得：

esa-llm-scoped-guard fetch -post <post_number> | tee .claude_work/dev_diary.yaml

成功の場合: YAMLが .claude_work/dev_diary.yaml に保存されるので、次のステップへ進む

失敗の場合: エラーメッセージをユーザーに報告し、このステップをスキップ

開発日誌がコンテキストにない場合は、このステップ全体をスキップしてください。

2. planファイルの特定と最新化

2.1 planファイルの取得

.claude_work/plans/配下からplanファイルを取得してください：

ls .claude_work/plans/*.md

git worktree運用のため、単一のplanファイルが存在する前提です。

このファイルパスを以下のように定義します：

<取得したplanファイルのパス>

2.2 planファイルの最新化チェック

重要: Codexはplanファイルに基づいてレビューするため、planファイルが最新でないと意味がない

1. planファイルを読み取る

2. 会話コンテキスト（開発日誌が取得されている場合はその内容も含む）と比較し、以下の観点で確認：

   • 前提条件: ユーザーとの会話や開発日誌で決まった技術選択・制約がplanに含まれているか
   • 仕様変更: 当初の要件から変更された点がplanに反映されているか
   • 新規決定事項: 会話中や開発日誌に記載された実装方針・アプローチがplanに含まれているか
   • 削除された要件: もはや不要になった要件がplanから削除されているか

3. 差分がある場合:

   • 差分内容（追加・修正・削除すべき箇所）を具体的にユーザーに提示
   • 修正可否を確認し、ユーザー承認後にplanファイルを修正（Editツール使用）

4. 差分がない場合: 次のステップへ進む

2.3 ユーザー発言ログとの整合性確認

.claude_work/user_prompts.txt が存在する場合、planファイルのユーザー発言ログセクションに書き漏れがないか確認する：

1. .claude_work/user_prompts.txt を読み取る
2. planファイルの「ユーザー発言」セクション（生ログ・要約）と突き合わせる
3. 以下の観点で確認：
   • ユーザーが明示的に要件・制約として述べた内容がplanに反映されているか
   • ユーザーの意図や方針決定が漏れていないか
4. 書き漏れがある場合: 漏れている内容を具体的にユーザーに提示し、planへの反映要否を確認

3. Codex CLIでのレビュー実行

Bash経由でcopilot --model gpt-5.3-codexを使ってレビューを実行してください。

重要:

• コマンドはリポジトリルートで実行すること（相対パスが前提）
• プロンプトは必ず Editツールで .claude_work/review_prompt.md に書き出してから cat でパイプすること

開発日誌がない場合の例：

1. Editツールで .claude_work/review_prompt.md を作成：