From 196a99e912199a4a9874901fc70f8cc96d2ab899 Mon Sep 17 00:00:00 2001
From: Mike Farah <mikefarah@gmail.com>
Date: Sat, 6 Jun 2026 19:13:33 +1000
Subject: [PATCH] Agent disclosure

---
 AGENTS.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index ab01c69c..d7b6eeab 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,5 +1,28 @@
 # yq — agent instructions
 
+## ⚠️ MANDATORY: GitHub agent disclosure
+
+**Always required. No exceptions.**
+
+Whenever you perform **any** GitHub action on my behalf, you **must** disclose that an AI agent (Cursor) wrote the content and is acting on my behalf — **not me personally**. Do this **before** submitting; never post first and add the disclosure later.
+
+Applies to **all** GitHub interactions, including:
+
+- Pull requests (titles, descriptions, and reviews)
+- PR comments and inline review comments
+- Issues (new issues, comments, and updates)
+- Any other post or reply on GitHub
+
+**How to disclose:** Put it prominently at the **top** of every PR description, review body, comment, or issue. Use wording like:
+
+> **Note:** This was generated by [Cursor](https://cursor.com) acting on my behalf — not written by me personally.
+
+Inline review comments must include a short disclosure too (e.g. `> Generated by Cursor acting on my behalf, not me personally.`).
+
+**Never** submit a GitHub action without this disclosure.
+
+---
+
 Always run the spellcheck before raising a PR:
 
 ```bash
@@ -60,10 +83,12 @@ export PATH="$HOME/go/bin:$PATH"
 - Add comprehensive tests to cover the changes
 - Run test suite to ensure there is no regression
 - Use UK english spelling
+- **Follow the mandatory GitHub agent disclosure rule above** on every GitHub action — no exceptions
 
 ❌ **DON'T:**
 - Git add or commit
 - Add comments to functions that are self-explanatory
+- **Post to GitHub without the mandatory agent disclosure** (PRs, reviews, comments, issues, or any other GitHub interaction)