diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..010f212
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,10 @@
+# Run tests in release mode
+
+```bash
+cargo test --release
+```
+
+* Compiles with optimizations (`--release`).
+* Executes all test binaries from `target/release/deps`.
+* Use for performance‑sensitive benchmarks.
+* Build takes longer; cache artifacts in CI.