Pull Request Templates

Devin can use GitHub-style pull request templates. It looks in your repository for the first matching template file and uses it when generating or regenerating a PR description. In addition to the standard GitHub filenames, Devin also supports a Devin‑specific variant so you can give Devin a different template than your human authors use.

1. Discovery Order

First match wins (top to bottom):
PULL_REQUEST_TEMPLATE/devin_pr_template.md
docs/PULL_REQUEST_TEMPLATE/devin_pr_template.md
.github/PULL_REQUEST_TEMPLATE/devin_pr_template.md
pull_request_template.md
docs/pull_request_template.md
.github/pull_request_template.md
The entries with devin_pr_template.md are optional Devin‑specific overrides. If none exist, the standard pull_request_template.md locations are used. If nothing matches, Devin falls back to its built‑in default structure.

2. Custom Devin Template (optional)

Add a Devin‑only template by creating one of:
.github/PULL_REQUEST_TEMPLATE/devin_pr_template.md
docs/PULL_REQUEST_TEMPLATE/devin_pr_template.md
PULL_REQUEST_TEMPLATE/devin_pr_template.md
Use this if you want Devin to include extra structure (e.g. risk checklist hints) without changing what humans see in their usual pull_request_template.md. If you prefer a single shared template, just keep (or add):
.github/pull_request_template.md
Placeholders and HTML comments will be cleaned up naturally.

3. Built‑in Default (if no file found)

If no template file exists, Devin uses an internal default with sections for:
  • Summary
  • Review & Testing Checklist
  • (Optional) Mermaid diagram
  • Notes
You do not need to copy this unless you want to customize it; supplying any of the supported files above completely replaces the default.

4. GitHub Reference

Devin follows GitHub’s single‑file template resolution rules. For more about GitHub PR templates (including multi‑template workflows), see here.
Minimal setup to give Devin its own template:
mkdir -p .github/PULL_REQUEST_TEMPLATE
echo "# [title]\n\n## Summary\n...\n" > .github/PULL_REQUEST_TEMPLATE/devin_pr_template.md
That’s it—open or regenerate a PR and Devin will use it.