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] 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