aboutsummaryrefslogtreecommitdiff
path: root/claude-rules/verification.md
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-05-22 15:13:05 -0500
committerCraig Jennings <c@cjennings.net>2026-05-22 15:13:05 -0500
commit0afe48df3d4fa49da889fbeaeaa38e8f971e030a (patch)
treea92f1d88727942cad5f9568a28d3c38d7d1e746c /claude-rules/verification.md
parent2b3e5a5a7327a6ffdb6fbca92c9691a05c7221c1 (diff)
downloadrulesets-0afe48df3d4fa49da889fbeaeaa38e8f971e030a.tar.gz
rulesets-0afe48df3d4fa49da889fbeaeaa38e8f971e030a.zip
docs(rules): add an unable-to-verify reporting standard
verification.md required running tests/lint/typecheck/build before claiming done, but said nothing about what to do when a command can't run. A new "When You Cannot Verify" section requires a four-part report (command attempted, why it couldn't run, risk left unverified, and the smallest next command for the user) and states the principle that a check that didn't run is never reported as a pass.
Diffstat (limited to 'claude-rules/verification.md')
-rw-r--r--claude-rules/verification.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/claude-rules/verification.md b/claude-rules/verification.md
index 8993736..673a54d 100644
--- a/claude-rules/verification.md
+++ b/claude-rules/verification.md
@@ -31,6 +31,19 @@ If you find yourself using these words, you haven't verified:
Replace beliefs with evidence. Run the command.
+## When You Cannot Verify
+
+Sometimes the verification command cannot run: the tool is absent, there is no network, a sandbox blocks it, or the environment is missing a dependency. A check that did not run must never be reported as a pass. "Unable to verify" is an honest, required outcome — not silence, and not an optimistic "should work."
+
+When a check cannot run, report it in this order:
+
+1. **Command attempted** — the exact command you tried to run.
+2. **Why it could not run** — tool absent, no network, sandbox limit, missing environment, etc.
+3. **Risk left unverified** — what might be broken that you would not know about, given the check did not run.
+4. **Next command to close the gap** — the smallest command the user can run to verify themselves.
+
+Do not let an unverifiable check vanish into a confident summary. State it plainly and hand the gap to the user.
+
## Before Committing
Before any commit: