PlanGate

review-feedback-loop — レビュー指摘の事前チェック還元閉ループ

適用ドメイン（Phase 1）: ①plangate 本体 = docs/workflows/ai-loop/ 配下のみ（dogfooding 域・本番フロー WF-00〜07 非適用） ②導入先リポジトリ = ho-paths 確定 + LoopSpec scope.allowed_paths 宣言を前提に適用可 位置づけ: L4 学習層（concept.md §7）の PoC 定義。 フル実装は Phase 4、本ドキュメントはフロー定義と手動運用（human-operated L4）を先行させる

1. 目的

PR レビューで受けた指摘を観点として抽出・還元し、次の PR 時には同型の指摘が 事前チェック（diff-audit / readiness gate / detect フェーズ）で捕捉されている 状態をつくる閉ループを定義する。

真指摘の昇格（gate 観点への反映）と誤検知抑制（レビューボットの false-positive を抑制する経路）の両方向が L4 の対象である。PoC 段階では誤検知抑制は 定義のみに留め、実装は Phase 4 以降のスコープとする。

本ドキュメントは adaptive-production-loop.md の 6 層モデルにおける Remember と Optimize の実体を扱う。

1.1 Remember / Optimize の責務分離

本ループは「記録」と「改善」を混同しない。

層 本ドキュメント上の責務 例
Remember レビュー指摘・判断・反証・効果を保存する 指摘 ID、severity、採用/不採用理由、suppression、効果測定
Optimize 保存された事実を次回の振る舞いへ反映する diff-audit 更新、readiness gate 更新、suppression 追加、scheduling policy 調整

禁止事項:

2. 6 ステップフロー

[1] 収集 → [2] 分類 → [3] 還元先判定 → [4] 反映 → [5] 事前適用 → [6] 効果測定
                                                                      │
                                                    再発検出 ─────────┘
                                                  （§2-1 へ戻る）
ステップ 6 層モデル上の位置づけ
収集 Remember
分類 Remember
還元先判定 Evaluate / Schedule
反映 Optimize
事前適用 Recurse
効果測定 Evaluate / Remember

2-1. 収集

PR レビュー指摘（外部ボット・人間レビュアー）を指摘 ID（R-NNN 方式）付きで 収集する。ID 採番と追記専用集約の方式は working-context.md の review-external.md 節（C-2 指摘の差分管理）を資産として継承する。指摘ゼロの 回でも「指摘なし」を明示記録し、監査の連続性を保つ。

2-2. 分類

各指摘を以下の 2 軸で分類する。

軸 値 説明
再発性 再発性あり / 一過性 同型の指摘が将来の変更でも起こり得るか
severity critical / major / minor / info review-principles.md §3 の 4 段階定義に従う

注（severity の別軸性）: ここでの severity は PR レビュー指摘の分類であり review-principles.md §3（info を含む 4 段階）に従う。 W チェック不一致の severity 分類（flow-detect.md §3.2、low を含む 4 段階）とは 別軸であり、値域も異なる。混同しないこと。

一過性（案件固有の一度きりの指摘）は還元不要（§2-3 の第4分岐）に落ちる。

2-3. 還元先判定

分類結果を以下の 4 分岐表で還元先へ振り分ける。

還元先 対象 責務
skill（例: diff-audit） 作業手順・チェックリストで捕捉できる指摘 AI-owned（編集可）
gate 観点ドキュメント（例: plan-review-readiness-gate.md） 計画・レビュー観点で捕捉できる指摘 AI-owned（編集可）
policy auto-approve 条件・裁定ルールに関わる指摘 Human-owned 固定（第0の承認境界 = arbiter-policy.md §6）
還元不要 一過性・案件固有 記録のみ

policy への還元候補は AI が draft 提案までしか行えない。発行・適用は Human-owned 固定であり、本ステップでもその境界は緩和しない（§5 参照）。

2-4. 反映

還元先判定に基づき、還元 PR を作成する。反映結果はトレーサビリティ表として 残す。

指摘 ID 還元先 commit
R-NNN <skill or gate doc path> <commit SHA>

2-5. 事前適用

次回 flow フェーズ前の pre-check（diff-audit / readiness gate）で、還元した観点が 実際に効いていることを確認する。

2-6. 効果測定

次回 PR レビューで同型指摘の再発有無を確認する。再発した場合は還元が 不十分であったシグナルとして扱い、§2-1（収集）へ戻り再度ループを回す。

3. W チェックとの接続

Model C/D の裁定結果（flow-detect.md §3.3）は provenance 経由で L4 学習の入力になる。人間の事後 reject （decision-table.md CB-1）も学習入力として扱う。 いずれも「二重判定・事後監督で得られた裁定結果を、次回の事前チェックへ 還元する」という本ループの入力源の一種である。

4. ケーススタディ（2026-07-01〜02 の手動実演）

本フローは issue #667 の起票に先立ち、以下の 3 件のレビュー指摘還元で 手動で 1 周回った実績があり、その再現可能化が本ドキュメントの目的である。

レビュー指摘 還元先 結果
PR #662 G1〜G4 / C1〜C5（用語・定義・参照） plan-review-readiness-gate.md §7 D-1〜D-5（PR #663。当時の節番号は §8） マージ済
PR #665 R-1〜R-3（助詞・冗長・リンク化） diff-audit（旧 self-review）スキル Phase 13 文章品質（PR #666） レビュー中（2026-07-02 時点）
PR #666 指摘 2 件（glob 表記・バックティック） 即時反映（同 PR 内） 反映済

さらに 2026-07-02 のセッション振り返り（3 系統レビュー: セルフ / 複数エージェント / Codex）で検出された指摘 7 件を issue #670 で還元しており、本ループの 2 周目に相当する。

5. 登録済み suppression（誤検知抑制）

§1 の誤検知抑制経路の実体。ボットレビューの誤指摘パターンを機械反証つきで 登録し、同型指摘の再対応コストを削減する（採否判断時に本表を参照し、 該当すれば反証根拠を引用して不採用とする）。登録は追記専用。

# 誤指摘パターン 出現実績 機械反証
S-1 「.claude/rules/ は gitignore 対象でコミットされない（リンク切れになる）」 4 回（PR #680） git ls-files .claude/rules/ で追跡済みと確認可能。本リポジトリでは L0 契約の正本（plugin/plangate/rules/ は配布用 export 版）
S-2 「docs/working/discussions/ の討議ログを関連ドキュメント節にリンクすべき」 7 回（PR #662 ×5・#669 ×2） ai-loop 正式ドキュメント（docs/ai/ai-loop/・docs/workflows/ai-loop/）は討議ログを参照しない方針（PR #662 対応時に確定し、当該ドキュメント内の参照 11 箇所を正式ドキュメント参照へ置換済み）。本 suppression の適用範囲も ai-loop ドキュメントに限る（README・roadmap 等の他領域の既存参照はスコープ外）

6. 安全制約

7. 関連ドキュメント

This site is open source. Improve this page.