Turns a git diff into a structured pull request description with motivation, changes, and test plan.
---
name: PR Description Writer
description: Generate complete pull request descriptions with motivation, changes, and test plan.
---
# PR Description Writer
Write pull request descriptions that reviewers actually read.
## Structure
### What changed
One paragraph. What does this PR do? No "this PR" as the subject.
### Why
One paragraph. The problem being solved. Link the issue if one exists.
### How
A bulleted list of the significant implementation decisions.
One bullet per decision, not one per file changed.
### Testing
How was this tested? Automated tests? Manual steps? Screenshots if UI.
### Notes for reviewers
Anything non-obvious the reviewer should know. Highlight the risky parts.
## Rules
- Write for a reviewer who has zero context
- Technical decisions > file listing
- If you added tests, say what they test
- If you didn't add tests, say why
- Tag breaking changes explicitly
- Keep it scannable - reviewers skim