[P0][EPIC] ai-loop vNext — ai-dev統合・C-3’・Merge-ready・Evolution Loopを一つの実行契約へ接続する

[s977043]

背景

PlanGate には、以下の設計資産がすでに存在する。

• ai-dev-workflow: Plan Package 作成、C-1/C-2/C-3、exec、verify、PR 作成
• ai-loop-workflow: C-3'、CI / AI review 対応、merge-ready、Remember / Optimize
• feat: Plan作成とPR前セルフレビューにUnknown Discoveryを取り込む #810: Unknown-aware Plan / PR 前レビュー
• feat: Memory Promotion Gate を導入し、経験のルール・Skill・Hook化を審査する #811: Memory Promotion Gate
• 継続的リファクタリングを「知識差分の同期」としてPlan/実行ゲートへ導入する #867: Knowledge Delta / 安全なリファクタリング
• サブエージェント委譲に model × effort × role の明示的ルーティングを導入する #868: model × effort × role routing
• feat: ai-loopへSession / Run Retrospective駆動のハーネス改善サイクルを統合する #869: 複数 Run からの harness evolution

一方、実行入口は LoopSpec から始まり、ai-dev plan、Plan Package、C-3'、ai-dev exec、PR 後の収束、外側の改善 Loop が一つの実行契約として接続されていない。

本 Epic は既存機能を再実装せず、この接続 gap を解消する。

統合定義

PlanGate は共通の開発統制基盤である。ai-dev は高品質な Plan Package を作成して実装・検証し、PR を作成する。ai-loop は ai-dev を内包して自律制御し、C-3'、CI、レビュー、修正反復によって PR を merge-ready へ収束させる。さらに完了 Run の証跡から改善候補を作り、Skill / Flow / Gate / Test の改善 PRを評価可能な形で作成する。

短縮表現:

ai-dev は PR を作る。ai-loop は PR を完成させ、次の開発をより良くする。

責務境界

レイヤー	責務	AI 責務の終点
PlanGate Core	artifact / gate / validation / evidence / stop rule	実行プロファイルへ提供
ai-dev	PBI → Plan → C-1/C-2/C-3 → exec / verify → PR	PR_CREATED
ai-loop Delivery	C-3' → CI / review / repair	MERGE_READY
ai-loop Evolution	completed runs → candidate → experiment → improvement PR	改善 PR の MERGE_READY
Human	例外 C-3、HO / policy / first principles、C-4 / merge	MERGED

Scope

1. ai-dev / ai-loop の恒久定義と Phase 1 PoC 制約を分離する
2. ai-loop run TASK-XXXX を Plan-first orchestration へ接続する
3. C-3' を同一 Plan Package / source SHA / review evidence へ束縛する
4. C-3' の承認を ai-dev exec が消費できる正式 artifact にする
5. PR 後の CI / review / repair を再開可能な状態機械にする
6. Delivery Run の証跡を feat: ai-loopへSession / Run Retrospective駆動のハーネス改善サイクルを統合する #869 と feat: Memory Promotion Gate を導入し、経験のルール・Skill・Hook化を審査する #811 へ接続する
7. 改善は別 TASK / Plan / PR とし、active run の harness を自己変更しない

Child Issues / 実装順序

• [P0] ai-dev / ai-loopの正本定義を統合し、PoC制約と恒久契約を分離する #871 正本定義統合・PoC制約分離
• [P0] ai-loop runをPlan-firstへ接続し、C-3’をPlan Packageのhashとevidenceへ束縛する #872 Plan-first orchestration・C-3' artifact binding
• [P0] PR作成後のCI・レビュー対応をMERGE_READY状態機械として実装する #873 PR convergence / MERGE_READY state machine
• [P1] ai-loop Run Evidence契約を統一し、Evolution LoopとPromotion Gateへ接続する #874 Run Evidence・Evolution / Promotion接続

推奨順序:

1. #871で責務と状態語彙を固定
2. #872と#873を契約合意後に並行実装
3. #874でDelivery evidenceを外側Loopへ接続
4. #870のE2Eを実走し、全evidenceを集約

#874のlimited canary開始前に、少なくとも#861、#862、#866の安全性・正本性が解消されていること。導入先pluginでのE2E完了には#863のcapability / degradation契約を確認すること。

既存 Issue との関係

Issue	本 Epic での扱い
#810	Plan / C-1 / PR 前 review の共通品質資産として再利用
#811	improvement candidate の promotion sub-gate として再利用
#861	自律テスト実行の安全性に関する前提
#862 / #866	Skill 正本・同期・drift 検出の前提
#863	導入先 capability preflight / graceful degradation
#867	条件付き Plan 品質拡張として継承
#868	routing decision / verifier 独立性 / outcome metadata として継承
#869	外側の Evolution Loop として再利用

Non-goals

• AI に merge 権限を与えること
• policy / HO / C-4 / first principles を AI が自己変更すること
• ai-loop 用に Plan / exec / verify を別実装すること
• raw session transcript、hidden CoT、secret を学習資産として保存すること
• 現行 lite / boundary policy を本 Epic だけで無条件に拡大すること

Definition of Done

• ai-dev / ai-loop / PlanGate Core / Delivery Loop / Evolution Loop の正本と責務境界が一意である
• artifact がない状態から ai-loop run TASK-XXXX を開始し、pbi-input.md、plan.md、todo.md、test-cases.md、C-1、C-2 が揃う
• C-3' は同一 Plan Package の hash、source SHA、C-1/C-2 evidence を検証し、文字列だけの PASS では承認できない
• C-3' AUTO_APPROVED artifact を変更なしで ai-dev exec が検証・消費できる
• Plan または source SHA が変わると C-3' が stale となり、再裁定なしに exec できない
• PR 作成後、最新 head SHA に対する CI / review / conflict を確認し、修正後に再評価できる
• MERGE_READY は CI green、必須 review 着弾・全件対応、未解決 blocking thread なし、conflict なし、Plan 逸脱なしの AND でのみ成立する
• round 上限、判定不能、権限不足、HO 接触は HUMAN_ESCALATED または BLOCKED へ fail closed する
• completed run から正規化 evidence を生成し、feat: ai-loopへSession / Run Retrospective駆動のハーネス改善サイクルを統合する #869 の candidate generation と feat: Memory Promotion Gate を導入し、経験のルール・Skill・Hook化を審査する #811 の promotion decision へ追跡できる
• improvement は baseline / candidate の paired evaluation、独立 grader、activation check、rollback を持つ
• active run は開始時の harness_version を最後まで保持し、自分の実行規則を途中変更しない
• light 正常系、Plan drift、C-3' 不一致、CI failure、review repair、round limit、evolution candidate の E2E fixture が CI で通る
• C-4 と merge は Human-owned のまま、自動 merge 経路が存在しない

Close 条件

次をすべて満たした場合のみ completed で close する。

1. 本 Epic の child Issue がすべて close されている
2. 上記 DoD がすべて checked で、各項目に PR / commit / test log の evidence link がある
3. 一つの代表 TASK で Request → Plan Package → C-3' → exec → PR → CI/review repair → MERGE_READY の E2E 実走記録がある
4. 一つの複数 Run fixture で evidence → candidate → experiment → promotion decision の外側 Loop が再現できる
5. docs の記述だけでなく、CLI / schema / tests による機械検証が存在する

部分実装、設計文書のみ、手動実演のみでは close しない。