docs: Add AGENTS.md with branch naming and CI guidelines

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

Author: mattbodle

AGENTS.md

@@ -0,0 +1,46 @@
+# Agent Guidelines
+
+Instructions for AI agents working on this repository.
+
+## Branch Naming
+
+Branch names **must** start with one of the following prefixes (enforced by CI):
+
+- `build/`
+- `chore/`
+- `ci/`
+- `docs/`
+- `feat/`
+- `fix/`
+- `perf/`
+- `refactor/`
+- `revert/`
+- `style/`
+- `test/`
+
+Use the prefix that matches the type of change (e.g., `feat/adblock-measurement`, `fix/iframe-cleanup`). This aligns with the conventional commit types documented in `CONTRIBUTING.md`.
+
+## Git Push (SAML SSO)
+
+The `mparticle-integrations` GitHub org enforces SAML SSO. SSH push will fail. To push:
+
+1. Run `gh auth setup-git` to configure the git credential helper.
+2. Temporarily switch the remote to HTTPS: `git remote set-url origin https://github.com/mparticle-integrations/mparticle-javascript-integration-rokt.git`
+3. Push the branch.
+4. Restore the SSH remote: `git remote set-url origin git@github.com:mparticle-integrations/mparticle-javascript-integration-rokt.git`
+
+## Running Tests
+
+```bash
+npm install
+npm test -- --browsers ChromeHeadless  # FirefoxHeadless may not be available
+```
+
+## Linting
+
+```bash
+npm run lint       # check
+npm run lint:fix   # auto-fix
+```
+
+Always run lint before pushing. The CI enforces Prettier formatting.