PlanGate

Changelog

このページは CHANGELOG.md を リリース時に自動同期したものです(手動編集しない)。生成: scripts/sync-release-docs.sh

PlanGate の主要リリース履歴。

このファイルは各リリース時点の内容を記録するものであり、この pull request の差分一覧ではない。

Unreleased

v8.24.0 - 2026-10-12

feat: 計画レビューに答えられる対話 HTML とその検証器(opt-in)を追加し、ai-loop V2 の Ratchet を決定論的な scope observer へ移し、導入先 project root の案内・pre-push ガードの push 先判定・Test job の高速化(ta-61 並列化)を入れる

v8.23.0 タグ以降、main へ蓄積した変更を 1f091e97(#1565 の merge commit)まで反映する。 主題は 計画レビューの回答を機械可読に受け取る経路(opt-in)、ai-loop V2 の Ratchet を repository の実差分で判定すること、 導入先 repo での bin/plangate の使い方(#1497 の project root)に Skill / Agent / Command の案内を合わせること、 CI の Test job の短縮(ta-61 の並列化)。

(数値はいずれも 終端 1f091e97 時点の測定値であり、本リリース準備 PR 自身の commit は含まない) PlanGate 本番フロー WF-00〜07 は不変・NO MERGE BY AI/C-4・merge は Human-owned 固定。

⚠️ 更新前に必ずお読みください

対象: plangate プラグインを導入している利用者(1.)、.github/workflows/ci.yml や tests/extras/ta-61 を 取り込んでいる fork / 派生 repo(2.)、scripts/templates/pre-push.sample を .git/hooks/pre-push に入れている利用者(3.)。 hook・schema の必須項目、bin/plangate の挙動は変えていません。

1. plugin の案内文(rules / agents / commands / skills 13 ファイル)が変わります(#1512 / #1518 / #1538 / #1539 / #1561 / #1563)

/plugin update で届くのは文面の変更のみで、実行される挙動は変わりません。version bump がないと /plugin update は no-op になり 1 件も届きません(本リリースで bump する理由)。

C-3 ゲートの記述には上記の対応づけが加わりますが、bin/plangate の承認判定・plan binding・Human-owned の権限は変わりません。

2. CI の Test job で ta-61 の子プロセスが並列度 2 で走ります(#1555)

tests/extras/ta-61-extra-contract.sh が per-file の子プロセスを xargs -P で並行起動します(既定 PG_T61_PARALLEL=2、 範囲 1〜4、数値以外は 1)。各子の出力・rc は子ごとのファイルに分け、assert と加算は元の順序で逐次に行います。 子へ渡す env・stdin・timeout(180 秒)は変更前と同一です。

3. opt-in の pre-push ガードが push 先 ref で判定します(#1552 / #937)

scripts/templates/pre-push.sample は、origin への新規 remote ブランチ作成(remote SHA がゼロ)のときだけ、 pre-push の stdin から得たpush 先のブランチ名を scripts/check-branch-not-merged.sh に渡します(従来は checkout 中の HEAD を見ていた)。 check-branch-not-merged.sh は同名ブランチの MERGED 履歴の有無を gh pr list --state merged --limit 1 で確認するように変わり、 従来の state=all 先頭 1 件依存による見逃しを直しました。1 つでも危険な ref があれば push 全体を中止します。

利用者への影響: 新しい hook を入れた環境では、merge 済みで remote から削除された destination ref の再作成 (例: git push origin HEAD:refs/heads/<merge 済みのブランチ名> や、同名ブランチでの作業の再 push)が block されます。 従来は checkout 中の HEAD の名前で判定していたため、refspec で別名を指定した push は素通りしていました。 意図して同名ブランチを作り直す場合は、別のブランチ名で push してください。

計画レビューの対話フィードバック(opt-in)

ai-loop V2

設計・方針・運用(docs のみ)

テストと検査

既知の課題

v8.23.0 - 2026-10-07

feat: Intent Context Package v1 と Context Lifecycle を導入し、ai-loop V2 の Delivery runtime・Ratchet・Runtime Evidence を縦切りで実装し、bin/plangate の C-3 判定を共通化して既定の対象 repo を cwd の git root にする

v8.22.0 タグ以降、main へ蓄積した変更を 61d3f14b(#1499 の merge commit)まで反映する。 収録範囲は当初 4f81588f(#1494)で締めたが、tag は main の先頭(tag-main parity)に打つため、 その後に merge された #1493(13bb8875)・#1498(1b5dcdea、本節の作り直し)・#1497(3c34d2f6)・ そして #1499(61d3f14b)も本リリースに入る。2026-10-07 以降、tag まで main への merge は凍結する(Human 決定)。 なお #1495 は次リリース。 主題は Context の受け渡しを「会話の持ち越し」から「正本 artifact の参照」へ移すこと、 ai-loop V2 の runtime / Runtime Evidence を最初に動かすこと、 bin/plangate の C-3 判定を status / validate / exec で 1 本に共通化すること、 bin/plangate が導入先の repo を対象にできるようにすること(#1497)。

(数値はいずれも 基点 61d3f14b 時点の測定値であり、tag 時点の総数を約束する契約値ではない) PlanGate 本番フロー WF-00〜07 は不変・NO MERGE BY AI/C-4・merge は Human-owned 固定。

⚠️ 更新前に必ずお読みください

対象: plangate プラグインを導入している利用者(1.)、ai-loop(ai-loop-cycle skill)を 使っている利用者(2.)、plangate validate-schemas を CI 等で使っている利用者(3.)、 bin/plangate の status / validate / exec を使っている利用者(4.)、 上流 clone の bin/plangate を PATH に通し、clone の外から実行している利用者(5.)。 hook・schema の必須項目は変えていません。

1. working-context skill に「checkpoint してから fresh context で再開する」規則が加わります(#1411)

worker / agent / model / runtime を切り替えるとき、独立レビューを始めるとき、worker 間で引き継ぐとき、 外部待ちや使用量上限で意図的に中断するときは、会話履歴を持ち越さず、正本の state (plan.md / decision-log.jsonl / INDEX.md / current-state.md / evidence)を checkpoint してから 新しい context で再開します。standard 以上では必須、ultra-light / light では任意です。 あわせて context-packager skill は、raw な会話・hidden chain-of-thought・raw tool stream を package に入れないことを明記しました。

承認ゲート(C-3 / C-4)・plan binding・Human-owned の権限は変わりません。

2. ai-loop の C-3’ AUTO_APPROVED が、正本どうしの矛盾を残したままでは出なくなります(#1405 / e808c413)

plan.md に Intent-Context-ID / Intent-Context-Ref を持たせ、既存の plan_hash で意味上の Context を C-3 / C-3’ より前に束縛します。authoritative な情報源が 2 つ以上で矛盾したまま解消されていない場合、 C-3’ は AUTO_APPROVED を出さずに fail-closed で止まります。同梱の plugin/plangate/skills/ai-loop-cycle/ の scripts / references / schemas と、ai-dev-exec / ai-dev-verify の references/c3-prime-contract.md も変わります。

3. plangate validate-schemas の検証対象が増え、従来 SKIP だったファイルが検証されます(#1396 / #1405 / #1494)

検証対象のファイル名に intent-context.json / plan-contract.json / plan-deliberation.json が加わりました (scripts/schema_mapping.py。plan-deliberation.json の登録は #1494)。従来は schema マッピングが無く SKIP(exit 0) だったものが、 schema に照らして検証され、違反があれば FAIL(exit 1)になります。intent-context.json は schema に加えて 参照・provenance の意味検証(scripts/intent_context_contract.py)も通ります。 これらと同名で別の目的のファイルを docs/working/ 等に置いている場合、更新後に新たに FAIL しうるため、 CI で validate-schemas を実行している場合は更新前に plangate validate-schemas --dir <path> で確認してください。

4. status / validate / exec の C-3 判定が共通化され、不正な承認記録は fail-closed で止まります(#1481 / #1492)

C-3 の read-only 評価を 1 つの関数(_plangate_c3_evaluate)に集約し、3 コマンドで同じ判定を使います。 exec は v8.22.0 でも、legacy の c3_status が APPROVED 以外の場合と plan_hash 不一致の場合を止めていました (#1481 は gate 判定ロジックを変えず、#1492 は legacy の APPROVED / plan_hash の意味を保存します)。 exec で新たに止まるのは次の 2 点だけです(fail-closed)。

status は従来 c3.json の存在だけでフェーズを導出していましたが、実際の決定・検証結果(APPROVED 以外・ plan_hash 不一致を含む)から導出します。読めない承認記録は plangate validate へ誘導します。 exec が止まったときは stderr に次の一手(read-only)を出します(終了コードと承認権限は不変。#1481)。 minor の理由: 入出力のインターフェースは変えないが、従来通っていた壊れた承認記録が停止側に倒れる挙動変更を含むため。

5. bin/plangate の既定の対象 repo が「CLI 本体の置き場所」から「cwd の git root」に変わります(#1497 / #962)

v8.22.0 までの bin/plangate は、cwd に関係なく CLI 本体が置かれた clone の docs/working/ だけを対象にしていました。 本リリースから、対象 repo を次の順で 1 回だけ決め、すべてのサブコマンドで使います(bin/plangate の plangate_resolve_project_root)。

  1. グローバルオプション --project-root <dir>(--project-root=<dir> も可。サブコマンドより前に置く)
  2. 環境変数 PLANGATE_PROJECT_ROOT
  3. cwd の git root(git rev-parse --show-toplevel)
  4. CLI 本体の root(cwd が git 管理下にない、または git が無い場合)

--project-root / PLANGATE_PROJECT_ROOT に存在しないディレクトリを渡すと、下位の候補へ落ちずに rc=2 で止まります。 検証器・schema・scripts は従来どおり CLI 本体の root から読み、TASK・承認記録・settings など プロジェクトの状態を対象 repo から読みます。

semver の扱い: docs/ai/versioning-stability-policy.md §2.4 の 「引数・フラグの削除 / 意味変更 → major」に当たる候補でした(doctor は §3.1 で Stable)。それでも minor とした根拠 (Human 決定 2026-10-07)は次のとおりです。

Context(Intent Context / Dynamic Context Engine / Context Lifecycle)

ai-loop V2

レビューとモデル

承認境界の運用(文面)

CI・評価

テストと検査

v8.22.0 - 2026-09-23

fix: 承認境界のガードを「文字列で近似する」実装から「トークン列で判定する」実装へ作り直し、EH-3 の worktree 素通りと EH-12 の誤検知を実測で塞ぐ

v8.21.0 タグ以降に main へ蓄積した 102 コミット(実測: git rev-list --count v8.21.0..319d6121)を反映する。 主題は 承認境界ガードの判定精度。配布物(plugin/)の変更は 76 ファイル (実測: git diff --name-only v8.21.0..319d6121 -- plugin/ | wc -l)。 bin/plangate は変更ゼロ、schemas/ は review-result.schema.json の説明文 1 行のみ (実測: git diff --numstat v8.21.0..319d6121 -- bin/plangate schemas/)→ CLI / Schema の挙動は不変。 (数値はいずれも 基点 319d6121 時点の測定値であり、tag 時点の総数を約束する契約値ではない) PlanGate 本番フロー WF-00〜07 は不変・NO MERGE BY AI/C-4・merge は Human-owned 固定。

⚠️ 更新前に必ずお読みください

対象: 本リポジトリを clone して scripts/hooks/ / scripts/check-git-destructive.sh を .claude/settings.json へ配線している利用者。 これらは plugin 配布物に含まれません。 plangate プラグインを marketplace 経由で導入しているだけの場合、下記 1. と 2. は影響しません。

1. EH-3 が linked worktree 配下の Hardening Override を block するようになります(#1277)

.claude/worktrees/<name>/ のような REPO_ROOT 配下の linked worktree、および REPO_ROOT 外の worktree で、HO 12 カテゴリのファイルが block されず素通りしていました。本リポジトリでは linked worktree が 60 本以上あり、エージェントが日常的にその中で作業するため、 承認境界が最も使われる経路で外れていたことになります。

worktree 内で .claude/rules/*.md 等を編集していた運用がある場合、その編集は block されます。

2. EH-12 が破壊的でない git コマンドを block しなくなります(#1326)

git push のトークン列に属さない --force / + を拾っていたため、次のような 破壊的でないコマンドが block されていました。

git push -q origin docs/x && git worktree remove --force /tmp/w
git push origin HEAD && echo a + b
echo "use git push --force only on branches"      # 実行されない文字列
git commit -m "do not push --force to main"       # コミットメッセージ

block 対象は一切緩めていません。 実 hook を PreToolUse payload で起動した 44 ケースの対照で、 本物の破壊的操作 32 件は是正前後とも 32/32 BLOCK、非破壊 12 件が 6 件の誤 block → 0 件。

承認境界ガードの是正

承認境界の運用

配布とリリース

ai-loop V2

テストと検査

スキル

基点 319d6121 以降に main へ入った変更

上記の測定値(102 コミット / plugin 76 ファイル)は基点 319d6121 時点のもので、 この節はその後 tag 前に main へ入った分である(実測: git log --oneline 319d6121..9b9107f4 = 4 件)。 上の数値は再測定していない(運用で増える値を契約値にしないため)。

v8.21.0 (2026-08-19)

fix: 参照解決順の「構造上空振りする段」を配布物から除去し、EH-3 / EH-13 のガード迂回を封鎖。さらに sh 誤起動から gh pr merge へ到達する経路(NO MERGE BY AI の迂回)を配布物ごと塞ぐ

v8.20.0 タグ以降に main へ蓄積した 62 コミット(実測: git rev-list --count v8.20.0..375c791)を反映する。 主題は 「参照はあるが解決されない」「ガードはあるが迂回できる」構造の実測是正。 配布物(plugin/)の変更は 79 ファイル(実測: git diff --name-only v8.20.0..375c791 -- plugin/ | wc -l)で、 内訳は skill の参照解決順・正本参照の是正と、ai-loop-cycle 同梱スクリプト 30 本への sh 誤起動ガードの同期。 schemas/*.json と bin/plangate は変更ゼロ (実測: git diff --stat v8.20.0..375c791 -- schemas/ bin/ が空)→ Schema / CLI の挙動は不変。 (数値はいずれも 基点 375c791 時点の測定値であり、tag 時点の総数を約束する契約値ではない。基点の考え方は docs/working/_merge/v8.21.0-release-runbook.md §0 を参照) PlanGate 本番フロー WF-00〜07 は不変・NO MERGE BY AI/C-4・merge は Human-owned 固定。

⚠️ 更新前に必ずお読みください(block / 停止 挙動が 3 箇所で強化されます)

1. と 2. の対象: 本リポジトリを clone して scripts/hooks/ / scripts/check-approval-token-write.sh を .claude/settings.json へ配線している利用者。 これらは plugin 配布物に含まれません。 plangate プラグインを plugin marketplace 経由で導入しているだけの場合、1. と 2. は影響しません。

3. の対象はより広く、plangate プラグイン経由の導入も含みます(ai-loop-cycle skill 同梱の scripts/*.py が配布物に入るため)。NO MERGE BY AI(Iron Law)に直接関わる是正のため、 本リリースで最も重要な告知です。

  1. EH-3: Hardening Override の block が TASK 文脈でも発火するようになりました(#1089 / PR #1097)。 v8.20.0 で「既知の未解消ギャップ」として出荷した迂回(PLANGATE_HOOK_TASK を設定していると HO 判定が 一度も評価されず、9 カテゴリすべてで rc=2 → rc=0 になる)が解消されています。 PLANGATE_HOOK_TASK を設定した状態で HO 対象パス(.claude/rules/*.md / .claude/settings*.json / .claude/commands/*.md / .claude/agents/*.md / scripts/hooks/*.sh / bin/plangate / schemas/*.schema.json / .github/workflows/*.yml|yaml / AGENTS.md / CLAUDE.md)を編集していた フローは block されます(これが本来の期待挙動です)。適用済みのため、gap を受理していた tests/fixtures/eh3-known-gap-1089.flag は削除されています(scripts/apply-eh3-ho-always.sh は適用後も repo に残りますが、再実行は不要です)。
  2. EH-13: 承認トークン書き込みガードの迂回 2 クラスを封鎖しました(#1115 / PR #1148、#1110 / PR #1121)。 外側ゲートがコマンド文字列をリテラル照合していたため、保護対象のファイル名にワイルドカードを 混ぜると照合が外れ、実測で 21 コマンド(cp / mv / tee / sed -i / git restore / python・node・ruby の書き込みを含む)が rc=0 で素通りしていました。照合方向を反転し、 (A) approvals 配下でファイル名が glob (B) basename が先頭 glob でなく保護 basename にパターン一致、 の 2 条件に絞って block します(無条件 block は日常の glob コマンドまで落とすため)。 この 2 条件で塞がるのは実測 21 件中 18 件で、node -e "…writeFileSync(…)" / ruby -e "File.write(…)" / python3 -c "open(…,'w')" の 3 件は是正後も rc=0 のまま残存します (実測: docs/working/TASK-1115/evidence/lane-scan.txt の v2 列)。残存クラスと follow-up 候補は docs/working/TASK-1115/plan.md §残存クラス を参照してください。あわせてリダイレクト判定を「先と保護パスの相関」で行うようにし、 コミットメッセージにパス名を書きつつ無関係な出力を /tmp へ流すだけのコマンドが block される 誤検出(#1110)を解消しました。判定不能なケースは従来どおり block 側に倒します(fail-closed 不変)。

  3. sh 誤起動で gh pr merge / gh pr review --approve が実際に走る経路を封鎖しました(#1169 / PR #1187)。 sh scripts/ai-loop/gh_exec.py のように python3 以外のシェルで .py を起動すると、sh が module docstring 全体を二重引用符文字列として読むため docstring 内のバッククォートがコマンド置換として評価され、 中身のコマンドが実行されていました。scripts/ai-loop/ には gh / git を実行する唯一の境界(gh_exec.py)が 含まれるため、隔離した stub サンドボックス(PATH に記録用 stub のみ・空 cwd)で 30 本を sh 起動した実測で gh 12 回 + git 3 回が発火し、その中に gh pr merge / gh pr review --approve / gh pr close が 含まれていました(gh_exec.py 単体で gh 6 回)。v8.20.0 以前の配布物にはこの経路が残っています。 是正後は同じ実測で発火 0 件。scripts/ai-loop/ 30 本と、その配布ミラー plugin/plangate/skills/ai-loop-cycle/scripts/ 30 本に polyglot ガード(PG-SH-GUARD)を入れ、 sh / bash / zsh 起動時は何も評価する前に診断メッセージ + exit 2 で停止します。 python3 起動時の挙動は不変です(no-args / --help の rc と出力を全数比較して確認済み)。 更新後、これらの .py を sh(または bash / zsh)で起動していたスクリプト・手順は exit 2 で止まります。 python3 <path> へ書き換えてください(元から python3 起動なら影響ありません)。

semver 裁定: 規約 docs/ai/versioning-stability-policy.md §2.2 「既定挙動の変更(SKIP → BLOCK)」は上記 2 件を major と示すが、本リリースは Human 裁定により minor。 影響が plugin 配布物に含まれない hook 配線利用者に限定されること、および v8.19.0(EH-13 の exit 1 → exit 2 fail-closed 化)で同型を minor と裁定した前例に揃えた。判定者・判定日・残る不整合と follow-up は docs/working/_merge/v8.21.0-release-runbook.md §1 に記録した。

Added

Fixed

Changed

Notes

v8.20.0 (2026-08-14)

fix: 配布経路(Codex plugin / skill frontmatter)の false green を実測で潰し、Codex CLI parity の誇大記述を「強制力 0/11」へ是正

v8.19.0 タグ以降 main に蓄積した 8 コミット(実測: git log --oneline v8.19.0..0559781 | wc -l。 squash merge 運用のため --merges は 0 件。うち 0e9ee8f は v8.19.0 のリリース後 changelog 同期であり、本リリースの実質的な変更は 7 件)を反映する小規模リリース。主題は 「緑を出していた検出器が、実際には別のものを測っていた」箇所を実測で潰すこと — Codex plugin の registered: YES false green(cache ディレクトリの存在だけで緑)・ skill frontmatter 破損の 4 root 同時是正・Codex CLI parity 記述の再是正。 schemas/*.json / bin/plangate / scripts/hooks/*.sh / .github/workflows/* は本リリースで変更ゼロ (実測: git diff v8.19.0..0559781 --stat -- schemas/ bin/ scripts/hooks/ .github/workflows/ が空) → Schema / CLI / Hook の挙動は不変。承認境界も不変(NO MERGE BY AI・C-4 / merge は Human-owned 固定)。

⚠️ 既知の未解消ギャップ(EH-3 / #1089)

対象: 本リポジトリを clone して scripts/hooks/ を .claude/settings.json へ配線している利用者。 scripts/hooks/check-plan-hash.sh(EH-3 本体)と scripts/apply-eh3-ho-always.sh / tests/fixtures/eh3-known-gap-1089.flag は plugin 配布物に含まれません。 plangate プラグインを plugin marketplace 経由で導入しているだけの場合、本節は影響しません。

PLANGATE_HOOK_TASK を設定した状態では、EH-3 の Hardening Override block が 9 カテゴリすべてで発火しません(実測 9/9 で rc=2 → rc=0)。HO 判定が if [ -z "$task_id" ] 分岐の内側にあり、TASK 文脈では plan_hash 検証パスへ抜けて 一度も評価されないためです。check-forbidden-files.sh は HO パスを守らないため、 EH-3 が唯一の HO ガードです。

本リリースには patch と回帰テストのみが含まれ、hook 本体の修正は含まれません (scripts/hooks/*.sh は HO パスのため適用は Human-owned)。解消するには:

sh scripts/apply-eh3-ho-always.sh --dry-run   # 差分確認
sh scripts/apply-eh3-ho-always.sh --apply     # 適用(Human-owned)

tests/fixtures/eh3-known-gap-1089.flag の削除は apply スクリプトが同時に行います (手動作業は不要)。このフラグが存在する間だけ ta-65 が gap を受理し、削除後は 「TASK 文脈でも block」が既定の期待値になるため、元構造へ戻すと CI が RED になります。

Added

Fixed

Changed

Notes(既知課題)

v8.19.0 (2026-08-13)

feat: 承認境界ガードの fail-closed 化(EH-13)+ protected branch 上の破壊的 git 操作ガード(EH-12)+ テスト「静かに通る失敗」の封鎖(#921 Slice 1)+ plugin skill の参照解決是正

v8.18.0 タグ以降 main に蓄積した 65 マージ(+65.5k 行。うち docs/working/ の PBI 作業成果物が +47.3k 行)を反映するリリース。主題は 「これまで黙って素通りしていた失敗を、止まる形に変える」 — 承認トークン直書きガード EH-13 の fail-closed 化 / テスト extras の共有 exit 契約 / protected branch 上の git reset --hard git push --force の block(EH-12)。承認境界は不変(NO MERGE BY AI・C-4 / merge は Human-owned 固定)。schemas/*.json と bin/plangate は本リリースで変更なし(Schema / CLI の互換性は不変)。

⚠️ 更新前に必ずお読みください(EH-13 の挙動変更)

jq が実質的な必須依存になりました。 EH-13(scripts/check-approval-token-write.sh)は従来、判定できない入力を素通りさせていましたが、本リリースから fail-closed(block) に変わります。具体的には以下がすべて block(exit 2)になります:

EH-13 は .claude/settings.example.json の PreToolUse(層 A・常時発火) に配線済みです。したがって jq を導入していない環境でこの設定を取り込んでいると、Edit / Write / MultiEdit / Bash の呼び出しがすべて止まります。

対応(推奨順):

  1. jq を導入する(推奨。例: brew install jq / apt-get install -y jq)。EH-13 が閉じている穴(承認トークンの AI 直書き)は残したまま、誤 block だけを解消できます。
  2. EH-13 の配線を .claude/settings.json から外す。非推奨 — 承認境界の技術層ガードが無くなり、規範層(responsibility-classes.md)だけに戻ります。
  3. PLANGATE_SKIP_TOKEN_GUARD=1 で全スキップ。緊急・診断専用(Human-owned)。恒常運用に使わないでください。

あわせて block の終了コードが exit 1 → exit 2 に変わりました(PreToolUse で block として扱われるのは 2。従来の 1 は非 block だったため、検出していたが止めていなかった)。書き込み意図の検出範囲も ed / ex / git checkout|restore|checkout-index|update-index / perl -i / patch / apply_patch / node / ruby へ拡大しています。

semver の注記: versioning-stability-policy.md §2.2 は「EH-x の既定挙動の変更(SKIP → BLOCK 等)」を major と定めています。本リリースは Human 裁定により minor(8.19.0) としました。裁定の経緯と残る不整合は docs/working/_merge/v8.19.0-release-runbook.md §semver 裁定の記録に記録しています。

Added

Fixed

Changed

Notes(既知課題)

v8.18.0 (2026-07-31)

feat: 実 PR 収束(MERGE_READY)の一気通貫 — delivery 判定エンジン + GitHub Collector / Action Executor / Reconciler + Plan-first C-3’ 束縛

v8.17.1 タグ以降 main に蓄積した 46 マージ(+49k 行)を反映するリリース。EPIC #870 の close blocker だった「PR 作成後の CI / review repair → MERGE_READY 実収束」が実 PR 実走証跡付きで完成し、ai-loop の Delivery 層が動く状態になった。承認境界は不変(NO MERGE BY AI・C-4 / merge は Human-owned 固定)。

Added

Fixed

Changed

v8.17.1 (2026-07-13)

fix: plugin bundle の同期漏れを追従(v8.17.0 tag に未収載だった .claude/ → plugin/plangate/ 差分の取り込み)

Fixed

v8.17.0 (2026-07-13)

feat: ai-loop Phase 1 移行(導入先実リポジトリ検証の正式化)+ 安全前提の機械層配線 + 計測基盤の実データ稼働 + HOTL 境界正本化

v8.16.0 タグ以降 main に蓄積した ai-loop / HOTL / スキル群の変更を plugin 配布に反映するリリース。plugin bundle(plugin/plangate/skills/ai-loop-cycle/)は references 全面更新 + metrics.py / test_metrics.py / agentic-six-stage-loop.md / stop-rollback.md を新規同梱する。

Added

Fixed

Changed

v8.16.0 (2026-07-08)

feat: ai-loop 初回実運用 Run-001〜021 の摩擦是正閉ループ + plangate プラグインへの ai-loop 同梱 + Hook Enforcement 物理配線 6/12 → 11/12 + サブエージェント委譲プロトコル正本

次世代ワークフロー「ai-loop」(旧 Arbiter)を Phase 0〜4 の仕様策定に続いて初めて実運用に投入し、Run-001〜021 で摩擦(friction)検出 → W チェック(3R 合議)→ loopspec.md / execution-runbook.md への正本化を反復するセルフチューニング閉ループ(F-1〜F-41)を確立した。ai-loop-cycle スキルは Agent Skills bundled resources 方式で plangate プラグインへ同梱し、他プロジェクトでの低リスク帯検証を可能にした(#771/#773)。Hook Enforcement は CLI 層 5 件(EH-4/5/EHS-1/2/3)の物理配線を追加して 6/12 → 11/12 に到達(TASK-0141/0143〜0147)。サブエージェント委譲プロトコル正本、doctor 3 チェック追加、review-gate skill 正本化、PostToolUse/Stop 軽量 hook(EH-10/EH-11 候補)、improvement-seeds hygiene 仕様、PreCompact memory guard、plangate-working-discipline skill(v1/v2)も追加。

Added

Changed

Fixed

Specification(仕様 + apply-script 提供のみ・HO 実適用は Human 待ち)

以下は「仕様策定 + Human-owned 適用スクリプト(--dry-run 既定)の提供」までが完了した 項目。Hardening Override(HO)対象パス(.claude/rules/*.md 等)への実適用(--apply)は Human-owned であり、本ドラフト時点では未実行。上記 Hook Enforcement 項目(実適用済み) とは異なり、enforcement は live ではない(working-context.md「settings タスクロック」と 同型のギャップ)。

v8.15.0 - 2026-06-25

feat: Review Gate 機械化 + EH-3 doc-light + approve 強化 + CLI テスト完備 + OpenSSF Scorecard 対応 + Best Practices Passing 取得

外部レビュー結果(Decision / risk)を c3_status へ自動マッピングし承認境界を機械執行する Review Gate(TASK-0129)、EH-3 フックに非 HO .md ファイルを記録付きで自動 SKIP する doc-light 経路(TASK-0138)、approve サブコマンドのハードニング(TASK-0139)、CLI サブコマンドの統合テスト完備(TASK-0140)を追加。OpenSSF Scorecard 対応(Pinned-Dependencies / SLSA / Fuzzing / Branch-Protection / SAST / Token-Permissions / SecurityPolicy)と Best Practices Passing バッジ取得を含む。

Added

Fixed

v8.14.0 - 2026-06-15

feat: C-3 レビュー HTML 出力(plangate render)+ 人間ワンアクション C-3 承認(plangate approve)

利用者の声「MD は確認しづらい / ファイルが多い / ブラウザで見たい」に応え、C-3 レビュー成果物をブラウザで横断把握できる HTML 出力を導入。あわせて「人間は承認の判断のみ、JSON/CLI 作業は負わない」という PlanGate コンセプトを実機化する承認 CLI を追加。

Added

Notes

v8.13.0 - 2026-06-11

feat: 全体健全化リリース — 監査駆動の鮮度・整合・隔離改善 + エージェント model tier

リポジトリ全体監査(2 ラウンド + Shadow Spec 棚卸し)を起点に、ドキュメント鮮度の回復、テストの実 docs/working 汚染の根治、未使用エージェント/スキルのスリム化、エージェント model tier(Claude: sonnet/inherit、Codex: low/medium effort)の導入、Hook enforcement の実装/配線の実態整合、yaml schema 検証、CLI テストカバレッジ完了(290 PASS)までを収録。

Added

Changed

Fixed

v8.12.0 - 2026-06-07

feat: 並列レビューア実行 + Plugin sync 品質ガード + 導入促進・運用ガード整備

bin/plangate review の並列レビューア実行(TASK-0122)を追加。Plugin マニフェストの version 二重管理ガード・Codex Plugin 状態検査 helper・実 SSoT 汚染の CI 可視化など plugin sync 周辺の品質を強化。導入検討者向けランディング(Why PlanGate)と HO 待ち運用ガード(status 日時必須・外部レビュー実行不可記録・runtime conductor 運用・AGENTS.md 汚染除去)を整備。3 視点レビュー(セルフ + 別視点 + Gemini)で検出した多数の指摘を反映。

Added

Changed

Fixed

Meta

v8.11.0 - 2026-06-04

feat: Claude Code / Codex Plugin 正式配布対応 + retrospective scoring 配点変更

Plugin を Claude Code / Codex 双方で marketplace add / install.sh から導入できる正式配布状態に整備。Codex/Gemini レビューと ultracode 検証 Workflow(5観点並列)で発見した配布ブロッカー(実在しない codex plugin install の誤記、install.sh のパス注入・symlink・dry-run 副作用、openai.yaml 仕様非準拠など)を解消。

Added

Changed

Fixed

v8.10.0 - 2026-05-29

feat: Codex CLI parity 完成 + Hook/Guard 拡充 + Skill 整備 + ドキュメント品質向上

v8.9.0(EPIC #193 完遂)以降に蓄積した TASK-0107〜0120 / Issue #353 の実装群。Codex CLI parity の完成、セキュリティ hardening(INC P-1/P-3 対応)、pre-commit/pre-push guard 拡充、skill 整備、C-3 Autonomous APPROVE ルール明文化を含む。

タグ対象 SHA: 1bde312(#415 main HEAD)

Added

Codex CLI parity(EPIC #338 / 100% 達成)

Skill 整備(#325 / #327 / #330 / TASK-0118)

セキュリティ・Guard 拡充

ヘルパー・UX

ドキュメント・公開ページ

C-3 運用改善

Changed

Security

Process Notes

v8.9.0 - 2026-05-19

feat: Reporting & Retrospective v1 + reporting 精度 follow-up — EPIC #193 完遂

EPIC #193 Harness Improvement Roadmap の v8.9.0 milestone(#200)を完走し、roadmap を完全完遂。Reporting & Retrospective v1(PBI-HI-006 / TASK-0098)で sprint retrospective 統合の基盤を実装し、その後 v1_first_pass / fix_loop の events 由来厳密化(TASK-0102)、test/dev フィルタ + run スコープ(#281 / TASK-0103)、roadmap 完了状態同期(TASK-0104)、EH-3 c3.json plan_hash 抽出の strict JSON 化(#282 / TASK-0105)まで follow-up を継続し、reporting の精度と決定論性を確定させた。

タグ対象 SHA: 345620c(#285 / TASK-0105、main HEAD)

Added

Changed

Process Notes

v8.8.0 - 2026-05-18

feat: Keep Rate v1 / Dynamic Context Engine v1 / Model Profile v2 / Gate Event Normalization / Dogfooding Eval v1

EPIC #193 の v8.8.0 milestone(5 件: #197 #198 #199 #230 #231)を完走。Gate Event Normalization 正本(#230)と Dogfooding Eval v1(#231)で events / 評価基盤を整え、その上に Model Profile v2(#197)/ Keep Rate v1(#198)/ Dynamic Context Engine v1(#199)を実装。harness の自己評価・context 分離・モデル特性対応が揃った。

タグ対象 SHA: 7e3ea4e(#273 / TASK-0097 #199 Dynamic Context Engine v1、v8.8.0 milestone 最終マージ)

Added

Changed

Process Notes

v8.7.0 - 2026-05-18

feat: Harness Improvement Roadmap P1 + TASK-0071 Governance Hardening / Feedback F1〜F5 完遂

EPIC #193 の v8.7.0 milestone(9 件: #196 #203 #204 #213 #224 #225 #226 #228 #229)を完走。加えて同期間に milestone 外の TASK-0071 群(Feedback F1〜F5 / Governance Hardening / #227 river-reviewer 標準 IF 正本化 / TASK-0089)を完遂し、exec 委譲デッドロック恒久対処・委譲 commit 境界強制・Lite 分岐 + C-3 条件付き降格・責務 4 分類正本化・Shadow Config ロック + drift CI を導入。harness の強制力と運用堅牢性が大きく前進した。

タグ対象 SHA: d0bd6cc(#270 / TASK-0094 #204 PlanGateBench Fixture Suite、v8.7.0 milestone 最終マージ)

Added

Changed

Process Notes

v8.6.0 - 2026-05-04

feat: Harness Improvement Roadmap Phase 0/1 + Governance — v8.6.0 milestone 完走

EPIC #193 Harness Improvement Roadmap の v8.6.0 milestone P0 4 件すべて完走。改善前 baseline 固定(#194)と運用 governance(#201, #202)を先に置き、その上に Metrics v1(#195)を実装。これにより以後の harness 改善(#196 Eval expansion / #197 Model Profile v2 / #198 Keep Rate / #199 Dynamic Context)を 比較で判断 できる基盤が整った。

Added

Changed

Process Notes

Next EPIC 候補(v8.7.0 / v8.8.0 / v8.9.0)

v8.5.0 - 2026-05-01

feat: Hook enforcement 完成 — 10/10 hooks 実装 (#169 EPIC 完走)

v8.4.0 で確立した 3 mode hook 設計(default warning / strict block / bypass escape)を全 spec に適用し、Issue #169 残 Hook EPIC を完走。docs/ai/hook-enforcement.md の Status は v3 → v5 (Implementation: 10/10 hooks Done) に到達、tests/hooks/run-tests.sh は 21 → 42 件 PASS に成長。同 release で v8.4 baseline 自動測定 + extras README 拡充も完了。

Added

Changed

Process Notes

Next EPIC 候補(V2)

  1. EH-7 上位拡張: GitHub branch protection / ruleset 自動適用(外部 GitHub API 操作、別 PBI)
  2. EHS-1 phase 分離: C-2 vs V-3 で review-external.md を分離する運用モデル
  3. Hook subcommand 統合: bin/plangate hook <name> への CLI 統合
  4. claude-cli session log parser(#168 v2、対話履歴 JSONL 統合)
  5. tool_call_count 抽出(codex JSONL の response_item 解析)
  6. session log 自動検出(cwd → 最新 rollout 推測)
  7. 共通 hook helper(scripts/hooks/_lib.sh で emit_judgment / log_event を集約、現状は 10 ファイル × 各 50〜100 行で許容範囲)

v8.4.0 - 2026-05-01

feat: 自動化基盤の節目 — eval runner / schema validate CI / hook enforcement / 環境改善

v8.3.0(最新実行モデル対応 + eval framework 仕様)で整備した基盤を、実 CI / 実 CLI / 実 hook に落とし込んだリリース。retrospective Try T-1〜T-6 のうち 6 件 + 派生 V2 候補 5 件を消化、合計 11 PBI(TASK-0045〜0054)を完走。マージ済 18 PR(#161〜#178)。

Added

Changed

Fixed

DX / Process

Process Notes

Next EPIC 候補(V2)

  1. #169 残 Hook 実装(EH-1 / EH-3〜EH-7 / EHS-1 = 7 hook、3 セッション分割推奨)
  2. claude-cli session log parser(codex のみ実装済、対話履歴の保存場所要調査)
  3. tool_call_count 抽出(codex JSONL の response_item 解析)
  4. session log 自動検出(cwd → 最新 rollout 推測)

v8.3.0 - 2026-04-30

feat: 最新実行モデル対応 — Outcome-first / Model Profile / Prompt Assembly / Eval 基盤 (EPIC #116)

PlanGate v8.2 milestone 中核 EPIC として、GPT-5.5 以降の outcome-first モデルに対応する基盤を整備。 Orchestrator Mode 実運用ケース第一号として親 PBI(PBI-116)を 6 子 PBI に分解、4 phase で実行。 17 PR(#126〜#151)をマージ、parent-AC × 8 全 PASS / Open Gap 0 / Release blocker 0 で完了。

Added

Changed

Process Notes

Next EPIC 候補(V2)

  1. v8.2 baseline 測定 PBI(本 eval framework での初回測定)
  2. eval runner 実装 PBI(reasoning_token / latency / tool call 集計の自動化)
  3. Hook enforcement 実装 PBI(plan 未承認 block 等のハード強制)
  4. Structured Outputs 実 LLM 適用 PBI(schema validate CI 統合含む)

v8.2.0 - 2026-04-28

feat: Parent-Child PBI Orchestrator Mode 仕様策定 + ドキュメント同期 (#111 #112 #113 #114)

Added

Changed

v8.1.0 - 2026-04-27

feat: Provider CLI 対応 — validate –mode、review(Gemini CLI)、exec(OpenCode)コマンド追加 (#107)

Added

v8.0.2 - 2026-04-27

docs: README 日本語メイン化・plugin migration guide 0.5.0 対応 (#100 #101 #102 #103)

Changed

v8.0.1 - 2026-04-27

docs: examples/minimal-node/ 追加 — Node.js 最小構成サンプル (#93)

Added

v8.0.0 - 2026-04-27

feat: v8.0 — Workflow DSL・Provider RFC・CLI テストスイート (#81 #82 #83) (#98)

Added

v7.5.2 - 2026-04-27

fix: python3 で JSON パースするよう timeline コマンドを修正 (#96)

v7.5.1 - 2026-04-27

feat: bin/plangate CLI v0.1.0 追加 (#95)

Added

v7.5.0 - 2026-04-27

docs: v7.5 — Deferred Decisions 判断記録・Discussions 設定確認・導線追加 (#88 #89) (#94)

Added

v7.4.0 - 2026-04-26

docs: v7.4 — CONTRIBUTING.ja・TROUBLESHOOTING・JSON schemas・gate enforcement spec (#92)

Added

v7.3.3 - 2026-04-27

docs: v7.3 governance — CI/Scorecard badges + docs/working/ public policy (#84 #87) (#91)

Added

v7.3.2 - 2026-04-26

docs: v7.3 onboarding — English README, examples/, plugin install guide (#73 #74 #75 #76)

Added

v7.3.1 - 2026-04-26

plugin v0.5.0: setup-team を skill 一覧に追加、broken reference 制約の削除、README バージョン更新。

v7.3.0 - 2026-04-26

モード命名の完全統一、setup-team スキル追加、pg-check × skill-policy-router 連携明示を行ったリリース。

setup-team スキル追加(TASK-0035)

full → high-risk モード命名完全統一(TASK-0036)

pg-check × skill-policy-router 連携明示(TASK-0037)

v7.2.0 - 2026-04-26

Epic #53「PlanGate を AI コーディングの開発統制 OS へ拡張する」の Phase 1〜3 を完了したリリース。

Phase 1: 軽量スキル基盤(#54/#55/#56)

Phase 2: 強制ゲート基盤(#57)

Phase 3: エージェント統制基盤(#58)

ドキュメント・その他

v7.1.0 - 2026-04-23

README 刷新、GitHub Pages 公開、Claude Code / Codex CLI 共用スキルの整備を行ったリリース。

v7.0.0 - 2026-04-20

Workflow / Skill / Agent の 3 層で実行層を再構築したハイブリッドアーキテクチャのリリース。

v6.0.0 - 2026-04-09

Context Engineering、18 エージェント体制、5 段階モード分類を含むロードマップリリース。

v5.0.0 - 2026-04-09

L-0 リンター自動修正とハーネスエンジニアリング知見を統合したリリース。

v4.0.0 - 2026-04-09

takt 知見を統合し、実装後検証と C-3 三値ゲートを強化したリリース。

v3.0.0 - 2026-04-09

AI 駆動開発ワークフローの基盤リリース。