From 53b612cd7392f6c9675796fb3f502fc6fa3a2271 Mon Sep 17 00:00:00 2001
From: Ramesh Padmanabhaiah <codeforester@gmail.com>
Date: Wed, 3 Jun 2026 19:47:16 -0700
Subject: [PATCH] docs: expand pull request template

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

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 0dbca55..24be7f5 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -1,6 +1,6 @@
 ## Summary
 
--
+<!-- What changed and why. Focus on decisions and user impact, not just the diff. -->
 
 ## Issue
 
@@ -8,12 +8,22 @@ Closes #
 
 ## Validation
 
--
+<!-- Commands run and relevant output. Include narrow checks and any broader suite used. -->
 
 ## Demo Impact
 
-None.
+<!-- None. / Or: what demo changed or should be updated. -->
 
 ## Notes
 
-None.
+<!-- Optional: tradeoffs, follow-up work, or reviewer context. -->
+
+## Checklist
+
+- [ ] Branch name follows `<category>/<issue>-<YYYYMMDD>-<slug>`.
+- [ ] PR is scoped to one issue, unless a documented multi-issue exception applies.
+- [ ] PR body explains what changed and how it was validated.
+- [ ] Relevant BATS and Python tests pass.
+- [ ] Documentation is updated when behavior or user-facing commands change.
+- [ ] PR includes `Fixes #<issue>` or `Closes #<issue>` when it should close the issue.
+- [ ] `Demo Impact` is meaningful for `needs-demo` work, or explicitly says `None.`