From 925fe71eaedb831984f076c1abec3b22e1d3a5ed Mon Sep 17 00:00:00 2001
From: larry foulkrod <lefoulkrod@gmail.com>
Date: Sun, 16 Aug 2026 20:41:59 -0500
Subject: [PATCH] docs(agents): add repository guidance

---
 AGENTS.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..c315d24
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,5 @@
+# Repository guide
+
+- Run `make verify` and focused tests before handoff; also run `make race` for concurrency changes.
+- Route Podman operations through `engine.Engine` and shared workflows, and preserve the platform supplied by `engine.RunOptions` or `HostPlatform`.
+- Run lifecycle and TUI tests in the disposable VM lab, never on the developer host. Set `OMNIDECK_VM_LAB_DIR=/mnt/data/VMs/omnideck-release-lab`; see `TESTING.md` and `tests/e2e/README.md` for `make vm-e2e` and `make vm-e2e-matrix`.