verification-before-completion

完了前の検証

概要

基本原則： 常に、主張よりも証拠を優先します。

ゲート

BEFORE claiming any status:

1. IDENTIFY: What command proves this claim?
2. RUN: Execute the command (fresh, complete)
3. READ: Full output, check exit code
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

よくある失敗

主張	必要なもの	不十分なもの
テストに合格	テストコマンドの出力：失敗 0 件	前回の実行、「合格するはず」
リンターに問題なし	リンターの出力：エラー 0 件	部分的なチェック
ビルド成功	ビルドコマンド：終了コード 0	「問題なさそう」
バグ修正済み	元の症状が解消している	コードを変更しただけ、修正したと思い込むこと
パイプライン完了	出力ファイルが存在し、有効である	ツールが成功を報告したこと
ノートブックが実行可能	すべてのセルがエラーなしで実行された	一部のセルが実行されたこと

危険信号 — STOP

次のようなことに気づいたら：

• 「はず」「たぶん」「〜のようだ」と考えている
• 検証前に満足を表明している（「すばらしい！」「完了！」）
• テストを実行せずにコミットしようとしている
• 部分的な検証に頼っている
• 出力を確認せず、ツールの成功報告を信頼している

正当化

言い訳	実際
「これで動くはず」	検証を実行してください
「自信があります」	自信 ≠ 証拠
「今回だけ」	例外はありません
「ツールが成功と言った」	独自に検証してください
「部分的なチェックで十分」	部分的な確認では何も証明できません

重要なパターン

テスト：

CORRECT: [Run test] → [See: 34/34 pass] → "All tests pass"
WRONG:   "Should pass now" / "Looks correct"

パイプラインの出力：

CORRECT: [Check output file exists] → [Verify size/format] → "Pipeline produced valid output"
WRONG:   "Galaxy shows green" (without checking actual data)

ノートブック：

CORRECT: [Restart kernel] → [Run All] → [Check no errors] → "Notebook runs cleanly"
WRONG:   "I updated the cell" (without re-running)

要点

コマンドを実行し、出力を読み、その後で結果を主張してください。

クレジット

obra/superpowers の verification-before-completion スキルを基にしています。