Agent disclosure

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)