From 5b75b7662c73683c15099bcefb33418f92c9760f Mon Sep 17 00:00:00 2001
From: Altay <altay@hey.com>
Date: Mon, 5 Oct 2026 08:31:49 +0300
Subject: [PATCH] docs(github): ask for one visual aid in pull request bodies

---
 .github/pull_request_template.md | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 38d574a7..b27d4521 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -1,16 +1,17 @@
 ## Change
 
-<!-- Describe the problem and resulting behavior. Include material risks. -->
+<!-- One sentence on the outcome, then one visual aid: a screenshot or short
+recording for UI, a Mermaid diagram for a flow, a table for numbers, or a short
+code sample for an API. Add one-line bullets only for risks the aid doesn't
+show. No test counts, command logs, file lists, or review history. -->
 
 ## Validation
 
 - [ ] Code changes: `./gradlew verify` and `./gradlew :mobile:assembleProductionDebug :tv:assembleProductionDebug`
 - [ ] Proof for each matching row of the AGENTS.md proof map
 
-<!-- Docs-only changes need no build; run `./gradlew markdownCheck` and check
-the links and commands you touched. Emulator flows and attached captures apply
-only to the rows that ask for them. When local proof used `putioSdkKotlinPath`,
-record the app and SDK SHAs and `git status --short` for both worktrees. Attach
-reviewed screenshots or recordings from `.evidence/` with `gh pr create --attach`
-or `gh pr comment <n> --attach`; never commit them. Name skipped checks and
-unresolved failures. Remove this comment when writing the description. -->
+<!-- Docs-only changes need no build; run `./gradlew markdownCheck`. When local
+proof used `putioSdkKotlinPath`, record the app and SDK short SHAs. Attach
+reviewed captures from `.evidence/` with `gh pr create --attach`; never commit
+them. End with one "Unverified:" line for skipped or unavailable proof. Remove
+this comment when writing the description. -->