Skip to content

[Fix] review orchestrator の Agent 起動に run_in_background: false を明示指定#215

Merged
BlueEventHorizon merged 2 commits into
developfrom
fix/208-agent-sync
Jul 16, 2026
Merged

[Fix] review orchestrator の Agent 起動に run_in_background: false を明示指定#215
BlueEventHorizon merged 2 commits into
developfrom
fix/208-agent-sync

Conversation

@BlueEventHorizon

Copy link
Copy Markdown
Owner

概要

  • /forge:review orchestrator (plugins/forge/skills/review/SKILL.md) が reviewer / evaluator / fixer / 汎用 Agent (関連コード探索) を起動する全5箇所に run_in_background: false を明示指定
  • 対応する起動契約の正本 DES-029 にも同期実行契約を反映

Closes #208

背景

Claude Code v2.1.198 以降、Agent ツールで起動した subagent は既定でバックグラウンド実行される。review/SKILL.md の Agent 起動箇所にはこの明示指定が無く、完了待機の手段(allowed-toolsMonitor/TaskOutput 無し)も存在しないため、Issue #200(1層下の reviewer Agent → codex exec 境界、PR #206 で対応済み)と同型の問題が、1層上の orchestratorAgent ツール境界に残存していた。

やったこと

  • plugins/forge/skills/review/SKILL.md に「Agent 起動時の同期実行 [MANDATORY]」節を新規追加(1箇所に集約)し、reviewer起動×2 / evaluator起動 / fixer起動 / 汎用Agent起動(関連コード探索)の全5箇所の起動コードブロックに run_in_background: false を明示追加
  • docs/specs/forge/design/DES-029_skill_agent_launch_contract_design.md のシーケンス図 (§4.2/§4.3) を run_in_background: false に更新し、§6.7 として同期実行契約を追記(実装レビューで設計SSOTとの乖離を指摘され対応)
  • 回帰防止テスト tests/forge/review/test_orchestrator_agent_sync_execution.py を新規追加(7テスト): 同期実行ルールの明示・各Agent起動ブロックへの run_in_background: false 指定を静的検証

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

レビュー観点

  • python3 -m unittest discover -s tests 1448件 pass
  • dprint check pass
  • 実装レビューで「設計SSOTが実装に追随していない」指摘を受け、DES-029 を追加コミットで対応済み

レビューレベル

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

…を明示指定 (#208)

Claude Code v2.1.198 以降、Agent ツールで起動した subagent は既定でバックグラウンド実行される。
review/SKILL.md の reviewer/evaluator/fixer/汎用Agent 起動箇所にはこの明示指定が無く、
完了待機の手段(allowed-tools に Monitor/TaskOutput 無し)も存在しないため、
Issue #200(1層下の reviewer→codex exec 境界)と同型の問題が orchestrator→Agent 境界に残存していた。
PR #206 の指示パターンを踏襲し、同期実行 [MANDATORY] 節を追加し全5箇所の Agent 起動ブロックに
run_in_background: false を明示。回帰防止テストを新規追加。

Closes #208
review orchestrator の Agent 起動に run_in_background: false を明示指定した実装
(68849a8) に対し、起動契約の正本である DES-029 のシーケンス図・§6 共通設計が
追随していなかった。§4.2/§4.3 のシーケンス図に run_in_background: false を反映し、
§6.7 として同期実行契約を明記した。

Refs #208
@BlueEventHorizon BlueEventHorizon self-assigned this Jul 16, 2026
@BlueEventHorizon
BlueEventHorizon merged commit d4f44e0 into develop Jul 16, 2026
1 check passed
@BlueEventHorizon
BlueEventHorizon deleted the fix/208-agent-sync branch July 16, 2026 13:08
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