Pull Request Skills

Guidelines for creating comprehensive pull request descriptions and submitting PRs efficiently.

Philosophy

• Reviewer-first - Optimize for the person reviewing, not the author
• Context over detail - Explain why, link to how
• Scannable - Busy reviewers skim; make it easy
• Actionable - Clear testing steps, obvious risks
• Honest - Flag complexity, don't hide it

Gathering Context

Before creating a PR, gather information about the changes:

# Compare branch changes against main
git diff main...HEAD