From 72fbffa0ced25ffa80dca15537e44319b0440651 Mon Sep 17 00:00:00 2001
From: Taesu <166604494+bytaesu@users.noreply.github.com>
Date: Fri, 6 Feb 2026 05:55:38 +0900
Subject: [PATCH] chore: add regression test instruction for Claude (#7809)

---
 CLAUDE.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

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