Use automatically during development workflows when making claims about tests, builds, verification, or code quality requiring concrete evidence to ensure trust through transparency.
Use automatically during development workflows when making claims about tests, builds, verification, or code quality requiring concrete evidence to ensure trust through transparency.
allowed-tools
["Write","Edit","Read","Bash","Grep"]
Proof of Work
Show, don't tell. Never make claims about code verification without
providing concrete evidence.
Core Principle
Trust through transparency. Every assertion about code quality, test
results, builds, or verification must be backed by actual command output,
not summaries or assumptions.
Implementation Proof
When implementing features:
USE Write/Edit tools to make changes
Never just describe what should be written
Actually call Write tool to create files
Actually call Edit tool to modify files
Show tool results
After Write: "Successfully wrote /path/to/file.ex"
After Edit: "Successfully edited /path/to/file.ex"
Tool output is proof changes were made
Verify changes exist
Use Bash to verify files exist: ls -la /path/to/file.ex
Use Read to show content if needed
Actual file existence is proof
Remember: If you didn't use Write/Edit tools, it didn't happen.
Agent Verification (CRITICAL)
NEVER EVER trust agent completion reports without verification.
This is a zero-tolerance rule.
Agent reports are NOT proof - they are claims requiring verification.
The Critical Error
When you delegate work to a subagent:
Agent completes and reports "Successfully created X, modified Y,
implementation complete"
STOP - DO NOT TRUST THIS REPORT
Agent reports mean NOTHING until you verify
Blindly trusting agent reports is a catastrophic failure
Mandatory Verification After EVERY Agent
After ANY agent completes, you MUST verify work was actually done:
# 1. Verify files were actually modified
git status --short
# 2. Verify actual changes exist
git diff --name-only
# 3. Verify specific file exists (if agent claimed to create it)ls -la /path/to/file
# 4. Verify file content (spot check)cat /path/to/file | head -20
If git status shows clean working tree → NOTHING was done, regardless of
agent report.
Red Flags in Agent Reports
Never trust these claims without verification
Agent Claim
Required Verification
"Successfully created X"
ls -la /path/to/X - prove file exists
"Modified files A, B, C"
git status - prove files show as modified
"Changes made to Y"
git diff Y - prove actual changes exist
"Implementation complete"
git diff --stat - prove work was done
"Added tests to Z"
cat Z - prove tests actually exist
"Updated configuration"
git diff config/ - prove config changed
Verification Workflow (MANDATORY)
1. Delegate to agent
2. Agent reports completion
3. ⚠️ STOP - DO NOT TRUST REPORT ⚠️
4. Run verification commands (git status, ls, cat, etc.)
5. If verification fails → Agent did NOT complete work
6. If verification passes → THEN report to user WITH PROOF
# After agent completes, verify:
$ git status --short
M apps/api/lib/users/worker.ex
A apps/api/test/users/worker_test.exs
# Prove files exist:
$ ls -la apps/api/test/users/worker_test.exs
-rw-r--r-- 1 user staff 2847 Nov 7 14:32 apps/api/test/users/worker_test.exs
# Spot check content:
$ head -10 apps/api/test/users/worker_test.exs
defmodule YourApp.Users.UserTest do
use YourApp.DataCase
...