diff --git a/CLAUDE.md b/CLAUDE.md
index 8bd91ad833..aa33139cae 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -58,6 +58,16 @@ run specific tests.
 * Adapter tests require Docker containers running (`docker compose up -d`)
 * Consider using test helpers like `getTestInstance()` from
   `better-auth/test` first
+* If a test is to prevent regression of a specific numbered GitHub issue,
+  add a JSDoc `@see` comment with the issue URL above the `it()` or `describe()`:
+  ```typescript
+  /**
+   * @see https://github.com/better-auth/better-auth/issues/{issue_number}
+   */
+  it("should handle the previously broken behavior", async () => {
+    // ...
+  });
+  ```
 
 ## Documentation