aboutsummaryrefslogtreecommitdiff
path: root/claude-rules/verification.md
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-03-29 16:25:05 -0500
committerCraig Jennings <c@cjennings.net>2026-03-29 16:25:05 -0500
commit861bab677b4632e9d30e6318bc2a35c36ee77105 (patch)
tree22dc96a5eeba6250f4697b2daf573289e9fea8f2 /claude-rules/verification.md
parent24a3b7fe059f3d95d47432c4593993fa5001f18f (diff)
downloadrulesets-861bab677b4632e9d30e6318bc2a35c36ee77105.tar.gz
rulesets-861bab677b4632e9d30e6318bc2a35c36ee77105.zip
Add general-purpose skills and rules from DeepSat coding-rulesets
Skills (adapted from DeepSat, stripped of project-specific references): - /review-pr: PR review against engineering standards - /fix-issue: issue-to-merge TDD workflow - /security-check: secrets, OWASP, and dependency audit - /debug: systematic 4-phase debugging - /add-tests: test coverage analysis and generation - /respond-to-review: evaluate and implement code review feedback Rules (general-purpose, copied as-is): - testing.md: universal TDD standards and anti-patterns - verification.md: proof over assumption Makefile updated to install both skills and rules via symlinks. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Diffstat (limited to 'claude-rules/verification.md')
-rw-r--r--claude-rules/verification.md42
1 files changed, 42 insertions, 0 deletions
diff --git a/claude-rules/verification.md b/claude-rules/verification.md
new file mode 100644
index 0000000..8993736
--- /dev/null
+++ b/claude-rules/verification.md
@@ -0,0 +1,42 @@
+# Verification Before Completion
+
+Applies to: `**/*`
+
+## The Rule
+
+Do not claim work is done without fresh verification evidence. Run the command, read the output, confirm it matches the claim, then — and only then — declare success.
+
+This applies to every completion claim:
+- "Tests pass" → Run the test suite. Read the output. Confirm all green.
+- "Linter is clean" → Run the linter. Read the output. Confirm no warnings.
+- "Build succeeds" → Run the build. Read the output. Confirm no errors.
+- "Bug is fixed" → Run the reproduction steps. Confirm the bug is gone.
+- "No regressions" → Run the full test suite, not just the tests you added.
+
+## What Fresh Means
+
+- Run the verification command **now**, in the current session
+- Do not rely on a previous run from before your changes
+- Do not assume your changes didn't break something unrelated
+- Do not extrapolate from partial output — read the whole result
+
+## Red Flags
+
+If you find yourself using these words, you haven't verified:
+
+- "should" ("tests should pass")
+- "probably" ("this probably works")
+- "I believe" ("I believe the build is clean")
+- "based on the changes" ("based on the changes, nothing should break")
+
+Replace beliefs with evidence. Run the command.
+
+## Before Committing
+
+Before any commit:
+1. Run the test suite — confirm all tests pass
+2. Run the linter — confirm no new warnings
+3. Run the type checker — confirm no new errors
+4. Review the diff — confirm only intended changes are staged
+
+Do not commit based on the assumption that nothing broke. Verify.