From 63d72872953fa36309f9967df971347551840451 Mon Sep 17 00:00:00 2001
From: Eric T <tchepane@hey.com>
Date: Wed, 20 Aug 2025 23:41:32 +0100
Subject: [PATCH] chore: adopt detailed PR template

---
 .github/pull_request_template.md | 24 ++++++++++++++++++------
 1 file changed, 18 insertions(+), 6 deletions(-)

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index c138df3..62b0ede 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -1,8 +1,20 @@
-## Summary
-<!-- Describe the changes introduced by this pull request. -->
+## Why now?
+<!-- Explain the problem, context, and why this change is needed. Link to the issue. -->
+Related issue: #____
 
-## Testing
-<!-- Describe how the changes were tested. -->
+## What changed?
+<!-- Brief summary; suggest where to start reviewing if many files. -->
 
-## Issues
-<!-- Link any related issues. -->
+## BREAKING
+<!-- If applicable, call it out explicitly. -->
+<!-- ⚠️ BREAKING: Describe migration or impact. -->
+
+## Review focus
+<!-- Ask for specific feedback, e.g., "Concurrency strategy OK?" or "API shape acceptable?" -->
+
+## Checklist
+- [ ] Scope ≤ 300 lines (or split/stack)
+- [ ] Title is **verb + object** (e.g., “Refactor auth middleware to async”)
+- [ ] Description links the issue and answers “why now?”
+- [ ] **BREAKING** flagged if needed
+- [ ] Tests/docs updated (if relevant)