Back to list
astrosteveo

verification-before-completion

by astrosteveo

Agentic skills framework & software development methodology for Claude Code

0🍴 0📅 Jan 21, 2026

SKILL.md


name: verification-before-completion description: Use when about to claim work is complete, fixed, or passing - requires running verification commands and confirming output before making any success claims

Verification Before Completion

Overview

Core principle: Evidence before claims, always.

Violating the letter of this rule is violating the spirit of this rule.

The Iron Law

NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE

If you haven't run the verification command in this message, you cannot claim it passes.

The Gate Function

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?
  5. ONLY THEN: Make the claim

Skip any step = lying, not verifying.

What Counts as Evidence

ClaimRequiresNot Sufficient
Tests passTest output: 0 failuresPrevious run, "should pass"
Build succeedsBuild command: exit 0Linter passing
Bug fixedOriginal symptom test passesCode changed, assumed fixed
Agent completedVCS diff shows changesAgent reports "success"
Requirements metLine-by-line checklist verifiedTests passing

Red Flags

Stop if you catch yourself:

  • Using "should", "probably", "seems to"
  • Expressing satisfaction before verification ("Great!", "Done!")
  • Trusting agent success reports without checking
  • Thinking "just this once"
  • ANY wording implying success without running verification

Common rationalizations:

ExcuseReality
"Should work now"RUN the verification
"I'm confident"Confidence ≠ evidence
"Linter passed"Linter ≠ compiler ≠ tests
"Agent said success"Verify independently
"Partial check is enough"Partial proves nothing

Correct Patterns

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

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

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

The Bottom Line

Run the command. Read the output. THEN claim the result.

No shortcuts. Non-negotiable.

Score

Total Score

60/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon