AGENTS.md som fungerar i Codex, Cursor, Copilot och Claude Code

# AGENTS.md

Instruktioner för kodagenter som arbetar i det här repot. Läs hela filen
innan du ändrar något.

## Vad projektet är

Ett internt API för lagersaldo. Node 24, TypeScript, Fastify, Postgres.
Körs som container i Kubernetes. Ungefär 40 000 rader kod, tre
utvecklare.

## Så kör du

    npm ci
    npm run dev          # startar API och databas i Docker
    npm test             # hela testsviten, cirka 90 sekunder
    npm run test:unit    # bara enhetstester, cirka 5 sekunder
    npm run lint
    npm run typecheck

Kör `npm run lint && npm run typecheck && npm run test:unit` innan du
rapporterar att en uppgift är klar. Kör hela `npm test` om du ändrat något
under `src/db/` eller `src/routes/`.

## Kodregler

- Ingen `any`. Använd `unknown` och smalna av.
- Alla routes validerar body och query med JSON Schema i samma fil.
- Databasfrågor ligger i `src/db/queries/`. Inga SQL-strängar i routes.
- Fel loggas strukturerat med `logger.error({ err, context })`. Aldrig
  `console.log`.
- Nya miljövariabler dokumenteras i `.env.example` och läses i
  `src/config.ts`. Ingen annanstans.

## Arbetssätt

- Läs befintliga tester för den modul du ändrar innan du ändrar den.
- Gör den minsta ändring som löser uppgiften. Refaktorera inte kod du inte
  behöver röra, men påpeka gärna vad som borde göras.
- Om uppgiften är otydlig: ställ frågan i stället för att bygga två
  varianter.
- Sammanfatta vad du ändrade och hur du verifierade det när du är klar.
  Säg uttryckligen om något inte är testat.

## Rör inte

- `src/legacy/` avvecklas. Fixa inte buggar där, flagga dem.
- `infra/` ägs av driftteamet.
- Filer med suffixet `.generated.ts`. Kör generatorn i stället.

## Git

Gren per uppgift. Commit-meddelanden på engelska, imperativ, under 72
tecken på första raden. Ingen force push mot delade grenar.