verify

Verify — Pre-Completion Check

Iron Law

NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE. "I tested it" without output is an unverified claim.

When to Trigger

• Before a /go subagent reports "done"
• Before /ship creates a PR
• Before telling the user "it's ready"
• After any significant code change

Process

1. Build

# Detect and run the project's build command
npm run build  # or: go build ./... | cargo build | make

Must exit 0. If it fails, fix before proceeding.

2. Test

# Run the project's test suite
npm test  # or: go test ./... | pytest | cargo test

Must exit 0. If tests fail, invoke debug skill.

3. Lint

# Run linter if configured
npm run lint  # or: golangci-lint run | ruff check | cargo clippy

Warnings are OK. Errors must be fixed.

4. Type Check (if applicable)

npx tsc --noEmit  # TypeScript
mypy .            # Python

5. Final Sanity

• No console.log / print debug statements left
• No TODO or FIXME introduced without explanation
• No hardcoded test values or credentials
• All new files are tracked by git

Anti-Rationalization

Excuse	Rebuttal	What to do instead
"Tests pass locally"	Did you actually run them? Trust the output, not your memory.	Run npm test right now. Show the output.
"I only changed one file"	One file can break the entire build. Imports propagate.	Full build + test. Every time. No exceptions.
"Lint warnings aren't errors"	Warnings become errors. Fix them before they multiply.	Zero warnings policy. Fix now or suppress with justification.
"CI will catch it"	CI feedback is 5-10 min delayed. Catch it locally in seconds.	Run verify locally before pushing. CI is the safety net, not the test.

Evidence Required

Before reporting "ready", show ALL of these:

• Build output: exit code 0 (show the command + result)
• Test output: all passing (show summary line)
• Lint output: zero errors (show summary or "clean")
• Type check output: no errors (show tsc --noEmit or equivalent)
• Final sanity: no console.log, no unexplained TODO, no hardcoded values

Each check needs actual command output. "I ran it" without output = not verified.

Red Flags

• Reporting success without showing actual command output
• Skipping type check "because JavaScript is dynamic"
• Committing with TODO/FIXME and no explanation