From 18aac9e6b9872f4641c36219abbed35e02b76fcc Mon Sep 17 00:00:00 2001
From: George Sapkin <george@sapk.in>
Date: Wed, 14 Oct 2026 18:59:53 +0300
Subject: [PATCH 1/3] CONTRIBUTING.md: add AI policy

Add a policy requiring human-written comments and contributions, with a
human in the loop responsible for LLM-generated code.

Signed-off-by: George Sapkin <george@sapk.in>
---
 CONTRIBUTING.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 7266b3e40c5293..86da118011af2a 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -25,6 +25,33 @@ prompts given to the automated LLM reviewer.
 - [Project-wide LLM review guidelines](https://github.com/openwrt/actions-shared-workflows/tree/main/llm-review-prompts)
 - [Packages repository-specific LLM review addendum](https://github.com/openwrt/packages/blob/master/.github/llm-review-rules.md)
 
+## AI policy
+
+> [!WARNING]
+> You **must** disclose any LLM usage in your pull request, description or
+> commit messages.
+
+We support the use of LLMs for coding, but we hold a high bar for all
+contributions, and we expect a human in the loop who genuinely understands the
+work an LLM produces on their behalf.
+
+> [!IMPORTANT]
+> Don't rely on LLMs to write the whole thing for you when communicating with
+> the maintainers, and don't post wall-of-text comments.
+
+We expect comments on our projects to be written by humans. The readers are
+humans, and we'd like to hear from you, not from a model. We may hide or remove
+any comments that we believe are LLM-generated.
+
+If you're using an LLM to edit or – as a non-native English speaker – to
+translate your comments, keep them short, review before posting, and make sure
+they say what you mean.
+
+> [!CAUTION]
+> Do not use autonomous agents for contributing to our projects.
+
+We will close any pull requests that we believe were created autonomously.
+
 ## Package Sources (archives and repositories)
 
 - <strong>PKG_SOURCE</strong> should reference the smallest available archive. In order of

From 833d23cfa41eb5a327884e7e094b314b34c323d4 Mon Sep 17 00:00:00 2001
From: George Sapkin <george@sapk.in>
Date: Fri, 16 Oct 2026 00:36:49 +0300
Subject: [PATCH 2/3] pull_request_template.md: improve formatting and phrasing

Hide comment sections from being displayed in the PR template.

Add a helpful Markdown tip.

Signed-off-by: George Sapkin <george@sapk.in>
---
 .github/pull_request_template.md | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 237d0d5f9ca9c7..0b1b92fc2d6bb8 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -1,14 +1,14 @@
 ## 📦 Package Details
 
-**Maintainer:** @<github-user>
-<sub>(You can find this by checking the history of the package `Makefile`.)</sub>
+**Maintainer:** @\<github-user\>
+<!-- You can find this by checking the history of the package `Makefile`. -->
 
 **Description:**
-<!-- Briefly describe what this package does or what changes are introduced -->
+<!-- Briefly describe what this package does or what changes are introduced. -->
 
 ---
 
-## 🧪 Run Testing Details
+## 🔬 Run Testing Details
 
 - **OpenWrt Version:**
 - **OpenWrt Target/Subtarget:**
@@ -18,15 +18,15 @@
 
 ## ✅ Formalities
 
-- [ ] I have reviewed the [CONTRIBUTING.md](https://github.com/openwrt/packages/blob/master/CONTRIBUTING.md) file for detailed contributing guidelines.
+<!-- Mark required fields like so: [x] -->
+
+- [ ] I have reviewed the [contributing guidelines](https://github.com/openwrt/packages/blob/master/CONTRIBUTING.md).
 
 ### If your PR contains a patch:
 
 - [ ] It can be applied using `git am`
-- [ ] It has been refreshed to avoid offsets, fuzzes, etc., using
-  ```bash
-  make package/<your-package>/refresh V=s
-  ```
+- [ ] It has been refreshed to avoid offsets, fuzzes, etc.
+    <!-- You can do this using: make package/<your-package>/refresh V=s -->
 - [ ] It is structured in a way that it is potentially upstreamable
-<sub>(e.g., subject line, commit description, etc.)</sub>
-<sub>We must try to upstream patches to reduce maintenance burden.</sub>
+    <!-- This relates to the header, subject, commit description, etc. -->
+    <!-- We must try to upstream patches to reduce maintenance burden. -->

From 442fc178bf3a12e3b96d791dbd812208b15eaeaf Mon Sep 17 00:00:00 2001
From: George Sapkin <george@sapk.in>
Date: Fri, 16 Oct 2026 00:38:19 +0300
Subject: [PATCH 3/3] pull_request_template.md: add LLM usage disclosure
 checkbox

Add a link to the AI policy and a LLM usage disclosure checkbox.

Signed-off-by: George Sapkin <george@sapk.in>
---
 .github/pull_request_template.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 0b1b92fc2d6bb8..db0cdfc62e6828 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -21,6 +21,9 @@
 <!-- Mark required fields like so: [x] -->
 
 - [ ] I have reviewed the [contributing guidelines](https://github.com/openwrt/packages/blob/master/CONTRIBUTING.md).
+- [ ] I have reviewed the [AI policy](https://github.com/openwrt/packages/blob/master/CONTRIBUTING.md#ai-policy).
+    - [ ] I have used AI or LLM in my pull request, description, or commit
+          messages.
 
 ### If your PR contains a patch: