1 min lesson
The PR is the unit of trust
Take this situation: "An engineer says 'the agent already explained its reasoning in the chat, why do we still need a tidy PR description?' How do you respond?" Lead with your decision, then add the reason.
Step 1 of 2
Everything an AI writes is a draft until it lands as a pull request.
The PR is where intent, change, evidence and human accountability fuse into one reviewable, revertable, auditable artifact. Internalize one idea from this module and make it the unit of trust is the PR. Not the diff. Not the chat transcript. Not the agent run.
Why the PR and not the commit or the agent output? A PR is the smallest object that carries all four things an enterprise needs at once:
- A bounded scope (blast radiusHow much breaks if a change goes wrong; the scope of potential damage. Press Enter for the full definition. you can reason about).
- A description (the intent and the why).
- A set of checks (the evidence).
- An approval (the human who is now accountable).
A raw agent transcript has none of these as durable, queryable records. Picture your ITGCIT General Controls. The baseline IT controls auditors check: who can change what, how changes get approved and how systems are run. Press Enter for the full definition. auditor six months from now, pulling that PR and asking three things: