verify

完了前の検証

概要

検証せずに作業が完了したと主張するのは、効率化ではなく不誠実です。

superskills の品質基準の一部です（「テストは実際に実行しなければならない」— プロジェクト内ではなく、superskills のインストール先に ENGINEERING_STANDARDS.md として記載されています）。このスキルは、「完了」を主張ではなく、新たな証拠によって証明する方法です。

基本原則：常に、主張する前に証拠を示します。

このルールの文言に違反することは、このルールの趣旨にも違反することです。

鉄則

NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE

このメッセージに記載された検証コマンドを実行していない場合、検証に合格したと主張することはできません。

ゲート機能

BEFORE claiming any status or expressing satisfaction:

1. IDENTIFY: What 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?
   - If NO: State actual status with evidence
   - If YES: State claim WITH evidence
5. ONLY THEN: Make the claim

Skip any step = lying, not verifying

よくある失敗

主張	必要なもの	不十分なもの
テストに合格した	テストコマンドの出力：失敗 0 件	以前の実行結果、「合格するはず」
リンターの問題がない	リンターの出力：エラー 0 件	部分的なチェック、推測
ビルドに成功した	ビルドコマンド：終了コード 0	リンターに合格したこと、ログが問題なさそうなこと
バグを修正した	元の症状を検証するテスト：合格	コードを変更したこと、修正されたと想定すること
回帰テストが機能する	Red-Green サイクルを検証したこと	テストに一度合格したこと
エージェントが完了した	VCS の diff に変更が示されていること	エージェントが「成功」と報告したこと
要件を満たした	項目ごとのチェックリスト	テストに合格したこと

危険信号 — 停止する

• 「はず」「おそらく」「そう見える」を使う
• 検証する前に満足を表明する（「すばらしい！」「完璧！」「完了！」など）
• 検証せずにコミット、プッシュ、PR をしようとしている
• エージェントの成功報告を信頼する
• 部分的な検証に頼る
• 「今回だけなら」と考える
• 疲れていて、作業を終わらせたいと思っている
• 検証を実行せずに成功を示唆する表現を使うこと

正当化を防ぐ

言い訳	実際
「これで動くはず」	検証を実行する
「自信がある」	自信 ≠ 証拠
「今回だけなら」	例外はありません
「リンターには合格した」	リンター ≠ コンパイラー
「エージェントが成功したと言った」	自分で検証する
「疲れている」	疲労 ≠ 言い訳
「部分的なチェックで十分」	部分的なチェックでは何も証明できません
「別の言葉だから、このルールは適用されない」	文言より趣旨を重視する

主なパターン

テスト：

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

回帰テスト（TDD の Red-Green）：

✅ Write → Run (pass) → Revert fix → Run (MUST FAIL) → Restore → Run (pass)
❌ "I've written a regression test" (without red-green verification)

ビルド：

✅ [Run build] [See: exit 0] "Build passes"
❌ "Linter passed" (linter doesn't check compilation)

要件：

✅ Re-read plan → Create checklist → Verify each → Report gaps or completion
❌ "Tests pass, phase complete"

エージェントへの委任：

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

重要な理由

24 件の失敗の記録より：

• 人間のパートナーから「あなたの言うことは信じられない」と言われ、信頼が失われた
• 未定義の関数がリリースされ、クラッシュするところだった
• 要件の不足が見過ごされ、不完全な機能がリリースされた
• 誤った完了報告により時間を浪費し、作業のやり直しになった
• 「誠実さは核となる価値観です。嘘をつけば、あなたは置き換えられます。」に違反する

適用するタイミング

必ず、次の前に適用します：

• 成功や完了を主張する表現のあらゆるバリエーション
• 満足を表すあらゆる表現
• 作業状況について肯定的に述べるあらゆる表現
• コミット、PR の作成、タスクの完了
• 次のタスクへの移行
• エージェントへの委任

ルールの適用対象：

• そのままの表現
• 言い換えや類義語
• 成功を示唆する表現
• 完了や正確性を示唆するあらゆるコミュニケーション

要点

検証に近道はありません。

コマンドを実行します。出力を読みます。その後で結果を主張します。

これは譲れないルールです。