From 99844e5990e0be67490da05b80e71a13a3726de1 Mon Sep 17 00:00:00 2001 From: Mike Pitre <12040919+mikepitre@users.noreply.github.com> Date: Mon, 5 Oct 2026 17:34:14 -0400 Subject: [PATCH] docs(expo): add comment rule for agents Co-Authored-By: Claude Opus 5.5 --- .changeset/expo-agents-comment-rule.md | 2 ++ packages/expo/AGENTS.md | 13 +++++++++++++ 2 files changed, 15 insertions(+) create mode 100644 .changeset/expo-agents-comment-rule.md create mode 100644 packages/expo/AGENTS.md diff --git a/.changeset/expo-agents-comment-rule.md b/.changeset/expo-agents-comment-rule.md new file mode 100644 index 00000000000..a845151cc84 --- /dev/null +++ b/.changeset/expo-agents-comment-rule.md @@ -0,0 +1,2 @@ +--- +--- diff --git a/packages/expo/AGENTS.md b/packages/expo/AGENTS.md new file mode 100644 index 00000000000..4e344934be7 --- /dev/null +++ b/packages/expo/AGENTS.md @@ -0,0 +1,13 @@ +# @clerk/expo + +These rules apply to everything in this package, including the Swift and Kotlin +code under `ios/`, `apple/` and `android/`. They add to the root `AGENTS.md`. + +## Comments + +Don't write comments unless they explain a constraint from a platform, library, +or spec that we can't change. If our own code needs explaining, change the code: +rename it, give it a type, extract a helper, or pin it with a test. + +Keep license headers, doc comments on public API, and `// MARK:` or `// region` +markers. Don't leave commented-out code.