docs: add Cursor Cloud dev environment instructions for eShop

Co-authored-by: mattfromcursor <mattfromcursor@users.noreply.github.com>

Author: cursoragent

AGENTS.md

@@ -43,3 +43,64 @@ Upstream: `https://github.com/dotnet/eShop`. Sync with `git fetch upstream && gi
 | Subagents | `.cursor/agents/` — eShop trio + `aspnet-reviewer` (upstream RoninForge), `dotnet-architect` (upstream dotnet-claude-kit) |
 
 Presenter runbook: `../demo_scripts/presenter-guide.md` (sibling `nfl_temp` folder, not in this repo). Tag `demo-baseline` at repo root before workshops so `/reset-demo` works.
+
+## Cursor Cloud specific instructions
+
+### Prerequisites already on the VM
+
+- .NET SDK **10.0.x** (see `global.json`)
+- Docker (start with `sudo service docker start`; if `docker ps` fails with permission denied, run `sudo chmod 666 /var/run/docker.sock` once per session)
+- Node.js/npm (Playwright E2E and Identity.API client-lib workaround)
+
+### Restore / build gotchas
+
+- **NuGet audit:** Intermittent TLS failures to `api.nuget.org` surface as `NU1900` and fail the build (`TreatWarningsAsErrors`). Use `-p:NuGetAudit=false` on restore/build until connectivity is stable.
+- **Identity.API libman:** `cdnjs` fetches during build can fail in this environment. `wwwroot/lib/` is gitignored. Either populate it once (see below) or build with `-p:LibraryRestore=False` after libs exist.
+
+One-time Identity client libs via npm (when `wwwroot/lib` is missing):
+
+```bash
+mkdir -p /tmp/libman-vendor && cd /tmp/libman-vendor && npm init -y && npm install jquery@3.6.3 bootstrap@5.2.3 jquery-validation@1.19.5 jquery-validation-unobtrusive@4.0.0
+ID_LIB=src/Identity.API/wwwroot/lib
+mkdir -p "$ID_LIB/jquery" "$ID_LIB/bootstrap/css" "$ID_LIB/bootstrap/js" "$ID_LIB/jquery-validate" "$ID_LIB/jquery-validation-unobtrusive"
+cp node_modules/jquery/dist/jquery*.js "$ID_LIB/jquery/"
+cp node_modules/bootstrap/dist/css/bootstrap* "$ID_LIB/bootstrap/css/"
+cp node_modules/bootstrap/dist/js/bootstrap.bundle*.js "$ID_LIB/bootstrap/js/"
+cp node_modules/jquery-validation/dist/jquery.validate*.js "$ID_LIB/jquery-validate/"
+cp node_modules/jquery-validation-unobtrusive/dist/jquery.validate.unobtrusive*.js "$ID_LIB/jquery-validation-unobtrusive/"
+```
+
+Standard build (demo slice):
+
+```bash
+dotnet restore eShop.Web.slnf -p:NuGetAudit=false
+dotnet build eShop.Web.slnf -p:NuGetAudit=false -p:LibraryRestore=False
+```
+
+### Run full stack
+
+```bash
+export ESHOP_USE_HTTP_ENDPOINTS=1
+dotnet run --project src/eShop.AppHost/eShop.AppHost.csproj -p:NuGetAudit=false -p:LibraryRestore=False
+```
+
+- **WebApp:** `http://localhost:5045` (with `ESHOP_USE_HTTP_ENDPOINTS=1`)
+- **Aspire dashboard:** URL printed at startup (HTTPS on `19888`)
+- Demo login: `bob` / `Pass123$`
+
+Run AppHost in a **tmux** session for long-lived processes; first startup pulls Postgres/Redis/RabbitMQ images and can take 1–2 minutes.
+
+### Tests
+
+- Unit tests (project, not solution filter — `global.json` test runner expects a registered tool):
+
+```bash
+dotnet test --project tests/Ordering.UnitTests/Ordering.UnitTests.csproj
+```
+
+- Playwright E2E (reuse running AppHost when not in CI):
+
+```bash
+npm ci && npx playwright install chromium
+ESHOP_USE_HTTP_ENDPOINTS=1 USERNAME1=bob PASSWORD='Pass123$' npx playwright test
+```