GuidesShowcase

Coding-agent PR packet

A review packet that makes an agent-written diff inspectable before merge.

Worked example

Coding-agent PR packet

A solo builder lets an agent fix a UI bug and needs proof that the change is narrow, tested, and reversible.

Tools4Steps4ArtifactPR packet: intent, diff map, proof, residual risk, rollback.
Tools used in this walkthrough
Scenario
A solo builder lets an agent fix a UI bug and needs proof that the change is narrow, tested, and reversible.
Output artifact

PR packet: intent, diff map, proof, residual risk, rollback.

Final artifact this walkthrough produces.

Write the intent lock and non-goals.

Write the intent lock and non-goals.

Generate one constrained implementation.

Generate one constrained implementation.

Ask a second model for diff-only failure modes.

Ask a second model for diff-only failure modes.

Attach validation output, risks, and rollback note.

Attach validation output, risks, and rollback note.

Quality checks

The walkthrough is only done when: PR packet: intent, diff map, proof, residual risk, rollback. survives these checks.

  • Every changed file maps to the stated intent.
  • At least one plausible failure mode is handled explicitly.
  • The packet states what was not checked.