clerk · brkalow · May 16, 2026 · May 16, 2026 · May 16, 2026 · jacekradko
diff --git a/.changeset/orange-dragons-join.md b/.changeset/orange-dragons-join.md
@@ -0,0 +1,2 @@
+---
+---
diff --git a/.prettierignore b/.prettierignore
@@ -23,3 +23,4 @@ packages/clerk-js/src/core/resources/index.ts
 packages/shared/src/compiled
 /**/CHANGELOG.md
 renovate.json5
+CLAUDE.md
diff --git a/AGENTS.md b/AGENTS.md
@@ -0,0 +1,8 @@
+# AGENTS.md
+
+Clerk's JavaScript SDK and library monorepo.
+
+## Guidelines
+
+- Non-major releases in `packages/clerk-js` and `packages/ui` are pushed out to consuming applications without requiring explicit package updates. Extra care must be put into any changes to these packages.
+- The API exposed from the core Clerk class in `packages/clerk-js/src/core/clerk.ts` is a contract that is depended on by internal and external consumers. Changes to this API must be done in a major version to avoid breakage.
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -0,0 +1 @@
+AGENTS.md
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		AGENTS.md
Copy link Copy Markdown Member jacekradko May 16, 2026 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others. Learn more. Symlinking breaks prettier, but Claude supports referencing `@AGENTS.md` if it's a regular MD file https://code.claude.com/docs/en/memory#agents-md