diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..4f3a7b0
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,7 @@
+# AGENTS.md
+
+- Treat matcha/notplanned as canonical; fetch/reconcile main before writes.
+- Prefer deterministic GitHub/API scans and existing workflows over model calls.
+- Keep scouts bounded, inspectable, and cheap. Raw evidence beats narrative.
+- Preserve existing visual/product language; make the smallest change that adds a new signal.
+- Verify generated artifacts and the live route before DONE.