Set up Cursor Cloud dev environment + AGENTS.md notes

[kostandinang]

Summary

Sets up the development environment for the Brunch spec-elicitation app on Cursor Cloud and captures durable, non-obvious setup caveats in AGENTS.md. The only code change is documentation.

What was verified

• npm ci — dependency install (Node 22.22.2 via nvm; the exec-daemon's default Node 22.14 is below the >=22.19 engine requirement).
• npm run lint — 0 errors (11 pre-existing warnings).
• npm test — core product suite (src/server, src/client, src/shared) passes; the src/orchestrator "cook" subsystem is flaky under full parallelism on a 4-core VM (default 5s timeout) and a few tests need bun/bwrap which aren't installed. Runs clean serially: npx vitest run src/orchestrator --no-file-parallelism --testTimeout=30000.
• npm run build — client + server-runtime builds succeed.
• npm run dev — Vite :5173 + API :3000; completed a hello-world: created a specification and received a live AI interviewer question.

AGENTS.md additions (## Cursor Cloud specific instructions)

• Node version gotcha + how to activate 22.22.2.
• ANTHROPIC_API_KEY is read from env (no .env needed); preflight exits without it.
• App URL/ports, log locations, SQLite DB path.
• Orchestrator test parallelism flakiness + external tool (bun/bwrap) dependencies.
• Stale docker-compose.yml/Dockerfile (Dolt) do not match the current SQLite codebase.

Hello-world demo

brunch_hello_world_interview.mp4

AI interviewer question

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