CLAUDE.md for Express

Swallowed async handler errors are the classic Express failure mode — the CLAUDE.md should say how errors flow. Below is a complete, committable example for a typical Express project. To get one tailored to your dependencies and scripts, paste your manifest into the free generator (client-side, nothing uploaded) or run npx getagentready in your repo.

Complete example

# CLAUDE.md

This file guides Claude Code when working in this repository.

## Project

**example-express-api** — Stack: JavaScript, Express, npm, Jest, ESLint.

## Commands

- Install dependencies: `npm install`
- Run dev server: `npm run dev`
- Run all tests: `npm test`
- Run a single test: `npx jest path/to/file.test.ts -t "test name"`
- Lint: `npm run lint`

## Testing

Tests use Jest. Write or update tests alongside behavior changes; run the single-test command during iteration and the full suite before finishing.

## Conventions

- Routes thin, logic in service modules; wire errors through a single error-handling middleware.
- Validate request bodies at the boundary (e.g. zod) before they reach handlers.
- Prefer small, focused changes; do not refactor unrelated code in the same change.
- Match the existing code style of the file you are editing over any global preference.
- Never commit secrets. `.env*` files are local-only.
- After making changes, run the test and lint commands above before considering work done.

## Gotchas

- Async handler errors are swallowed unless passed to `next()` or wrapped — check this first for hanging requests.

<!-- generated with https://getagentready.dev -->

Going further

This is the generated baseline. The Agent-Ready Pro Pack includes a hand-tuned, deeper Express configuration — architecture guidance, testing strategy, common-task recipes — plus 12 workflow skills and enforcement hooks. See also the CLAUDE.md guide and AGENTS.md guide.