docs(agents): add Cursor Cloud environment setup notes

[skoshx]

Summary

Sets up and verifies the Cloud Agent development environment for this repo and documents the durable, non-obvious gotchas for future agents in AGENTS.md under a new ## Cursor Cloud specific instructions section.

No product code changed — only AGENTS.md.

Key learnings captured

• Node version gotcha: pnpm lint / pnpm format load vite.config.ts (a TS config) which needs Node >=22.18.0. The daemon-pinned /exec-daemon/node is v22.14.0 (passes engines, fails the lint tool). The agent's ~/.bashrc now prefers an nvm-managed Node 22 (>=22.18) on PATH so fresh shells already work.
• ni/nr (@antfu/ni) are not installed in the Cloud VM — use pnpm directly.
• The product is a CLI (no server/DB). End-to-end run: node packages/react-doctor/bin/react-doctor.js <dir> --yes --no-score.
• Optional Next.js website: pnpm --filter website dev → http://localhost:3000.

Environment verification

• pnpm install, pnpm build — succeed.
• pnpm lint, pnpm format:check, pnpm typecheck — pass.
• pnpm test — 1798 passed / 15 skipped.
• pnpm smoke:json-report — OK.
• CLI scanned a sample React project and detected 7 issues (no-array-index-as-key, exhaustive-deps, click-events-have-key-events, …) with a valid schemaVersion: 1 JSON report.
• Website dev server serves HTTP 200.

Demo

react_doctor_cli_and_website_demo.mp4

react-doctor CLI scan output
React Doctor website homepage

_{To show artifacts inline, enable in settings.}

  

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/eslint-plugin-react-doctor@855

npm i https://pkg.pr.new/oxlint-plugin-react-doctor@855

npm i https://pkg.pr.new/react-doctor@855

commit: beef341

[github-actions]

No React Doctor issues found. 🎉

_{Reviewed by React Doctor for commit beef341.}