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

上流、中流、下流

River Review は、ソフトウェアデリバリーの自然な流れを反映しています。

  • Upstream(上流): アイデア、要件、設計上の決定。チェックは明確さ、トレーサビリティ、および実現可能性に焦点を当てる。
  • Midstream(中流): 実装とリファクタリング。チェックは正しさ、コードの健全性、および変更が上流の計画と整合しているかどうかに焦点を当てる。
  • Downstream(下流): テスト、リリースの準備完了状態、可観測性。チェックは検証、回復力、およびユーザーへの影響に焦点を当てる。

各スキルはそのフェーズを宣言するため、ランナーは変更に関連するガイダンスのみを読み込むことができる。迷った場合は、フィードバックを迅速に保つために、問題を検出できる最も早いフェーズを選択する。

これら 3 つのフェーズは、SDLC の流れを表す軸にあたり、プロダクトの 3 主軸(capability pack / Skill Registry / review team)とは区別する。3 主軸はどのフェーズにも適用できる。Skill Registry の観点別スキルが各フェーズへ配られ、review team がそれを capability pack として動かす。review team は agents/river-review.mdsrc/lib/reviewer-orchestrator.mjs の観点別レビュアーロールを並列実行し、結果を connected-components でマージする。

なお、いずれのフェーズでも River Review の役割は レビュー(問題点・リスク・不足情報の指摘)にとどまる。findings と verdict は判定素材であり、進行を 止める / 通す 判定は PlanGate と人間(HITL)が担う。その判定はリスク階層で配分される(崖=人間承認必須/丘=期限付き観測/原っぱ=自律収束と事後監査)。