AI proposes. A person decides.

A beginner guide to AI-assisted PR review. The AI never posts a comment until a person accepts it. Six steps, three verdicts, and the kit that makes the metrics real.

The rule

No AI comment reaches the pull request until a person accepts it. The AI never approves.

Self-review

The author runs the bot first and fills the PR template.

PR Brief

One page: what changed, risk map, test gaps. Then choose quick, normal, or deep.

Findings queue

AI proposes into a log. A person marks accept, reject, or defer.

Proof to block

A blocking finding needs a failing test or a clear reproduction.

Artifacts

PR template, PR Brief, risk checklists, findings log, reviewer rules, golden set, weekly scorecard.

Takeaway

The bot talks in a queue. The signal is what a person accepted and kept. Measure acted-on, noise, recall, and right line.