diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 00000000..640c1a14
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,3 @@
+Repository doctrine for this project lives in AGENTS.md, shared with Codex.
+
+@AGENTS.md