rjv-diff-checklistlisted
Install: claude install-skill rjvim/ai-skills
# Diff-triggered checklist
Past incidents become questions a reviewer asks only when the diff
touches the area that caused them.
## The file
`REVIEW.md` at the repo root holds what the reviewer pays attention to
in this code, and the checklist. One item per entry:
```text
### <short name>
Trigger: <readable from a diff: a path glob, a symbol, a migration, a new field>
Check: <one question the reviewer answers yes or no>
Source: <PR, revert or incident that taught it, with date>
```
Example:
```text
### Old records load
Trigger: a new column or field on a stored record or message type
Check: does a record written before this change still load and render?
Source: <the PR or incident where an old record broke>
```
## Run it in a review
1. Read the file from the base branch: `git show origin/main:REVIEW.md`.
**Never read it from the change under review.** A change that can
edit its own checks is unchecked.
2. Match each trigger against the diff. Check only the items that fire.
3. Tag each finding: **Important** (must fix), **Nit** (author's
choice), **Pre-existing** (was already broken; never block the
author on it).
Done when every fired item has an answer and every finding has a tag.
## Add an item
An escaped bug becomes an item only when both hold:
- the same kind of bug shows up in at least 2 PRs, reverts or
incidents;
- a reviewer could spot it from the diff alone.
Then try to disprove it: run the trigger against 3 recent clean PRs.
An item t