From b776157c9500ddcee0eee3896ffe220f158e165a Mon Sep 17 00:00:00 2001
From: iztaylor <ztaylor@servicetitan.com>
Date: Thu, 18 Jun 2026 10:10:55 -0400
Subject: [PATCH] docs: cross-tool entry points (AGENTS.md, Cursor rule,
 mcp.json example)

---
 .cursor/mcp.json.example      | 12 ++++++++++++
 .cursor/rules/arcade-eval.mdc | 19 +++++++++++++++++++
 AGENTS.md                     | 21 +++++++++++++++++++++
 3 files changed, 52 insertions(+)
 create mode 100644 .cursor/mcp.json.example
 create mode 100644 .cursor/rules/arcade-eval.mdc
 create mode 100644 AGENTS.md

diff --git a/.cursor/mcp.json.example b/.cursor/mcp.json.example
new file mode 100644
index 0000000..99ff747
--- /dev/null
+++ b/.cursor/mcp.json.example
@@ -0,0 +1,12 @@
+{
+  "_comment": "Copy to .cursor/mcp.json (git-ignored) and fill slug + headers. Header names per LIVE-POC.md (confirmed in Task 1.1). Use your own user_id value.",
+  "mcpServers": {
+    "arcade-eval": {
+      "url": "https://api.arcade.st.dev/mcp/<slug>",
+      "headers": {
+        "Authorization": "Bearer ${ARCADE_API_KEY}",
+        "<user-id-header>": "<your-user-id>"
+      }
+    }
+  }
+}
diff --git a/.cursor/rules/arcade-eval.mdc b/.cursor/rules/arcade-eval.mdc
new file mode 100644
index 0000000..7cf137d
--- /dev/null
+++ b/.cursor/rules/arcade-eval.mdc
@@ -0,0 +1,19 @@
+---
+description: Arcade eval lane bootstrap — read order, live-state check, lane ownership
+alwaysApply: true
+---
+
+You are working in the arcade-eval repo (Arcade.dev MCP-gateway evaluation).
+
+Before working: read README.md → STATUS.md → LIVE-POC.md → GROUND-RULES.md (in that order),
+then run the live-state check described in GROUND-RULES.md.
+
+Working rules:
+- Write only inside your own categories/catN-*/ subtree and your own STATUS.md section.
+- Shared files (config/targets.yaml, lib/, top-level docs) are append-mostly; `git pull --rebase` before push.
+- Credentials live only in .env (git-ignored) — never commit them.
+- Never edit the criteria Google Doc from a session; compose criteria-section-N.md locally, the human pastes. Criterion wording is verbatim.
+
+Connecting Cursor as an MCP client: copy .cursor/mcp.json.example to .cursor/mcp.json
+(git-ignored) and fill the gateway slug + headers. Cursor is itself a required cat-1 client
+to verify (criteria: "Claude Code, Cursor, LangGraph, internal agent frameworks").
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..c468ea5
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,21 @@
+# AGENTS.md — arcade-eval
+
+Cross-agent entry pointer (Cursor, Claude Code, and other agent tools honor this file).
+This repo is the tool-agnostic source of truth for the Arcade.dev MCP-gateway evaluation.
+
+## Before doing anything
+1. `git pull` (on rejection, `git pull --rebase`). `cp config/.env.example .env` and fill creds.
+2. Read, in order: **`README.md` → `STATUS.md` → `LIVE-POC.md` → `GROUND-RULES.md`**.
+3. Run the **live-state check** (in `GROUND-RULES.md`) before trusting the live instance.
+
+## Working rules (full text in GROUND-RULES.md)
+- Write only inside **your** `categories/catN-*/` subtree + your own `STATUS.md` section.
+  Shared files (`config/targets.yaml`, `lib/`, top-level docs) are append-mostly; `git pull
+  --rebase` before push.
+- **Credentials live only in `.env`** — never commit them.
+- **Never write the criteria Google Doc from a session** — compose `criteria-section-N.md`
+  locally; the human pastes. Criterion wording is verbatim.
+
+## Connecting an MCP client
+Gateway URL pattern: `https://api.arcade.st.dev/mcp/{slug}`. Cursor users: see
+`.cursor/mcp.json.example`. Claude Code users: `claude mcp add --transport http …`.