Workflow Code Review

Self-Review Before Submitting

Checklist to run on your own changes before opening a PR

reviewqualitychecklist
CLAUDE.md

Before submitting your changes for review:

  1. Read the full diff yourself. Look at every file you changed as if reviewing someone else’s code.
  2. Verify all tests pass. Run the full suite, not just the tests you added.
  3. Check for accidental changes: debug logs, commented-out code, unrelated formatting changes.
  4. Verify no secrets, .env files, or build artifacts are staged.
  5. Confirm your commit messages explain why, not just what.
  6. If there’s a UI change, test it in the browser at mobile and desktop widths.
  7. Check that your change doesn’t break the build or type checker.

Copy this workflow into your CLAUDE.md or agent config file so your agent follows this process automatically.

get crystl