diff --git a/AGENTS.md b/AGENTS.md
index c0356fa7..baa09a6c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -11,6 +11,8 @@ Examples:
 - version `23.01.3` -> versionCode `3`
 - version `23.01.123` -> versionCode `123`
 
+IMPORTANT: After bumping the version in `app.json`, you MUST run `npx expo prebuild -p android --no-install` BEFORE running Gradle (`.\gradlew assembleRelease`). Otherwise, `android/app/build.gradle` will retain the old version code and the Play Store will reject the upload!
+
 Apps must always be built as BOTH `.apk` and `.aab`.
 The exact naming syntax for compiled files is:
 `Schnappix_v23.01.X.apk`