← Library06 Playbooks

review

Code Review

06 Playbooks/Code Review.md

Code Review

Review behavior before style.

Passes

  1. Intent: does the change match the stated problem and scope?
  2. Correctness: invariants, boundaries, state transitions, error paths, concurrency.
  3. Security/privacy: trust boundaries, authorization, injection, secret and personal-data handling.
  4. Operations: migrations, compatibility, observability, rollout, rollback.
  5. Tests: meaningful behavior, negative cases, determinism, missing regression coverage.
  6. Maintainability: naming, duplication, coupling, complexity, documentation.

Useful finding format

[Severity] Short title — file:line
Scenario: what conditions trigger the issue?
Impact: what fails or becomes unsafe?
Correction: smallest practical change.

Avoid vague preferences and speculative concerns without a concrete failure scenario.

Knowledge connections