Human Judgment Focus(人間の判断に集中する)
River Review は、人間のレビューを AI で置き換えるためのツールではありません。チームの判断基準を versioned skill として実行し、人間が本当に見るべき判断に集中できる状態を作るためのフレームワークです。
「レビューがある」と「理解が共有されている」は違う
コードレビューは、実装差分を確認するだけでは、システム理解や設計意図の共有を保証できません。差分は「何が変わったか」を示しますが、「なぜその変更が妥当か」「既存の設計判断と整合するか」までは、差分だけからは読み取れません。
一方で、すべての PR に対して人間が全文脈を毎回同期する運用には限界があります。
- レビュアーの認知負荷が高い
- レビュー待ちによるリードタイムの増加が起きる
- レビュー観点がレビュアー個人に属人化する
- 毎回ゼロから文脈を読み直すコストが発生する
River Review は、この負荷を下げつつ、人間が高リスクな判断へ集中できる状態を作ります。
River Review が削減するもの / 置き換えないもの
River Review の目的は、人間の判断を置き換えることではなく、人間の判断を高リスク領域に集中させることです。
| 区分 | 内容 |
|---|---|
| River Review が削減するもの | 無差別な人間同期 / 差分だけの表層レビュー / レビュー観点の属人化 / 毎回ゼロから文脈を読むレビュー負荷 |
| River Review が置き換えないもの | 最終責任 / 設計判断 / 業務妥当性 / 重大なセキュリティ判断 / 不可逆な変更の承認判断 |
River Review は判断材料を増やす仕組みであり、責任を委譲する仕組みではありません。最終的な承認と責任は、常に人間のレビュアーが担います。
リスク別レビュー配分
レビューの重みは、変更のリスクに応じて配分します。低リスクな変更は River Review の skill に寄せ、高リスクな変更ほど人間の判断を厚くします。
| Risk | River Review に寄せるもの | 人間が重点的に見るもの |
|---|---|---|
| Low | lint / format / naming / docs / 単純なリファクタリング | 例外的な判断のみ |
| Medium | plan-diff の整合 / tests / migration ポリシー / API contract | 設計意図・影響範囲 |
| High | auth / payment / 個人データ / security boundary / 不可逆な migration の検出 | 最終判断と責任ある承認 |
High リスク領域では、River Review は「検出と判断材料の提示」までを担い、「通す / 止める」の最終判断は人間が行います。
ユースケース
River Review は、繰り返し発生するレビュー同期を減らし、人間レビュアーを高リスクな判断に集中させます。
- Plan Review — 実装前に、要件・設計・計画の危険な抜け漏れを検出する
- Diff Review — 実装差分が計画・設計・テスト方針と整合しているか確認する
- Test Review — テストが仕様・リスクに対して十分か確認する
- Review Comment Review — 既存の AI レビューや人間レビューコメントが妥当か再確認する(W チェック)
AI レビューを過信しない
River Review は判断材料を増やしますが、人間承認の完全な代替ではありません。次の領域では、人間判断を必須とします。
- セキュリティ境界・認証認可
- 個人情報・課金・データ移行
- 不可逆な変更
これらのリスク領域で AI レビューの結果のみを根拠にマージすることは避けてください。River Review の verdict(merge-ready / human-review / block)は人間の判断を支援するものであり、判断そのものを肩代わりするものではありません。
関連ページ
- River Review とは — コンセプトの全体像
- 設計哲学 — 設計思想の詳細
- レビュー対象と使いどころ — レビュー対象の整理
- W チェック(二重レビュー)ガイド — 既存レビュー結果の再点検