diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 000000000000..35f01ce84e67
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,35 @@
+# Agents
+
+## Cursor Cloud specific instructions
+
+### Overview
+Elementor is a WordPress page builder plugin. The codebase is a monorepo with two main areas:
+- **Root**: WordPress plugin (PHP + legacy JS/SCSS), built via Grunt + Webpack
+- **`packages/`**: Turborepo-managed TypeScript micro-frontend packages (~47 packages: core apps, shared libs, build tools), built via tsup
+
+### Prerequisites
+- **Node.js 20.19** (see `.nvmrc`): `nvm use 20.19`
+- **PHP >= 7.4** with extensions: `mbstring`, `xml`, `curl`, `zip`, `mysql`, `gd`, `bcmath`
+- **Composer** for PHP dependency management
+
+### Key commands
+All standard dev commands are in `package.json` and documented in `CONTRIBUTING.md`. Key ones:
+- `npm ci --ignore-scripts && composer install` — install all dependencies
+- `npm run build:packages` — build turbo-repo packages (required before lint/test)
+- `npx grunt styles` / `npx grunt scripts` — build legacy CSS/JS assets
+- `npm run watch` — full dev mode with file watching (packages + styles + scripts)
+- `npm run lint` — ESLint for root repo + packages lint (ESLint + tsc)
+- `npm run test:jest` — Jest tests for main repo (691 tests)
+- `npm run test:packages` — Jest tests for turbo-repo packages (2504 tests)
+- `npm run wp-playground` — start WordPress Playground dev server on port 9400 (credentials: admin/password)
+
+### Running the application locally
+Use `npm run wp-playground` to start a WordPress Playground instance with Elementor mounted and activated. This is simpler than Docker-based `wp-env`. The server runs on `http://localhost:9400` with `admin`/`password` credentials.
+
+### Gotchas
+- `npm ci --ignore-scripts` is intentional — the repo uses npm workspaces and `--ignore-scripts` avoids running lifecycle hooks that may fail outside CI. Composer's `post-install-cmd` runs php-scoper and dump-autoload automatically.
+- Turbo-repo packages must be built (`npm run build:packages`) before running root ESLint or Grunt webpack, since built package outputs are referenced.
+- The `packages/` workspace has its own separate `lint` command (`npm run lint -w elementor-packages`) which runs both ESLint and TypeScript type checking concurrently.
+- PHP tests (`npm run test:php`) require Docker with a MySQL container (via `docker-compose.yml`). They are not runnable without Docker.
+- Playwright E2E tests require a running WordPress server and `npx playwright install chromium`.
+- The `.husky/pre-commit` hook runs `lint-staged` with `NODE_OPTIONS=--max-old-space-size=8192`.