docs: add Cython gotchas section to CLAUDE.md #5209

You have commit messages with errors ⧗ input: Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> ✖ subject may not be empty [subject-empty] ✖ type may not be empty [type-empty] ✖ found 2 problems, 0 warnings ⓘ Get help: https://github.com/conventional-changelog/commitlint/#what-is-commitlint

test (3.9, windows-latest, skip_cython)

Process completed with exit code 1.

test (3.9, windows-latest, skip_cython)

Event loop is closed

test (3.10, macos-latest, skip_cython)

WARNING: Cache entry deserialization failed, entry ignored

test (3.14t, macos-latest, skip_cython)

WARNING: Cache entry deserialization failed, entry ignored

test (3.9, macos-latest, skip_cython)

WARNING: Cache entry deserialization failed, entry ignored

Workflow syntax warning: .github/workflows/ci.yml#L131

.github/workflows/ci.yml (Line: 131, Col: 9): Conditional expression contains literal text outside replacement tokens. This will cause the expression to always evaluate to truthy. Did you mean to put the entire expression inside ${{ }}?

lint

Node.js 20 actions are deprecated. The following actions are running on Node.js 20 and may not work as expected: actions/cache@v4. Actions will be forced to run with Node.js 24 by default starting June 2nd, 2026. Node.js 20 will be removed from the runner on September 16th, 2026. Please check if updated versions of these actions are available that support Node.js 24. To opt into Node.js 24 now, set the FORCE_JAVASCRIPT_ACTIONS_TO_NODE24=true environment variable on the runner or in your workflow file. Once Node.js 24 becomes the default, you can temporarily opt out by setting ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION=true. For more information see: https://github.blog/changelog/2025-09-19-deprecation-of-node-20-on-github-actions-runners/

benchmark

The 'instrumentation' runner mode is deprecated and will be removed in a future version. Please use 'simulation' instead.

test (3.9, windows-latest, skip_cython)