# AGENTS.md

## Project overview
This repository is a Node.js + TypeScript service for handling billing and subscription events.

## Important directories
- `src/routes/` — HTTP handlers
- `src/services/` — business logic
- `src/db/` — database access
- `tests/` — unit and integration tests
- `scripts/` — development and maintenance scripts

## Commands
- install: `pnpm install`
- test: `pnpm test`
- lint: `pnpm lint`
- typecheck: `pnpm tsc --noEmit`
- build: `pnpm build`

## Working rules
- Prefer minimal diffs
- Do not change database schema unless explicitly requested
- Do not upgrade dependencies unless explicitly requested
- Add or update tests for behavior changes
- Prefer targeted validation first, then broader validation if needed

## Additional harness files
See `ai/project-map.md`, `ai/task-templates.md`, and `ai/risk-guardrails.md`.