Skip to content

Add claude-verify-before-stop hook to Tools & Utilities#303

Open
ianymu wants to merge 1 commit into
jqueryscript:mainfrom
ianymu:add-verify-before-stop-hook
Open

Add claude-verify-before-stop hook to Tools & Utilities#303
ianymu wants to merge 1 commit into
jqueryscript:mainfrom
ianymu:add-verify-before-stop-hook

Conversation

@ianymu
Copy link
Copy Markdown

@ianymu ianymu commented May 20, 2026

Summary

Adds claude-verify-before-stop to the Tools & Utilities section.

What it does

A Claude Code Stop hook that blocks the session from ending until verification is logged. It fires when Claude tries to end a session, checks for uncommitted file changes, and if files changed, requires a VERIFIED log entry from the last 5 minutes in .claude/state/stop-verify.log. If missing, it blocks the stop and prints the exact verification steps the model must take (run tests, curl the deploy, playwright the UI, etc.).

This addresses a specific failure mode: Claude announces "all tests passing" without having actually run them, the user merges, prod breaks. The hook forces the model to either prove it verified or admit it didn't.

Why it fits this list

  • Zero dependencies — pure bash + python3 stdlib (no Node, no pip)
  • Unique angle vs existing "stop hook" entries: this one blocks rather than reminds
  • Drop-in install (one curl + one settings.json snippet)
  • MIT licensed, single ~80-line script you can audit in 2 minutes

The entry was placed at the bottom of Tools & Utilities (it's a 0⭐ project, matching the existing convention of listing newer/smaller projects there).

Verification

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant