From 1ad74d46d632b268ff89bf0dbdf6ee825da9d9c9 Mon Sep 17 00:00:00 2001
From: Paul Bottein <paul.bottein@gmail.com>
Date: Thu, 12 Feb 2026 13:33:54 +0100
Subject: [PATCH] Improve PR template and add AI agent instructions (#29590)

* Improve PR template and add AI agent instructions

Move screenshots section closer to proposed change for better flow, and add instructions in copilot-instructions.md to ensure AI agents use the PR template when creating pull requests.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Instruct AI agents to not check checklist items on behalf of the user

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Remind user to add screenshots for UI changes after creating PR

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
---
 .github/PULL_REQUEST_TEMPLATE.md | 16 ++++++++--------
 .github/copilot-instructions.md  |  4 ++++
 2 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 05334ca211..ed65e28741 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -21,6 +21,14 @@
 -->
 
 
+## Screenshots
+<!--
+  If your PR includes visual changes, please add screenshots or a short video
+  showing the before and after. This helps reviewers understand the impact of
+  your changes.
+  Note: Remove this section if this PR has no visual changes.
+-->
+
 ## Type of change
 <!--
   What type of change does your PR introduce to the Home Assistant frontend?
@@ -35,14 +43,6 @@
 - [ ] Breaking change (fix/feature causing existing functionality to break)
 - [ ] Code quality improvements to existing code or addition of tests
 
-## Screenshots
-<!--
-  If your PR includes visual changes, please add screenshots or a short video
-  showing the before and after. This helps reviewers understand the impact of
-  your changes.
-  Note: Remove this section if this PR has no visual changes.
--->
-
 ## Additional information
 <!--
   Details are important, and help maintainers processing your PR.
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
index 08fc7bb9c9..dd96b1f316 100644
--- a/.github/copilot-instructions.md
+++ b/.github/copilot-instructions.md
@@ -558,6 +558,10 @@ this.hass.localize("ui.panel.config.updates.update_available", {
 - Use HTTPS - All external resources must use HTTPS
 - CSP compliance - Ensure code works with Content Security Policy
 
+### Pull Requests
+
+When creating a pull request, you **must** use the PR template located at `.github/PULL_REQUEST_TEMPLATE.md`. Read the template file and use its full content as the PR body, filling in each section appropriately. Do not omit, reorder, or rewrite the template sections. Do not check the checklist items on behalf of the user — those are the user's responsibility to review and check. If the PR includes UI changes, remind the user to add screenshots or a short video to the PR after creating it.
+
 ### Text and Copy Guidelines
 
 #### Terminology Standards