From ac3fd3e131c1c7c425eb5d2b2622b7045c3a4c77 Mon Sep 17 00:00:00 2001
From: kolaente <k@knt.li>
Date: Sun, 8 Feb 2026 15:40:33 +0100
Subject: [PATCH] docs: add caveat about running go tests to agent instructions
 [skip ci]

---
 AGENTS.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index fd243bad4..9e94614e5 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -70,6 +70,8 @@ After creation, tell the user where they can find the new worktree.
 - **Clean**: `mage build:clean` - Cleans build artifacts
 - **Format**: `mage fmt` - Format Go code before committing
 
+**IMPORTANT:** To run api tests, you MUST use the `mage test:web`, or `mage test:feature` or `mage test:filter` commands. Using plain `go test` will not work!
+
 **Go Tips:**
 - To see source files from a dependency, or to answer questions about a dependency, run `go mod download -json MODULE` and use the returned `Dir` path to read the files.
 - Use `go doc foo.Bar` or `go doc -all foo` to read documentation for packages, types, functions, etc.