diff --git a/apps/android/AGENTS.md b/apps/android/AGENTS.md new file mode 100644 index 000000000000..4d34b693d86b --- /dev/null +++ b/apps/android/AGENTS.md @@ -0,0 +1,11 @@ +# Android Release Agent Policy + +Root rules still apply. This file adds the Android release guardrails. + +## Google Play Releases + +- Agent-driven Google Play uploads must use only `pnpm android:release:upload`. +- If `pnpm android:release:upload` exits non-zero, stop immediately and report the failing step. +- After a failed `pnpm android:release:upload`, do not continue with `pnpm android:release:archive`, `pnpm android:release:metadata`, `fastlane android play_store`, `fastlane android metadata`, direct Gradle release artifacts plus Google Play upload commands, Google Play API mutation commands, or mobile release ref recording. +- Do not promote an Android release to production. Production promotion stays manual in Google Play Console unless the user explicitly asks to promote a specific already-prepared release after the failed state has been reported. +- `pnpm android:release:archive` is for local archive validation only. It is not a fallback release path after screenshot, metadata, signing, validation, or upload-lane failure. diff --git a/apps/android/CLAUDE.md b/apps/android/CLAUDE.md new file mode 120000 index 000000000000..47dc3e3d863c --- /dev/null +++ b/apps/android/CLAUDE.md @@ -0,0 +1 @@ +AGENTS.md \ No newline at end of file