verification-before-completion

完了前の検証

新たな検証証拠がない限り、完了したと主張しないでください

基本プロトコル

常に、主張より先に証拠を確認してください。このメッセージで検証コマンドを実行していない場合、それが成功したと主張することはできません。

BEFORE any completion claim:
1. IDENTIFY: What verification command proves this claim?
2. RUN: Execute the FULL command (fresh, complete)
3. READ: Full output, check exit code, count failures
4. VERIFY: Does output confirm the claim?
   - NO → State actual status with evidence
   - YES → State claim WITH evidence
5. ONLY THEN: Make the claim

コマンドの選択

検証方法が複数ある場合（モノレポ、複数のテストスイートなど）：

• 変更したコードを対象とする、最も具体的なコマンドを実行します
• 不確かな場合は、最も広範なコマンドを実行します（単一ファイルより全テストスイート）
• リント ≠ ビルド ≠ テスト — それぞれ検証する内容が異なります

証拠の形式

✅ Ran: npm test
   Exit: 0
   Result: 47 passed, 0 failed
   "All tests pass."

❌ "Tests should pass now" (no command output)

主張の種類ごとの検証要件

主張	必要な証拠	不十分なもの
テストに合格	テスト出力：失敗 0 件	過去の実行結果、「合格するはず」
リンターに問題なし	リンター出力：エラー 0 件	部分的なチェック、推測
ビルドに成功	ビルドの終了コード：0	リンターに合格
バグを修正	元の症状を確認するテストに合格	コードを変更した
回帰テスト	レッド・グリーンサイクルを確認	グリーンのみ
エージェントが完了	VCS の差分で変更を確認	エージェントの「成功」報告
要件を満たす	行ごとのチェックリスト	テストに合格

危険信号 — 停止してください

• 「はず」「たぶん」「〜のようだ」といった言葉
• 検証前の満足を示す表現：「すばらしい！」「完璧！」「完了！」
• 検証せずにコミット、プッシュ、PR をしようとしている
• エージェントの成功報告を鵜呑みにする
• 部分的な検証
• 検証出力なしに成功を示唆する表現

正当化の防止

言い訳	対応
「これで動くはず」	検証を実行する
「自信がある」	自信 ≠ 証拠
「今回だけ」	例外なし
「リンターに合格した」	リンター ≠ ビルド
「エージェントが成功したと言った」	独立して検証する
「部分的なチェックで十分」	部分的なチェックでは何も証明できない

重要なパターン

テスト：

✅ [Run test] → [See: 34/34 pass] → "All tests pass"
❌ "Should pass now"

回帰（TDD）：

✅ Write → Run (pass) → Revert fix → Run (MUST FAIL) → Restore → Run (pass)
❌ "Wrote regression test" (no red-green)

要件：

✅ Re-read plan → Checklist each item → Report gaps or completion
❌ "Tests pass, phase complete"

エージェントへの委任：

✅ Agent reports → Check VCS diff → Verify changes → Report actual state
❌ Trust agent report