Back to Docs
Recipe

PR Template Patterns

Structured pull-request templates that enforce consistency, speed up review cycles, and keep your team aligned on what matters.

Minimal Starter

## What
<!-- 1-2 sentence summary -->

## Why
<!-- Link issue or context -->

## Screenshots
<!-- Before/after if UI change -->

Full-Featured

### Summary
Closes #

### What changed
- 

### Testing
- [ ] Unit
- [ ] Manual

### Rollback plan
<!-- Feature flag, revert commit, etc -->

Rules of Thumb

  • Keep checklists under 7 items — beyond that people skim.
  • Put the “why” before the “what” — reviewers need context first.
  • Include a rollback or revert plan for any data-mutating change.
  • Use HTML comments (<!-- -->) for guidance that disappears on render.

GitHub Setup

Drop your template at .github/PULL_REQUEST_TEMPLATE.md and GitHub auto-populates every new PR. For multiple templates, use query params with .github/PULL_REQUEST_TEMPLATE/.

Next: explore Code Review Rituals to pair these templates with a review cadence that actually ships.