Skip to content

docs: 📝 Say which parts of a PR the maintainer checks by eye - #228

Merged
ShisatoYano merged 1 commit into
mainfrom
docs/review-scope
Nov 14, 2026
Merged

ShisatoYano merged 1 commit into
mainfrom
docs/review-scope

Conversation

@ShisatoYano

Copy link
Copy Markdown
Owner

Summary

  • Add .claude/skills/pr-review/references/review-scope.md: PR types (A minor, B new algorithm, C shared components, D book text, E design or scope) and what the maintainer checks by eye for each
  • pr-review now classifies each PR, starts its report with the places the maintainer checks, shows the last frames on main and the PR side by side for type C, and says what changed in the project after a merge

Why

Reviews were done almost entirely by Claude Code, which made it hard for the maintainer to keep track of the project's state. The automated review keeps doing what can be checked by running or against the conventions; the maintainer checks what decides the project's direction and content.

The last-frame comparison is a stopgap until #174 adds scenario tests and the contact sheet.

🤖 Generated with Claude Code

Reviews were done almost entirely by Claude Code, so the maintainer
lost track of the project's state. Each PR is now classified by type,
and the review report starts with the places the maintainer checks.
For shared components, the smoke tests don't catch a change in
behavior, so the review shows the last frames on main and the PR
side by side. After a merge, the review says what changed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ShisatoYano ShisatoYano added the documentation Improvements or additions to documentation label Nov 14, 2026
@ShisatoYano ShisatoYano self-assigned this Nov 14, 2026
@ShisatoYano
ShisatoYano merged commit 7513405 into main Nov 14, 2026
3 checks passed
@ShisatoYano
ShisatoYano deleted the docs/review-scope branch November 14, 2026 06:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant