From 0ea304d02fbf32d76d994de43cc26e912ed51dc4 Mon Sep 17 00:00:00 2001
From: joshavant <830519+joshavant@users.noreply.github.com>
Date: Wed, 1 Jul 2026 18:09:20 -0500
Subject: [PATCH] Add Android release agent guardrails

---
 apps/android/AGENTS.md | 11 +++++++++++
 apps/android/CLAUDE.md |  1 +
 2 files changed, 12 insertions(+)
 create mode 100644 apps/android/AGENTS.md
 create mode 120000 apps/android/CLAUDE.md

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