diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..ada19f1
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,9 @@
+# Core SDK
+
+Go module `git.dev.alexdunmow.com/block/core`. Defines plugin interfaces, template engine, block registry, and shared types for the BlockNinja CMS.
+
+## Critical Rules
+
+- **NEVER use `replace` directives in go.mod** — not in this repo, not in any consumer. All module resolution goes through the Gitea module proxy. If you need to test local changes, tag and push a version.
+- Plugins import from core only — never from the CMS (`blockninja/backend`) or orchestrator.
+- All consumers are in-house — no backwards compatibility shims needed. Just change the API and update consumers.
diff --git a/CLAUDE.md b/CLAUDE.md
deleted file mode 100644
index ada19f1..0000000
--- a/CLAUDE.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# Core SDK
-
-Go module `git.dev.alexdunmow.com/block/core`. Defines plugin interfaces, template engine, block registry, and shared types for the BlockNinja CMS.
-
-## Critical Rules
-
-- **NEVER use `replace` directives in go.mod** — not in this repo, not in any consumer. All module resolution goes through the Gitea module proxy. If you need to test local changes, tag and push a version.
-- Plugins import from core only — never from the CMS (`blockninja/backend`) or orchestrator.
-- All consumers are in-house — no backwards compatibility shims needed. Just change the API and update consumers.
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 120000
index 0000000..47dc3e3
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+AGENTS.md
\ No newline at end of file