Skip to content

Commit 9ecc102

Browse files
committed
docs(repo): Add pnpm, changeset, and commit rules inline to avoid repeat agent failures
1 parent 4b70193 commit 9ecc102

1 file changed

Lines changed: 3 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,9 @@ Clerk's JavaScript SDK and library monorepo.
66

77
- Non-major releases in `packages/clerk-js` and `packages/ui` are pushed out to consuming applications without requiring explicit package updates. This means a new `clerk-js` runtime can load into an app pinned to an older `@clerk/nextjs` (or any other framework SDK) version, so changes must remain backwards-compatible with SDK versions already in the wild, not just the current monorepo state. Removing or renaming anything an older SDK still calls will break production for those users. Extra care must be put into any changes to these packages.
88
- 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 (including older SDK versions still loading the latest `clerk-js`). Changes to this API must be done in a major version to avoid breakage.
9+
- Use `pnpm` only. `npm` and `yarn` are blocked by `preinstall`. Node `>=24.15`, pnpm `>=10.33`.
10+
- Every PR needs a changeset. `pnpm changeset` for package changes, `pnpm changeset:empty` for tooling/repo-only. Empty changesets are two `---` delimiters with no body.
11+
- Commits must be conventional: `type(scope):` (commitlint enforces). `scope` is the package name without `@clerk/`, or `repo` / `release` / `e2e`. `clerk-js` uses scope `js`.
912

1013
## References
1114

0 commit comments

Comments
 (0)