cavedroid

Use when the user wants to build CaveDroid for Android API 16/17 (Jelly Bean) devices, or when diagnosing the "Couldn't load shared library 'gdx'" / "cannot locate '__memcpy_chk'" crash on old Android. Encodes the libGDX/ktx version downgrade required (the stock 1.12+ natives reference Bionic symbols that don't exist before API 18), every API port the older libraries demand, and the verification step that proves the resulting .so files will actually load.

Use when the user asks to add a new UI language / locale to CaveDroid (e.g. "add French localization", "support Polish", "translate the game into Japanese"). Encodes the five places that have to stay in sync (Kotlin constant, scripts/locales.sh, libGDX i18n properties bundles, fastlane metadata, the nativeDisplayName autonym map), the ordering rule, what to translate from, and the things that intentionally do NOT need a new locale entry.

Use when the user asks to write, add, or fix unit tests for CaveDroid Kotlin code (any module under core/, android/, desktop/, ios/). Encodes the project's test stack (JUnit Jupiter + mockk + kotlinx-coroutines-test), the libGDX/Box2D/GL constraints that make some classes untestable in JVM tests, the pure-helper-extraction pattern used when the SUT touches GL/native code, and the per-module opt-in build.gradle.kts wiring.