# Node / TypeScript Harness Notes

Use this reference for Node.js or TypeScript repositories.

## Common files to inspect

- `package.json`
- `tsconfig.json`
- `eslint.config.*` or `.eslintrc*`
- `vitest.config.*`, `jest.config.*`, `playwright.config.*`
- `src/`, `apps/`, `packages/`, `tests/`

## Common validation commands

Prefer commands already defined by the repo. Typical examples:

- `npm test`
- `npm run lint`
- `npm run build`
- `npm run typecheck`
- `pnpm test`
- `pnpm lint`
- `pnpm build`
- `pnpm tsc --noEmit`

## Suggested AGENTS.md sections

- project purpose
- important directories
- install / build / test / lint commands
- constraints on schema, dependencies, and generated files
- validation order

## Common guardrails

- do not edit generated clients unless the task is specifically about generation
- avoid lockfile churn unless dependencies truly changed
- prefer targeted tests before full test suite
- note whether e2e tests are slow or environment-dependent