このプロジェクトについて

regress-guard は ZCode 向けの AI コーディングガバナンスプラグインであり、核心理念は「agent の完了宣言を信用しない」ことにある。コミットという重要な節目でプロジェクト自身のテストスイートを再実行し、「完了」を機械検証可能な宣言に変える。 主な機能は以下の通り: 1. 完了度の再確認:PreToolUse フックがコミットコマンドを阻止し、プロジェクトのテストを自ら実行する(pytest/jest/maven/gradle/go を自動検出)。EARS 形式の受け入れ行は証拠に基づいてチェックされて初めて完了とマークできる。同一ツリーでの再試行は内容キーキャッシュにヒットし 0 秒で通過する。 2. 境界ガード:現在の変更リストで宣言されていないファイルの編集・書き込み操作を事前に阻止する。計画ファイルリストがそのまま境界となる。 3. 仮定台帳:現実が計画の仮定を反証した場合、was→reality→evidence の連鎖を強制的に記録する。 4. 六層の信頼面:プロジェクトレベルの通知チャネルには人手による認可信頼テーブル+内容ピン留めが必要。HOME/env 注入リダイレクトはランチャーのホワイトリストで中和。クローンリポジトリの注入面は閉鎖済み。 5. FP キャリブレーション・テレメトリ:各阻止は人手で事後に裁定される(有用/誤検知/無視)。agent は自身の精度に投票権を持たない。公開ベンチマークは 82 ケース/13 ファミリーを含む。 6. 自己修復:セッション起動時にインストール済みコピーとソースリポジトリを比較し、バージョンドリフトは黙認せず告知する。 インストール方法は ZCode プラグインマーケット、個人ソース(github:1339190177/regress-guard)、開発トラック(clone 後に bash install.sh)を含む。実行時にサードパーティの Python 依存はゼロで、Python 3.10+ のみ必要。 16 個のコマンド(/regress:init、/regress:plan、/regress:verify、/regress:bypass など)を提供し、初期化、計画生成、テスト検証、特性テスト生成、中断点からの再開、ヘルスレポートなどのシナリオをカバーする。プロジェクト状態と考古学データは .regress/ ディレクトリに保存される。デフォルトでネットワーク外向き通信はゼロ。任意で企業 WeChat 自建アプリ通知が可能(人手による認可が必要で、API ベース URL は公式ドメインにピン留めされる)。MIT ライセンス。