plangate

PlanGate

「承認なし、コードなし」― AI コーディングエージェントのためのゲート型ワークフロー
English: A lightweight governance harness for safe AI coding agents.

PlanGate は、AI コーディングエージェントのためのガバナンス優先ワークフローハーネスです。 人間が承認した計画・タスク・受入テストが揃うまで、AI にプロダクションコードを書かせません。 計画の精度が実装品質を方向づけ、承認ゲートと検証がその品質を実装まで漏らさず着地させます（品質は計画で生まれ、後段で保全される）。

一般的なエージェントフレームワークが「自律性」を重視するのに対し、PlanGate は 承認境界・監査可能性・スクラム親和性 を重視します。

新規利用者: 最初に読む 3 ページ

PlanGate を初めて知った方は、以下の順に 15-30 分 で読むことを推奨します。

1. PlanGate ガイド — 全体像・5 フェーズ・解決する問題（約 5 分）
2. 段階的導入ガイド (Phase 0 = 正本) — Level 1 (Day 1) から始める 30 分初回体験の正本（約 10 分）
3. 10 分チュートリアル（本 README 後半） — 実際に手を動かす 短縮版（約 10 分、正本 #2 への導線）

「自分のチームに合うか」を判断したい方は 思想と問題設定 と When NOT to use を参照。略号 (EH-X / WF-XX / V-X / C-X) は 用語クイックリファレンス を参照。

PlanGate の本質的価値

PlanGate が配布するのは 「AI 開発の安全な型」 です。AI に何でも自動でやらせる枠組みではありません。

PlanGate がやること	PlanGate がやらないこと
計画 → 承認 → 実装 → 検証 → 引き継ぎの型を提供する	AI に勝手に skill / プロンプトを書き換えさせる
C-3 / C-4 / V-1〜V-4 で人間の判断点を固定する	自律エージェントを目指す
失敗・成功を後から説明可能にする（観測・再現基盤）	全実行ログを完璧に再現する durable engine になる
段階的に採用できる導入レベル（Level 1〜5）を提供する	全機能を最初から強制する
Markdown ベースで認知負荷を抑える	SaaS / 外部 store を前提にする

設計の中心: 観測 (Steering Loop) ではなく 評価 → 学習 → ガバナンス。 ここでいう Steering Loop とは「events.ndjson に全制御点を残し、後から replay 可能にする観測ループ」のこと。これは自己進化の「基盤」であって「中心」ではありません。 詳細: docs/philosophy.md §「自己進化フレームの設計判断」 / docs/working/discussions/（Claude × Codex × Gemini の 5 ディスカッションログ）

段階的導入レベル

PlanGate は すべての機能を最初から使う必要はありません。次の 5 段階で必要な分だけ採用できます。

Level	スコープ	適用シーン
Level 1	plan 承認だけ	AI に実装させる前に計画を承認したい
Level 2	+ handoff まで	完了時の引き継ぎを標準化したい
Level 3	+ hooks / validate	scope / approval / evidence の不変条件を hook で強制したい
Level 4	+ metrics / outcome review	改善判断を計測ベースで行いたい（自己進化軸はここから実質開始）
Level 5	+ eval / timeline	dogfooding eval、experimental timeline などの上級機能

初回利用者は Level 1 から始める ことを推奨します。Level 4 以降は経験を積んでから検討してください。 詳細ガイド: 段階的導入ガイド（v8.7.0 でリリース済）

flowchart LR
    L1["Level 1<br/>plan 承認"] --> L2["Level 2<br/>+ handoff"]
    L2 --> L3["Level 3<br/>+ hooks/validate"]
    L3 --> L4["Level 4<br/>+ metrics/outcome review<br/><b>自己進化はここから</b>"]
    L4 --> L5["Level 5<br/>+ eval/timeline<br/><i>experimental</i>"]
    style L1 fill:#e1f5e1
    style L2 fill:#d4edda
    style L3 fill:#c3e6cb
    style L4 fill:#ffeaa7
    style L5 fill:#ffd6a5

画像更新について: 既存の docs/assets/harness-plangate-readme-dark-v2.png は v7〜v8.6 期の overview で、現時点でも有効です。v8.7.0 でリリースした段階的導入レベルと自己進化フレームを反映した新画像は、デザイン作業として別途検討します（実装フェーズ外）。

最新状態

PlanGate は v8.10.0（Latest）で、Hook enforcement・Metrics v1・Harness Improvement Governance の上に Reporting & Retrospective v1 を載せ、events.ndjson から sprint retrospective を決定論的に導出できるガバナンスハーネスへ到達しました。これにより EPIC #193 Harness Improvement Roadmap は 完遂（CLOSED / COMPLETED） しています。

v8.7.0〜v8.10.0 はリリース済みで、外部 OSS 利用者の 「どこまで使えばよいか不明」問題 に応える OSS 整備（段階的導入ガイド / Plugin 成熟化 / バージョニング安定性ポリシー）と、自己評価・context 分離・モデル特性対応・reporting の各基盤を順次投入しました。