diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 00000000..a86f7dff
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,6 @@
+# ALE Agent instructions
+
+1. Read documentation from `doc/ale-development.txt` to understand how to be an
+   ALE developer.
+2. Run Vader/Vim tests with `./run-tests -q --fast test/path/some_file.vader`
+3. When editing Lua code run Lua tests with `./run-tests -q --lua-only`