Groundtruth – AIコーディングエージェントの主張をGit差分と照合する

Groundtruth は、Claude Code 用のプラグインで、AI コーディングエージェントが報告する「完了」を実際の Git 差分と照合することで、その正当性を検証します。別の LLM を使わずに、決定論的なローカルフックとして動作し、ネットワーク接続も API キーも不要です。エージェントの作業内容を読み取らないため、外部から評決を覆すことはできません。

このプラグインは、各ターンの終了時に評決カードを生成し、以下の4つの側面をチェックします。誠実さ（テストの実行を偽っていないか、スタブやプレースホルダーがないか、ファイルが存在しないのに存在すると主張していないか）、完全性（要求された成果物が実際の差分に含まれているか）、ルール遵守（プロジェクトのルールが守られているか）、セキュリティ（ハードコードされた秘密鍵や安全でないデータベース設定がないか）。これらはすべて Git 差分と会話記録に基づいて決定論的に判定されます。

インストールは Claude Code 内で /plugin marketplace add akahkhanna/groundtruth と /plugin install groundtruth@groundtruth を実行し、再起動するだけです。デフォルトは警告モードで、評決は記録されますがターンは中断されません。ブロックモードに切り替えると、重大な違反があった場合にターンが中断され、修正が促されます。/groundtruth コマンドで最新の評決を表示でき、/groundtruth-block on でブロックモードを有効にできます。

Groundtruth は3つの実行レベルを提供します。ターン内の停止フック、プリコミットフック（チャットからのコード貼り付けも検出）、CI ゲート（ブランチ間の差分をチェックしてブロック）。信頼モデルは、エージェントが改ざんできない2つの入力（会話記録と Git が計算した作業ツリーの差分）に基づいています。より高いセキュリティが必要な場合は、プリマージ CI ゲートなど、独立した信頼ドメインでフックを実行することを推奨しています。

プロジェクトは徹底的にテストされており、440 の単体テストとレッドチーム演習を実施し、すべての修正は FIXES.md に記録されています。groundtruth-audit コマンドでリポジトリ全体のエージェント負債をスキャンでき、groundtruth-rules コマンドでドキュメントからコンパイルされたルールをレビュー・承認できます。将来のロードマップには LLM を活用したセマンティックレイヤーが含まれていますが、コアエンジンは決定論的かつオフラインで動作し続けます。