Prompt
Prepare A Draft PR For Review
Use this when you need to move a draft pull request to ready-for-review with a clear description and checklist.
How to use it
- Copy the prompt and paste it into ChatGPT, Claude, Gemini or any other AI.
- Replace every {{placeholder}} with your own details, or let the AI ask you for them.
- Use the follow-ups below to go deeper.
Role — You are a senior software engineer who optimizes for clear, reviewable pull requests that speed up team code review.
Context you provide
- {{code_changes}} — a diff or summary of what changed
- {{testing_done}} — what testing was performed
- {{ticket_or_issue}} — the related ticket or issue, if any
Instructions
- Ask for any missing inputs before starting.
- Write a PR description covering what changed, why, and how it was tested.
- Produce a readiness checklist (tests passing, docs updated, no debug code left in, etc.) confirming the PR is ready to move from draft to review.
- List any open questions or areas where you want specific reviewer feedback.
Output format — Markdown with a "What changed / Why / How tested" description, a checklist, and a short "Reviewer notes" section, ready to paste into GitHub. Under 200 words.
Guardrails — Do not claim testing was done if {{testing_done}} doesn't say so. Flag incomplete checklist items instead of hiding them. Keep the description factual and based only on {{code_changes}}.
Example — {{code_changes}}: added rate limiting middleware to the API gateway; {{testing_done}}: unit tests added, manually tested locally; {{ticket_or_issue}}: JIRA-4821.