Adds .gitea/workflows/test-backoffice.yml (paths-filtered to backoffice/app/** and backoffice/db/**, self-hosted homelab runner, plain git clone matching deploy-backoffice.yml's conventions) so a regression no longer needs a human to notice it. The psycopg[binary]==3.2.1 pin turned out to be correct, not stale: it only ships wheels through cp312, so it resolves cleanly under the project's python:3.12-slim target but not under newer interpreters. Documented in requirements.txt and docs/agents/testing.md, along with the fact that the suite spins up its own throwaway postgres:16-alpine container (tests/conftest.py) with no manual DB setup required. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
1.1 KiB
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.