diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..7d309c5
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,9 @@
+# Upstream first
+
+For feature changes, updates, and bug investigation or fixes:
+
+1. First inspect how upstream yabai designs and implements the relevant behavior,
+   including related changes and fixes.
+2. Prefer reusing or adapting the upstream approach.
+3. Write a custom implementation only when upstream cannot meet the requirements,
+   and briefly explain why.