Skip to content

Add Cursor Cloud development environment instructions to AGENTS.md #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
mathcodes wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

Add Cursor Cloud development environment instructions to AGENTS.md #2

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,3 +3,24 @@

This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.
<!-- END:nextjs-agent-rules -->

## Cursor Cloud specific instructions

### Services overview

Single Next.js 16 app (not a monorepo) with PostgreSQL via Prisma. See `README.md` for full feature list and scripts table.

### Running the app

- **Node 20.x** is required (`.nvmrc`). The VM uses nvm: `source ~/.nvm/nvm.sh && nvm use 20`.
- **PostgreSQL 16** runs locally. Start with `sudo pg_ctlcluster 16 main start`.
- Database: `taskhub_dev` on localhost, user `ubuntu`/`devpass`. The `.env` file has `DATABASE_URL` pointing to it.
- After install: `npx prisma migrate dev` applies migrations. The `postinstall` script auto-runs `prisma generate`.
- Dev server: `npm run dev` → http://localhost:3000.

### Gotchas

- **Prisma config** (`prisma.config.ts`) loads `.env` via `dotenv/config`. If `DATABASE_URL` in `.env` is wrong, Prisma commands will silently connect to the wrong DB. Always verify `.env` has the local URL.
- **ESLint** reports errors in `src/generated/prisma/` (auto-generated code). These are expected and not fixable. The ESLint config does not ignore this directory — when checking lint results, filter out `src/generated/` lines. There are also 4 pre-existing lint errors in `src/components/playbooks/PlaybookGuideModal.tsx` (`react-hooks/immutability`).
- **AI features** require `OPENAI_API_KEY` in `.env` or a user-provided BYOK key in the browser. Without it, only CRUD task management works.
- The app has no automated test suite (no `test` script in `package.json`). Verification is via lint + dev server + manual API/UI testing.