diff --git a/AGENTS.md b/AGENTS.md
index 2ef2f1a..6958b9f 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -18,3 +18,12 @@ Every icons should a simple astro component locate in [`src/components/icons`](.
 ## Git Commit
 
 Every commit needs to invoke the `/git-commit` skill.
+
+## Cursor Cloud specific instructions
+
+- **Node.js**: `.nvmrc` specifies `v24`. Use `source ~/.nvm/nvm.sh && nvm use 24` before running any commands.
+- **sharp build approval**: `package.json` includes `pnpm.onlyBuiltDependencies` to allow `sharp` and `esbuild` postinstall scripts. Without this, `pnpm install` will warn about ignored build scripts and image optimization will fail.
+- **Dev server**: `pnpm dev --host 0.0.0.0` starts Astro on port 4321. No external services (databases, APIs) are required for local development.
+- **Lint/check**: `pnpm check` runs `astro check` (TypeScript diagnostics). There are no separate ESLint or Prettier configs.
+- **Build**: `pnpm build` runs `astro check && astro build`. Output goes to `dist/`.
+- **No automated test suite**: This project has no unit/integration test framework configured. Validation is done via `pnpm check` and `pnpm build`.
diff --git a/package.json b/package.json
index 4967042..da7f14c 100644
--- a/package.json
+++ b/package.json
@@ -39,5 +39,8 @@
     "playwright": "^1.58.2",
     "sharp": "^0.34.5",
     "tsx": "^4.21.0"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": ["sharp", "esbuild"]
   }
 }
\ No newline at end of file