From 06169e8c313bcb7e35591bdc96a1521338cee1d9 Mon Sep 17 00:00:00 2001
From: mateo-berri <277851410+mateo-berri@users.noreply.github.com>
Date: Tue, 21 Jul 2026 17:37:51 -0700
Subject: [PATCH 1/3] docs: add TLDR section to PR template

---
 .github/pull_request_template.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index d7e80b32749..5207e03fdc2 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -1,3 +1,8 @@
+## TLDR
+
+<!-- In a few plain-language sentences, state 1) the problem being solved and 2) how this PR solves it
+     This section must be extremely human parsable, comprehensible, and readable: its target audience is humans, not AI agents, so skip jargon and implementation minutiae and write it so a reviewer understands the PR from this section alone -->
+
 ## Relevant issues
 
 <!-- e.g., "Fixes #000" -->

From 06d2efdd56061bca67ded17d195ca8d39132acff Mon Sep 17 00:00:00 2001
From: mateo-berri <277851410+mateo-berri@users.noreply.github.com>
Date: Tue, 21 Jul 2026 17:42:25 -0700
Subject: [PATCH 2/3] docs: structure PR template TLDR into problem/solution
 bullets

---
 .github/pull_request_template.md | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 5207e03fdc2..bbe5845f5a9 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -1,7 +1,17 @@
 ## TLDR
 
-<!-- In a few plain-language sentences, state 1) the problem being solved and 2) how this PR solves it
-     This section must be extremely human parsable, comprehensible, and readable: its target audience is humans, not AI agents, so skip jargon and implementation minutiae and write it so a reviewer understands the PR from this section alone -->
+<!-- Fill in the bullets below and keep each one short and concrete
+     This section must be extremely human parsable, comprehensible, and readable: its target audience is humans, not AI agents -->
+
+Problem this solves:
+
+- <blah>
+- ...
+
+How it solves it:
+
+- <blah>
+- ...
 
 ## Relevant issues
 

From 4c1f071adde23df1bb5379f674fb490e8977226a Mon Sep 17 00:00:00 2001
From: mateo-berri <277851410+mateo-berri@users.noreply.github.com>
Date: Tue, 21 Jul 2026 17:44:02 -0700
Subject: [PATCH 3/3] docs: cap PR template TLDR bullets at one short line

---
 .github/pull_request_template.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index bbe5845f5a9..1301bfb0e60 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -1,6 +1,6 @@
 ## TLDR
 
-<!-- Fill in the bullets below and keep each one short and concrete
+<!-- Fill in the bullets below and keep each one short and concrete: one line per bullet, roughly 10 words max
      This section must be extremely human parsable, comprehensible, and readable: its target audience is humans, not AI agents -->
 
 Problem this solves: