# AGENTS.md

Guidance for AI agents working in this repo.

## Agent skills

### Issue tracker

Issues live in **Gitea** at <https://git.mivanchenko.de/BPPP/smb-online/issues>, created/read via
the Gitea REST API (or the `tea` CLI) with a PAT that has `issue` scope, kept in `.secrets/` and
never committed. See `docs/agents/issue-tracker.md`.

### Triage labels

Canonical roles, used verbatim as Gitea labels: categories `bug` / `enhancement`; states
`needs-triage` · `needs-info` · `ready-for-agent` · `ready-for-human` · `wontfix`. Invoke triage
with `/mattpocock-skills:triage`. See `docs/agents/triage-labels.md`.

### Domain docs

Single-context: one `CONTEXT.md` + `docs/adr/` at the repo root (created lazily when terms or
decisions get resolved). See `docs/agents/domain.md`.

### Testing

Backoffice tests need only Docker (a throwaway Postgres container is started for you) and a
Python 3.12 venv — the `psycopg[binary]` pin has version-specific wheel availability, so use
3.12, not whatever `python3` defaults to. Runs automatically in Gitea Actions on push/PR. See
`docs/agents/testing.md`.