Does this work with plain JavaScript Express apps?
The structure and safety rules do. Remove the TypeScript language and conventions in the generator and the type-check command disappears from the output.
A Node.js REST API on Express, written in TypeScript. The rules focus on the boundaries agents most often leave open: input validation, async error handling and SQL safety.
# AGENTS.md
Project: express-api. A REST API on Express and Node.js, written in TypeScript, backed by PostgreSQL.
This file is the single source of truth for every coding agent working in this repository. The tool-specific files (CLAUDE.md, GEMINI.md, .github/copilot-instructions.md and .cursor/rules/project.mdc) point here. Edit this file, not those.
## Stack
- Language: TypeScript
- Framework: Express
- Database: PostgreSQL
- Hosting: Render
- Tests: Vitest
- Package manager: npm
## Commands
Run these from the repository root.
- Install dependencies: `npm ci`
- Run locally: `npm run dev`
- Build: `npm run build`
- Run all tests: `npm test`
- Run one test file: `npx vitest run src/path/to/file.test.ts`
- Lint: `npm run lint`
- Type-check: `npx tsc --noEmit`
- Format: `npx prettier --write .`
## Project layout
- `src/routes/`: Routers: one file per resource
- `src/services/`: Business logic, no req or res objects
- `src/db/`: Queries and migrations
- `src/middleware/`: Auth, validation and error-handling middleware
- `test/`: Integration tests with Supertest
## Code style
- Indent with 2 spaces. Never tabs.
- TypeScript runs in strict mode. Do not use `any`; use `unknown` and narrow it, or write the real type.
- Match the style and patterns of the surrounding code, even where you would personally choose differently.
- Use named exports. Do not add default exports.
- Prefer small pure functions and immutable data; keep side effects at the edges (handlers, jobs, I/O modules).
- Never swallow an error. Handle it where you can act on it, or rethrow it with context about what failed.
- Commit messages follow Conventional Commits: `feat:`, `fix:`, `refactor:`, `test:`, `docs:`, `chore:`, with an imperative summary under 72 characters.
## Working rules
- Before you say a task is done, run the test, lint and type-check commands above and make sure they pass. If you could not run them, say so.
- For a bug fix or behavior change, first write or update a test that fails, then make it pass.
- Never write secrets, API keys, tokens or passwords into code, tests, fixtures, logs or commits. Read them from environment variables, and never commit `.env` files.
- Do not add a new dependency without asking first. Prefer the standard library and what is already installed.
- Ask before creating, editing or running database migrations, and never edit a migration that has already been applied.
- Change only what the task needs. Do not refactor, rename or reformat unrelated code.
## Product constraints
- Treat user data as sensitive: never log personal data, tokens or request bodies, and collect nothing the feature does not need.
- Validate all input at the boundary, use parameterized queries only, and treat every external payload as untrusted.
## Project-specific notes
- Validate `req.body`, `req.params` and `req.query` with a zod schema in every route before using them.
- Route handlers stay thin: parse input, call a service, send the response. Business logic lives in `src/services/` and never touches `req` or `res`.
- Async errors must reach the central error middleware: call `next(err)` or use the async wrapper; never leave a rejected promise unhandled.
- Use parameterized queries only (`$1`, `$2`); never build SQL with string concatenation or template literals.
- Error responses never include stack traces or raw database errors outside development.
- Every new endpoint gets a Supertest integration test covering success, validation failure and auth failure.
## Project phase
This project is in active development. Follow the patterns that already exist; consistency beats novelty.
# CLAUDE.md
@AGENTS.md
## Claude Code
- The shared project instructions are imported from AGENTS.md on the line above. Edit AGENTS.md, not this file, so every agent stays in sync.
- Put Claude-only preferences below this line. Personal, uncommitted notes belong in CLAUDE.local.md.
# GEMINI.md
@./AGENTS.md
## Gemini CLI
- The shared project instructions are imported from AGENTS.md on the line above. Edit AGENTS.md, not this file.
- Alternative: delete this file and set "context": { "fileName": ["AGENTS.md"] } in .gemini/settings.json so Gemini CLI reads AGENTS.md directly.
# Copilot instructions
Project: express-api. A REST API on Express and Node.js, written in TypeScript, backed by PostgreSQL.
The full instructions are in AGENTS.md at the repository root. Read it before you change code; if anything here disagrees with it, AGENTS.md wins. The essentials are repeated below for Copilot surfaces that only read this file.
## Stack
- Language: TypeScript
- Framework: Express
- Database: PostgreSQL
- Hosting: Render
- Tests: Vitest
- Package manager: npm
## Commands
- Install dependencies: `npm ci`
- Run locally: `npm run dev`
- Build: `npm run build`
- Run all tests: `npm test`
- Run one test file: `npx vitest run src/path/to/file.test.ts`
- Lint: `npm run lint`
- Type-check: `npx tsc --noEmit`
- Format: `npx prettier --write .`
## Working rules
- Before you say a task is done, run the test, lint and type-check commands above and make sure they pass. If you could not run them, say so.
- For a bug fix or behavior change, first write or update a test that fails, then make it pass.
- Never write secrets, API keys, tokens or passwords into code, tests, fixtures, logs or commits. Read them from environment variables, and never commit `.env` files.
- Do not add a new dependency without asking first. Prefer the standard library and what is already installed.
- Ask before creating, editing or running database migrations, and never edit a migration that has already been applied.
- Change only what the task needs. Do not refactor, rename or reformat unrelated code.
---
description: Project instructions for every task (mirrors AGENTS.md)
globs:
alwaysApply: true
---
# Project rules
The project instructions live in @AGENTS.md at the repository root, which Cursor loads automatically. They are not repeated here, so they cost context only once. Edit AGENTS.md, not this rule.
Before you change code, check the Commands and Working rules sections of AGENTS.md, and run its test and lint commands before you say a task is done.
Put Cursor-only rules below, or add scoped rules as more .mdc files with `globs` (for example `src/components/**/*.tsx`).
These are the exact files the generator writes for this preset. Change any command or rule in the generator and download your own set.
The preset describes a a REST API on Express and Node.js, written in TypeScript, backed by PostgreSQL. Its AGENTS.md is 53 non-empty lines with 8 exact commands, 5 key directories, and 6 stack-specific rules on top of the shared working rules.
npm ci, npm run dev, npm run build, npm test, npx vitest run src/path/to/file.test.ts, npm run lint, npx tsc --noEmit, npx prettier --write ..src/routes/, src/services/, src/db/, src/middleware/, test/.Express hands you whatever the client sent. Agents read req.body.email directly because it works in the happy path. A schema at the boundary is cheap and stops type confusion and injection at the door.
Depending on the Express version and the code path, a thrown error in an async handler may never reach the error middleware, leaving the request hanging. Being explicit about the error path avoids a class of production incidents.
Modern JavaScript makes string building so convenient that agents write WHERE id = ${id} without thinking. The rule forbids it outright.
Services without req and res can be unit tested directly, and the routes only need a few integration tests.
req.body, req.params and req.query with a zod schema in every route before using them.src/services/ and never touches req or res.next(err) or use the async wrapper; never leave a rejected promise unhandled.$1, $2); never build SQL with string concatenation or template literals.Want different commands or rules? Load this preset into the generator, change anything, and download your own set.
AGENTS.md is read directly by Codex, Cursor, Windsurf, Cline, Zed and Jules, and by GitHub Copilot's cloud agent, code review and CLI. Claude Code reads it through the generated CLAUDE.md, and Gemini CLI through GEMINI.md. See the compatibility table for details, last verified 2026-11-13.
All presets are on the stacks page.
The structure and safety rules do. Remove the TypeScript language and conventions in the generator and the type-check command disappears from the output.
It gives runtime validation and a TypeScript type from one schema. Any validator works; replace zod in the notes if your project uses Joi, Valibot or something else.
For new projects they are worth a look, and there is a Hono template in the library. For an existing Express codebase, these rules make it safer without a rewrite.
Yes. Copy them into any project, commercial or not, without attribution. They are a starting point: adjust the commands and rules to match your repository.
You do not have to take our word for it. Developer tools show every request a page makes, so you can watch this page work and confirm that nothing you type is sent. The check takes under a minute.
F12, or Cmd+Option+I on a Mac, and select the Network tab.Only the feedback form can add a line to that log, and it sends only the vote and comment you type into it. 2prompt has no server code at all: no API, no model and no database of your files. The production site also sends a Content-Security-Policy header that tells your browser to refuse connections to anywhere except this site, the fonts and the anonymous analytics endpoint.