diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..6a7a41f
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,25 @@
+# AGENTS.md
+
+## Cursor Cloud specific instructions
+
+### Project overview
+
+CORE Events is a frontend-only React SPA (no backend, no database). All data is hardcoded in `constants.ts` and persisted via browser `localStorage`. See `README.md` for full feature description and design system guide.
+
+### Running the app
+
+```bash
+npm run dev     # Starts Vite dev server on http://localhost:3000
+npm run build   # Production build to dist/
+npm run preview # Preview production build
+```
+
+### Key caveats
+
+- **Node.js 20+ required** — `@vitejs/plugin-react` requires `^20.19.0 || >=22.12.0`. Node 18 produces engine warnings and may fail on future updates.
+- **No test framework** — There are no automated tests (no Jest, Vitest, Playwright, etc.) configured in this project. `npm run build` and `npx tsc --noEmit` are the closest checks available.
+- **Pre-existing TS errors** — `npx tsc --noEmit` reports errors for missing icon imports (`Wine`, `Sofa` in `pages/EventDetail.tsx`) and a missing module (`components/SectionTitle` in `pages/Legal.tsx`). These are pre-existing in the codebase and do not block `npm run build` or `npm run dev`.
+- **Tailwind CSS via CDN** — Tailwind is loaded via `<script src="https://cdn.tailwindcss.com">` in `index.html`, not as an npm dependency. Internet access is needed for styling to render properly.
+- **No `.env` file needed** — The `GEMINI_API_KEY` referenced in `vite.config.ts` is vestigial and never consumed by source code.
+- **Admin demo access** — The admin portal at `/#/admin` accepts any credentials (there is also a "Acesso Demo" button).
+- **No lint configured** — There is no ESLint or Prettier configuration in the project.