From 3421445c560ff5b73d8dcb87dbd260dc89bf56b8 Mon Sep 17 00:00:00 2001
From: Matt Bodle <matt.bodle@rokt.com>
Date: Tue, 29 Sep 2026 04:39:19 +1000
Subject: [PATCH] docs(agents): make CLAUDE.md an import instead of a symlink

CLAUDE.md was a symlink to AGENTS.md. Git on Windows defaults to
core.symlinks=false and checks a symlink out as a plain text file whose
contents are the string "AGENTS.md", which Claude Code reads literally
instead of following, so on those checkouts the repository silently has
no agent instructions and nothing reports an error.

Replaced with the `@AGENTS.md` import that thirteen other SDK
repositories already use, with the reason recorded in the file. The
guidance stays in AGENTS.md; nothing is duplicated, so the two cannot
drift.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 CLAUDE.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)
 mode change 120000 => 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
deleted file mode 120000
index 47dc3e3..0000000
--- a/CLAUDE.md
+++ /dev/null
@@ -1 +0,0 @@
-AGENTS.md
\ No newline at end of file
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..1c7d54b
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,8 @@
+# Rokt Web Kit - Agent Instructions
+
+<!-- An import, not a symlink: git on Windows defaults to core.symlinks=false and checks a symlink
+     out as a plain text file, which Claude Code then reads as the literal string "AGENTS.md"
+     instead of following it. Keep all guidance in AGENTS.md; never duplicate it here, because the
+     two copies would drift. -->
+
+@AGENTS.md