diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..ab0b66d
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,11 @@
+# AGENTS.md
+
+Guidance for AI coding agents working in this repository.
+
+# Comments and PR content
+
+- Never include customer names or identifiers, always anonymize references
+
+# Architecture notes
+
+- The snyk-broker component is always used in websocket mode. Data transport never uses long polling.
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..43c994c
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md