evidence-gate

Evidence Gate

ステータスより先に証拠を示してください。現在のターンに、その主張を裏付ける証拠が含まれていない限り、作業が完了した、修正された、テストに合格した、準備ができた、コミットされた、プッシュされた、PR を作成する準備ができた、または引き継ぎの準備ができたとは言わないでください。

使用するタイミング

• タスクが完了または修正されたと言う前
• コミットまたはプッシュする前
• PR を作成または更新する前
• イシューをレビュー可能または完了としてマークする前
• 別のエージェントまたは人間に作業を引き継ぐ前
• エージェント、ツール、または CI ジョブが成功を報告した後

ゲート

1. これから行おうとしている主張を述べます。
2. その主張を証明するために必要な最小限のコマンドまたは確認事項を特定します。
3. コマンドを最後まで実行するか、必要な成果物を確認します。
4. 出力と終了コードを読み取ります。
5. 結果が主張と一致するか照合します。
6. 正確な証拠を報告するか、阻害要因を述べます。

証拠マトリックス

主張	必要な証拠
テストに合格	テストコマンドが終了コード 0 で終了し、失敗がないと報告する
リントに問題なし	リントコマンドが終了コード 0 で終了し、警告がないと報告する
型チェック／ビルドに合格	型チェック／ビルドコマンドが終了コード 0 で終了する
バグを修正	元の再現手順またはリグレッションチェックに合格する
要件を満たした	テストだけでなく、依頼された範囲に照らしたチェックリスト
コミットの準備完了	git diff --cached の確認と、関連するチェック
プッシュの準備完了	ブランチ、コミット、リモートの送信先を確認する
PR の準備完了	検証コマンド、PR のタイトルと本文、差分の範囲
引き継ぎの準備完了	現在のステータス、変更したファイル、検証結果

報告形式

最終回答または引き継ぎでは、次の形式を使用してください。

Verification:
- `<command>`: passed
- `<command>`: failed — <reason>

Not run:
- `<command>` — <reason>

チェックに失敗した場合、結果を曖昧にしないでください。失敗と次のアクションを明記してください。

アンチパターン

• チェックを実行せずに「おそらく合格します」と言う。
• 1 つのチェックへの合格を、すべてのチェックに合格した証拠として扱う。
• 差分や出力を確認せず、ツールやサブエージェントの成功メッセージを信頼する。
• ローカルでの検証に関するメモがないまま PR を作成する。
• テストに合格したという理由で、作業範囲が完了したとマークする。