Verification Loop Skill

A comprehensive verification system for Claude Code sessions.

When to Use

Invoke this skill:

  • After completing a feature or significant code change
  • Before creating a PR
  • When you want to ensure quality gates pass
  • After refactoring

Verification Phases

Phase 1: Build Verification

1# Check if project builds
2npm run build 2>&1 | tail -20
3# OR
4pnpm build 2>&1 | tail -20

If build fails, STOP and fix before continuing.

Phase 2: Type Check

1# TypeScript projects
2npx tsc --noEmit 2>&1 | head -30
3
4# Python projects
5pyright . 2>&1 | head -30

Report all type errors. Fix critical ones before continuing.

Phase 3: Lint Check

1# JavaScript/TypeScript
2npm run lint 2>&1 | head -30
3
4# Python
5ruff check . 2>&1 | head -30

Phase 4: Test Suite

1# Run tests with coverage
2npm run test -- --coverage 2>&1 | tail -50
3
4# Check coverage threshold
5# Target: 80% minimum

Report:

  • Total tests: X
  • Passed: X
  • Failed: X
  • Coverage: X%

Phase 5: Security Scan

1# Check for secrets
2grep -rn "sk-" --include="*.ts" --include="*.js" . 2>/dev/null | head -10
3grep -rn "api_key" --include="*.ts" --include="*.js" . 2>/dev/null | head -10
4
5# Check for console.log
6grep -rn "console.log" --include="*.ts" --include="*.tsx" src/ 2>/dev/null | head -10

Phase 6: Diff Review

1# Show what changed
2git diff --stat
3git diff HEAD~1 --name-only

Review each changed file for:

  • Unintended changes
  • Missing error handling
  • Potential edge cases

Output Format

After running all phases, produce a verification report:

1VERIFICATION REPORT
2==================
3
4Build:     [PASS/FAIL]
5Types:     [PASS/FAIL] (X errors)
6Lint:      [PASS/FAIL] (X warnings)
7Tests:     [PASS/FAIL] (X/Y passed, Z% coverage)
8Security:  [PASS/FAIL] (X issues)
9Diff:      [X files changed]
10
11Overall:   [READY/NOT READY] for PR
12
13Issues to Fix:
141. ...
152. ...

Continuous Mode

For long sessions, run verification every 15 minutes or after major changes:

1Set a mental checkpoint:
2
3- After completing each function
4- After finishing a component
5- Before moving to next task
6
7Run: /verify

Integration with Hooks

This skill complements PostToolUse hooks but provides deeper verification. Hooks catch issues immediately; this skill provides comprehensive review.