Skip to content

[Fix] reviewer.md の engine=codex 時の二重レビュー構造を修正#217

Merged
BlueEventHorizon merged 1 commit into
developfrom
fix/210-reviewer-engine-branch-double-review
Jul 17, 2026
Merged

[Fix] reviewer.md の engine=codex 時の二重レビュー構造を修正#217
BlueEventHorizon merged 1 commit into
developfrom
fix/210-reviewer-engine-branch-double-review

Conversation

@BlueEventHorizon

Copy link
Copy Markdown
Owner

概要

/forge:review の reviewer 遅延調査で発見された、engine=codex 時にも reviewer Agent 自身が
全参照文書の精読と自前レビュー(P1→P2→P3評価)を実行し得る二重レビュー構造を修正。

背景

plugins/forge/agents/reviewer.md のワークフローが Phase 1(全文書Read)→ Phase 2/3
(レビュー実行)→ Phase 4(エンジン別の実行)の直列構成で、Phase 2/3 に engine=claude
限定の条件が明記されていなかった。

やったこと

  • reviewer.md: Phase 1 の Read 範囲を engine=codex 時は最小限に限定、Phase 2/3 を
    engine=claude(Codex不在時のフォールバック含む)限定と明記
  • reviewer.md: Codex不在フォールバック時に実効engineをclaudeに切り替え、Phase 1未読分
    • Phase 2/3 を再開する手順を明記
  • DES-015 §Phase4①、DES-029 §4.2 シーケンス図を上記のengine分岐と整合するよう更新
  • tests/forge/review/test_codex_launch_path.py に静的回帰テストを追加(TestReviewerEngineScopedPhases、6件)
  • 副次的に発見された reviewer.md の孤立記述(対応する実行手順のない dprint fmt 言及)も削除

やらないこと(このプルリクエストのスコープ外とすること)

  • DES-029自体の設計変更(既にengine分岐が正しく記述済みのため不要)

レビュー観点

  • reviewer.md の Phase 2/3 見出し直後の engine 条件明記が、Phase 4 の既存分岐と矛盾しないか
  • DES-015 / DES-029 の記述整合性
  • 静的回帰テスト(全1461件 OK, skipped=1)

レビューレベル

  • Lv0: まったく見ないでAcceptする
  • Lv1: ぱっとみて違和感がないかチェックしてAcceptする
  • Lv2: 仕様レベルまで理解して、仕様通りに動くかある程度検証してAcceptする
  • Lv3: 実際に環境で動作確認したうえでAcceptする

Closes #210

reviewer.md の Phase 2/3 (P1→P2→P3 自前評価・severity 委譲) が engine 条件なしの
直列記述になっており、engine=codex 時にも実行され得ることで codex 実行との二重
レビューを招く不具合を修正。Phase 2/3 を engine=claude (Codex 不在時のフォール
バック含む) 限定と明記し、Phase 1 の Read 範囲も engine=codex 時は最小限に留める
よう修正。Codex 不在フォールバック時に実効 engine を claude に切り替えて Phase 1
未読分 + Phase 2/3 を再開する手順も明記した。

DES-015 §Phase4① および DES-029 §4.2 シーケンス図を、上記の engine 分岐と整合す
るよう更新。静的回帰テスト (test_codex_launch_path.py) を追加。

Closes #210
@BlueEventHorizon BlueEventHorizon self-assigned this Jul 17, 2026
@BlueEventHorizon
BlueEventHorizon marked this pull request as ready for review July 17, 2026 11:08
@BlueEventHorizon
BlueEventHorizon merged commit be82ec1 into develop Jul 17, 2026
1 check passed
@BlueEventHorizon
BlueEventHorizon deleted the fix/210-reviewer-engine-branch-double-review branch July 17, 2026 11:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant