docs: scope userscripts guidelines to userscripts/AGENTS.md and keep root AGENTS.md repo-wide

Author: tazztone

AGENTS.md

@@ -6,20 +6,11 @@
   ```bash
   userscripts/venv/bin/pytest
   ```
-- Run only userscript end-to-end tests:
-  ```bash
-  userscripts/venv/bin/pytest userscripts/
-  ```
 - Run only Python tests:
   ```bash
   userscripts/venv/bin/pytest python/
   ```
-- Verify userscript JavaScript syntax before committing:
+- Run only Userscript tests:
   ```bash
-  node --check userscripts/<project>/<name>.user.js
+  userscripts/venv/bin/pytest userscripts/
   ```
-
-## Versioning & Git Commits
-
-- Do not manually increment userscript patch `@version` headers for routine changes; the `.git/hooks/pre-commit` hook (`userscripts/bump_version_precommit.py`) automatically increments patch numbers on staged `*.user.js` files and synchronizes adjacent `README.md` install links.
-- When committing changes touching userscripts, ensure write access is permitted for pre-commit hook execution.

userscripts/AGENTS.md

@@ -0,0 +1,17 @@
+# Userscripts Agent Guidelines
+
+## Testing & Verification
+
+- Run userscript end-to-end browser tests using the shared virtualenv:
+  ```bash
+  userscripts/venv/bin/pytest userscripts/
+  ```
+- Verify JavaScript syntax before committing:
+  ```bash
+  node --check userscripts/<project>/<name>.user.js
+  ```
+
+## Versioning & Git Commits
+
+- Do not manually increment userscript patch `@version` headers for routine changes; the `.git/hooks/pre-commit` hook (`userscripts/bump_version_precommit.py`) automatically increments patch numbers on staged `*.user.js` files and synchronizes adjacent `README.md` install links.
+- When committing changes touching userscripts, ensure write access is permitted for pre-commit hook execution.