docs: add admin test account and Cursor Cloud instructions

.cursor/CLOUD.md

@@ -17,7 +17,7 @@ A full-stack web application starter built on Cloudflare Workers with Remix 3
 
 ## Services
 
-- **Dev server**: Runs at `localhost:8787` (Cloudflare Workers local)
+- **Dev server**: Runs at `localhost:3742` (Cloudflare Workers local)
 - `bun run dev` starts both the client esbuild watcher and Wrangler worker
   server
 

.github/workflows/preview.yml

@@ -266,6 +266,7 @@ jobs:
         run: |
           set -euo pipefail
           bun tools/seed-test-data.ts --remote --config "$WRANGLER_CONFIG" --email kody@kcd.dev --password kodylovesyou
+          bun tools/seed-test-data.ts --remote --config "$WRANGLER_CONFIG" --email me@kentcdodds.com --password iliketwix
 
       - name: 🩺 Healthcheck (preview)
         shell: bash

AGENTS.md

@@ -26,3 +26,26 @@ This file is intentionally brief. Detailed instructions live in focused docs:
   - [docs/architecture/request-lifecycle.md](./docs/architecture/request-lifecycle.md)
   - [docs/architecture/authentication.md](./docs/architecture/authentication.md)
   - [docs/architecture/data-storage.md](./docs/architecture/data-storage.md)
+
+## Cursor Cloud specific instructions
+
+See [.cursor/CLOUD.md](./.cursor/CLOUD.md) for the full quick-reference table.
+
+### Non-obvious gotchas
+
+- **Dev server port is 3742**, not 8787. The CLI (`cli.ts`) defaults to port
+  3742 and auto-finds a free port in the range 3742-3751.
+- **`.env` must exist** before running `bun run dev`. Copy `.env.example` to
+  `.env` and ensure `COOKIE_SECRET` is at least 32 characters (generate with
+  `openssl rand -hex 32`).
+- **Mock servers auto-start**: `bun run dev` automatically starts mock Resend
+  (email) and mock AI workers. No external services or Docker needed.
+- **Seed test accounts** before testing login flows:
+  - Regular user: `bun run migrate:local && bun tools/seed-test-data.ts --local`
+    (email: `kody@kcd.dev`, password: `kodylovesyou`).
+  - Admin user:
+    `bun tools/seed-test-data.ts --local --email me@kentcdodds.com --password iliketwix`
+    (email: `me@kentcdodds.com`, password: `iliketwix`). Admin status is
+    determined by email match in `shared/admin.ts`.
+- **No git hooks or pre-commit** checks are configured. Run `bun run validate`
+  manually before pushing.

docs/agents/setup.md

@@ -66,6 +66,10 @@ Use this script to ensure a known test login exists in any deployed environment:
 - Default credentials:
   - email: `kody@kcd.dev`
   - password: `kodylovesyou`
+- Admin account (has admin privileges via `shared/admin.ts`):
+  - `bun tools/seed-test-data.ts --local --email me@kentcdodds.com --password iliketwix`
+  - email: `me@kentcdodds.com`
+  - password: `iliketwix`
 - Override credentials when needed:
   - `bun tools/seed-test-data.ts --email <email> --password <password>`
 - When changing DB schema/model definitions or migrations, review

docs/getting-started.md

@@ -3,9 +3,9 @@
 Use this guide to run `pea` locally and understand the minimum setup needed for
 development.
 
-`pea` is the stakeholder simulation service used by the Epic Systems
-Engineering Judgment Workshop. The separate workshop app owns the learner
-experience; this repo owns the agent side of the system.
+`pea` is the stakeholder simulation service used by the Epic Systems Engineering
+Judgment Workshop. The separate workshop app owns the learner experience; this
+repo owns the agent side of the system.
 
 ## Prerequisites
 
@@ -72,6 +72,17 @@ Default test credentials:
 - Email: `kody@kcd.dev`
 - Password: `kodylovesyou`
 
+Admin test credentials (seed separately):
+
+```bash
+bun tools/seed-test-data.ts --local --email me@kentcdodds.com --password iliketwix
+```
+
+- Email: `me@kentcdodds.com`
+- Password: `iliketwix`
+
+Admin status is determined by email match in `shared/admin.ts`.
+
 ## Build
 
 Build the project: