aboutsummaryrefslogtreecommitdiff
path: root/.claude/rules/verification.md
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-04-19 12:14:54 -0500
committerCraig Jennings <c@cjennings.net>2026-04-19 12:14:54 -0500
commit1172e4ef1e2d5dbcf2274820ca7759e3aa54b6c6 (patch)
tree69ef2793bae4344ef7c716f7e41e602f4dafc75f /.claude/rules/verification.md
parentc3b0057b4438ed3080b80fe0c8611683138c1bd5 (diff)
downloaddotemacs-1172e4ef1e2d5dbcf2274820ca7759e3aa54b6c6.tar.gz
dotemacs-1172e4ef1e2d5dbcf2274820ca7759e3aa54b6c6.zip
chore: track CLAUDE.md and .claude/ bundle, narrow gitignore
Swap blanket /CLAUDE.md + /.claude/ gitignore rules for personal-only overrides (.claude/settings.local.json, .claude/.cache/). Add the tracked bundle content from ~/code/rulesets install-elisp: - CLAUDE.md (project instructions) - .claude/rules/elisp.md - .claude/rules/elisp-testing.md - .claude/rules/verification.md - .claude/hooks/validate-el.sh (portable via $CLAUDE_PROJECT_DIR) - .claude/settings.json (allowlist + hook wiring) Hooks now use $CLAUDE_PROJECT_DIR with script-relative fallback, so a fresh clone of this repo works on any machine without path edits. Project-local skills under .claude/skills/ were stale DeepSat-flavored copies; deleted and replaced with symlinks into ~/.claude/skills/ via the rulesets repo's global install.
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 00000000..8993736d
--- /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.