From 4eb7f666a451cc9a88c63ab50b84d0eb4998f660 Mon Sep 17 00:00:00 2001
From: mateo <mateo@berri.ai>
Date: Sat, 31 Oct 2026 21:36:04 +0000
Subject: [PATCH] docs(pr-template): mark the agent-drafted summary with a
 visible Make me human-readable warning block

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
---
 .github/PULL_REQUEST_TEMPLATE/general.md | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE/general.md b/.github/PULL_REQUEST_TEMPLATE/general.md
index aafd968ee0f..fb70614364b 100644
--- a/.github/PULL_REQUEST_TEMPLATE/general.md
+++ b/.github/PULL_REQUEST_TEMPLATE/general.md
@@ -9,15 +9,16 @@
 <!-- The PR author rewrites this in their own words before asking for review. Being able to sum up the PR in a few
      plain sentences proves the author understands what it does, and human-written technical English is far easier
      for a reviewer to parse than AI-written English
-     An AI agent may draft a starting point here, but always wraps its draft in the make-me-human-readable tags below,
-     backticks included so the tags stay visible on GitHub, so nobody mistakes it for the author's words. The author rewrites it in their own words and deletes the tags.
-     Tags still present at review time mean the summary is AI-written and has not been rewritten yet
+     An AI agent may draft a starting point here, but always puts its draft inside the "Make me human-readable" warning
+     block below so nobody mistakes it for the author's words. The author replaces the whole block with their own
+     plain-paragraph version. A warning still present at review time means the summary is AI-written and not rewritten yet
      Say what the PR does for users and why, then anything that keeps it working over time (a sync job, a config someone owns)
      No bullets, tables, or code names here. Everything else goes inside the Details block below -->
 
-`<make-me-human-readable>`
-<blah>
-`</make-me-human-readable>`
+> [!WARNING]
+> Make me human-readable. An AI drafted this summary, so rewrite it in your own words to help the reviewer follow what the PR does, then replace this whole block with your version
+>
+> <blah>
 
 <details>
 <summary>Details</summary>