メインコンテンツまでスキップ

Human Judgment Focus(人間の判断に集中する)

River Review は、人間のレビューを AI で置き換えるためのツールではありません。チームの判断基準を versioned skill として実行し、人間が本当に見るべき判断に集中できる状態を作るためのフレームワークです。

「レビューがある」と「理解が共有されている」は違う

コードレビューは、実装差分を確認するだけでは、システム理解や設計意図の共有を保証できません。差分は「何が変わったか」を示しますが、「なぜその変更が妥当か」「既存の設計判断と整合するか」までは、差分だけからは読み取れません。

一方で、すべての PR に対して人間が全文脈を毎回同期する運用には限界があります。

  • レビュアーの認知負荷が高い
  • レビュー待ちによるリードタイムの増加が起きる
  • レビュー観点がレビュアー個人に属人化する
  • 毎回ゼロから文脈を読み直すコストが発生する

River Review は、この負荷を下げつつ、人間が高リスクな判断へ集中できる状態を作ります。

River Review が削減するもの / 置き換えないもの

River Review の目的は、人間の判断を置き換えることではなく、人間の判断を高リスク領域に集中させることです。

区分内容
River Review が削減するもの無差別な人間同期 / 差分だけの表層レビュー / レビュー観点の属人化 / 毎回ゼロから文脈を読むレビュー負荷
River Review が置き換えないもの最終責任 / 設計判断 / 業務妥当性 / 重大なセキュリティ判断 / 不可逆な変更の承認判断

River Review は判断材料を増やす仕組みであり、責任を委譲する仕組みではありません。最終的な承認と責任は、常に人間のレビュアーが担います。

リスク別レビュー配分

レビューの重みは、変更のリスクに応じて配分します。低リスクな変更は River Review の skill に寄せ、高リスクな変更ほど人間の判断を厚くします。

RiskRiver Review に寄せるもの人間が重点的に見るもの
Lowlint / format / naming / docs / 単純なリファクタリング例外的な判断のみ
Mediumplan-diff の整合 / tests / migration ポリシー / API contract設計意図・影響範囲
Highauth / 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)は人間の判断を支援するものであり、判断そのものを肩代わりするものではありません。

関連ページ