PlanGate

Product Demo Script: PlanGate

Status: Stable Review cadence: Monthly Owner: Product / Maintainer

事前準備

デモ実施前に以下を確認してください。

PlanGate が設定済みのリポジトリが手元にある（またははじめるで作成）
docs/working/ 配下に TASK ディレクトリのサンプルが 1 件以上ある
Claude Code CLI が起動できる状態である
bin/plangate doctor が実行できる

サンプルがない場合は、デモ前に ultra-light モードで 1 タスクを実行しておくことを推奨します。

目的

このドキュメントは、PlanGate の価値をデモで説明するためのスクリプトである。

対象は PM / PO / EM / CTO / Developer。説明よりも、実際の流れを見せることで PlanGate の価値を伝える。

Demo goal

このデモで伝えることは 1 つである。

AI がコードを書く前に、必ず「何を作るか」「どう検証するか」が残る。

補足として、ai-loop を使う場合は PR 作成後の CI / review repair が MERGE_READY まで収束し、最終判断と merge は人間が担うことも説明する。

Demo story

AI に小さな PBI を渡す。

AI はすぐにコードを書かない。まず plan、todo、test-cases を作る。

標準フローでは、人間が C-3 で承認するまで、AI は production code を編集できない。

承認後、AI は実装し、検証し、handoff を残す。

ai-loop を使う eligible run では、C-3’ による AI 裁定と PR 後の delivery loop により、CI / review repair を MERGE_READY まで収束させる。ただし C-4 / merge は Human-owned のままである。

これにより、AI 開発が単なる自動実装ではなく、計画・承認・検証・引き継ぎ・delivery convergence を持つプロダクトデリバリーになる。

5-minute demo

Step 1: PBI を入力する

docs/working/TASK-XXXX/pbi-input.md

伝えるポイント:

入口は PBI
実装指示ではなく、価値・受入条件を含む作業単位
PM / PO が責任を持つ情報と接続する

Step 2: AI が planning artifacts を作る

docs/working/TASK-XXXX/plan.md
docs/working/TASK-XXXX/todo.md
docs/working/TASK-XXXX/test-cases.md

伝えるポイント:

PBI の理解が plan として外化される
Done の条件が test-cases として実装前に固定される
実装前にレビューできる

Step 3: C-3 approval を見せる

docs/working/TASK-XXXX/approvals/c3.json
bin/plangate render TASK-XXXX --html
bin/plangate approve TASK-XXXX

伝えるポイント:

No approved plan, no code
人間の判断点が実装前にある
render --html で C-3 レビューを見せやすくできる
approve で人間ワンアクションの C-3 承認ができる
速さよりも、正しい方向に進むことを優先する

Step 4: 実装する

git diff

伝えるポイント:

AI は自由に広げるのではなく、承認済み plan に沿って進める
scope discipline が働く
PR レビュー前に実装の根拠がある

Step 5: 検証する

docs/working/TASK-XXXX/verification.md
docs/working/TASK-XXXX/evidence/

伝えるポイント:

verification honesty
V-1 first pass / fix loop
Done を雰囲気で判断しない

Step 6: C-4 review と handoff

docs/working/TASK-XXXX/approvals/c4.json
docs/working/TASK-XXXX/handoff.md

伝えるポイント:

実装後の人間判断点がある
後続 PBI へ引き継げる
AI の作業がブラックボックスにならない

15-minute demo

5-minute demo に加えて、以下を見せる。

Hook enforcement

見せる内容:

C-3 承認前に production code を編集しようとすると警告 / block される
plan_hash がズレると検知される
test-cases / evidence がない場合に警告される

伝えるポイント:

PlanGate は単なるルール文書ではなく、破ってはいけない条件を runtime / hook 側に寄せます。

Eval / Metrics

見せる内容（実装済み、v8.6.0）:

bin/plangate eval
bin/plangate metrics TASK-XXXX --collect
bin/plangate metrics TASK-XXXX --report
bin/plangate metrics --report --aggregate

伝えるポイント:

感覚ではなく、eval と metrics で改善する
C-3 / V-1 / C-4 / hook violation を機械的に集計できる
metrics log は public repo にコミットしない設計（metrics-privacy.md）
baseline (eval-baselines/2026-05-04-baseline.md) と差分比較可能
PlanGate 自体もハーネス製品として改善する

Keep Rate (実装済み, v8.8.0)

見せる内容（v8.8.0 / #198 で実装済み）:

Code Keep Rate
Plan Keep Rate
Acceptance Keep Rate
Handoff Keep Rate

伝えるポイント:

PlanGate は、AI が何を生成したかではなく、何が採用され残ったかを重視します。

ai-loop Delivery / MERGE_READY

見せる内容（advanced demo）:

PR_CREATED
→ CI / review repair loop
→ MERGE_READY
→ Human C-4 / merge

伝えるポイント:

ai-dev は PR 作成までを担う
ai-loop Delivery は PR 作成後の CI / review repair を MERGE_READY まで収束させる
AI の終点は MERGE_READY であり、MERGED ではない
C-4 / merge は Human-owned のまま固定される
自動化の強化と承認境界の維持は両立する

Audience-specific emphasis

Audience	Emphasize
PM	リリース判断、リスク管理、証跡
PO	PBI、受入条件、Done の定義
EM	チーム標準、レビュー負荷、手戻り削減
CTO	AI 導入の統制、監査可能性、再現性
Developer	実装前の方針確認、レビューしやすさ、検証証拠

Demo closing

PlanGate は AI の速度を否定しません。
AI が速く動く前に、何を作るか、なぜ作るか、どう検証するかを固定します。
PR 作成後も、CI とレビュー指摘への対応を MERGE_READY まで収束させます。
ただし、最後に採用するか、merge するかは人間が判断します。
だから AI 開発を、速いだけでなく、説明可能で、検証可能で、チームで運用可能なものにできます。

PlanGate

Product Demo Script: PlanGate

事前準備

目的

Demo goal

Demo story

5-minute demo

Step 1: PBI を入力する

Step 2: AI が planning artifacts を作る

Step 3: C-3 approval を見せる

Step 4: 実装する

Step 5: 検証する

Step 6: C-4 review と handoff

15-minute demo

Hook enforcement

Eval / Metrics

Keep Rate (実装済み, v8.8.0)

ai-loop Delivery / MERGE_READY

Audience-specific emphasis

Demo closing

Demo checklist

関連ページ