Enhance testing documentation to emphasize the use of embedded/ephemeral Postgres fixtures for tests requiring a database. Update AGENTS.md, README.md, and SKILL.md to reflect this policy and ensure no external DB dependency for standard test runs.

2026-03-01 12:15:53 +00:00
parent c2aa716ed8
commit 39748a2c9b
3 changed files with 8 additions and 0 deletions
@@ -97,3 +97,9 @@ Workflow: `.gitea/workflows/ci.yml`

 - `go test ./...`
 - `bun test` in `libs/geo-api-client`
+
+## Testing policy
+
+- Keep fast unit tests as the default (`go test ./...`).
+- If a test requires a real Postgres instance, use embedded/ephemeral Postgres in the test process or test fixture lifecycle.
+- Do not require manually running an external Postgres container for routine test runs.