# `/ultrareview` と `/harness-review` の連携方針 Phase 44.8.1 で確定した方針ドキュメント。 --- ## 1. `/ultrareview` の挙動 `/ultrareview` は Claude Code 2.1.111 で追加された **built-in slash command**。 Claude Code 2.1.120 以降では、CI や script から使うための `claude ultrareview [target] --json` も用意されている。 | 属性 | 内容 | |------|------| | セッション種別 | single-turn dedicated review session | | 実行主体 | CC ネイティブ（Harness agent 外） | | 入力 | 現在の作業ツリー差分（自動収集） | | 出力 | インラインの自然言語レビュー結果 | | 出力スキーマ | 未定義（CC 内部形式） | | CLI 入口 | `claude ultrareview [target] --json`（CI / ad-hoc second-opinion 用） | | Plans.md 連動 | なし | | sprint-contract 検証 | なし | | Codex adversarial review | なし | | Reviewer agent 呼び出し | なし | `/ultrareview` は「ユーザーが直接 CC に対してアドホックなレビューを求める」entrypoint であり、 Harness の自動化フロー（Plan → Work → Review）の外側で動作する。 `claude ultrareview [target] --json` も同じ位置づけで、CI から補助的に呼ぶ入口であって `/harness-review` の代替ではない。 --- ## 2. `/harness-review` との差分 | 観点 | `/ultrareview` | `/harness-review` | |------|----------------|-------------------| | 実行主体 | CC ネイティブ | Harness skill (context: fork) | | セッション | single-turn | multi-step（Step 0〜4） | | Plans.md 連動 | なし | あり（cc:WIP 確認・cc:完了 更新） | | sprint-contract 検証 | なし | あり（`.claude/state/contracts/.sprint-contract.json`） | | Codex adversarial review | なし | あり（`--dual` フラグ時） | | Reviewer agent | なし | あり（`reviewer` agent、`review-result.v1` 出力） | | 出力スキーマ | 非定義 | `review-result.v1`（機械可読 JSON） | | AI Residuals スキャン | なし | あり（`scripts/review-ai-residuals.sh`） | | 修正ループ | なし | あり（REQUEST_CHANGES 時、最大 3 回） | | Security 専用モード | なし | あり（`--security`、OWASP Top 10） | | UI Rubric モード | なし | あり（`--ui-rubric`、4 軸採点） | | 対象ユーザー | ユーザーが直接 | Lead / breezing フローの自動呼び出し | ### 2.1 `claude ultrareview [target] --json` の位置づけ `claude ultrareview [target] --json` は、非対話 CI や手元 script から CC ネイティブの ad-hoc review を呼び出すための CLI 入口。 Harness では次のように扱う。 | 用途 | 判断 | |------|------| | PR CI での補助レビュー | 使用可。second-opinion として扱う | | `/harness-review --dual` の代替 | 不可。Codex adversarial review と `review-result.v1` を置き換えない | | REQUEST_CHANGES 修正ループの判定 | 不可。出力スキーマが Harness 契約ではない | | 手元で大きな差分をざっと見る | 使用可。ad-hoc review として扱う | --- ## 3. 確定方針: **(B) `/harness-review` 優先 — Harness flow 内で `/ultrareview` を呼ばない** ### 3.1 rationale **維持する規律との整合**: `.claude/rules/claude-5-prompt-standard.md` は 「`/ultrareview` は呼び出し側の review entrypoint。agent 定義側では `review-result.v1` を契約にする」 と定めている。Harness の Reviewer agent・harness-review skill は `review-result.v1` を出力契約とする。 `/ultrareview` をその内部で呼ぶことは、`review-result.v1` の機械可読保証を失わせる。 **スキーマ不一致**: `/ultrareview` の出力は CC 内部形式であり、 `review-result.v1` の `verdict`, `critical_issues`, `major_issues` フィールドを含まない。 Harness の修正ループ・commit guard・sprint-contract 検証はすべて `review-result.v1` に依存しており、 スキーマ変換のオーバーヘッドを正当化できるメリットがない。 **責務の分離**: `/ultrareview` はユーザーがアドホックに CC へ要求する entrypoint。 Harness flow 内の自動レビューは `reviewer` agent（`review-result.v1`）と `codex-companion.sh review` がカバーする。両者は用途が異なり並立で問題ない。 **フォールバックの安全性**: `codex-companion.sh review` が利用不可の場合は `reviewer` agent（static / runtime / browser profile）にフォールバックする。 `/ultrareview` を追加するとフォールバックパスが増えてデバッグが困難になる。 ### 3.2 使い分けガイド | シーン | 推奨コマンド | |--------|------------| | PR マージ前の総合確認（Harness 外） | `/ultrareview` | | CI での補助的 second-opinion | `claude ultrareview [target] --json` | | Harness Plan→Work 後の自動レビュー | `/harness-review`（自動呼び出し） | | Codex セカンドオピニオン付きレビュー | `/harness-review --dual` | | セキュリティ集中監査 | `/harness-review --security` | | UI 品質採点 | `/harness-review --ui-rubric` | --- ## 4. 今後の対応 - `/ultrareview` は CC built-in として成熟した段階で再評価する（次回評価 Phase: 45 以降） - Harness 内で `/ultrareview` を呼ぶ場合は、`review-result.v1` へのスキーマ変換レイヤーが `scripts/codex-companion.sh` に実装されてからとする（現時点では未実装） - 方針変更は `.claude/rules/claude-5-prompt-standard.md`（維持する規律 5）の改訂と同時に行う --- *決定: Phase 44.8.1 / 2026-04-18*