diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..7b9e57e
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,22 @@
+# AGENTS.md
+
+## Build & Test
+
+```bash
+# Build debug APK
+./gradlew assembleDebug
+
+# Build release APK (with ProGuard/R8 minification)
+./gradlew assembleRelease
+
+# Run unit tests
+./gradlew test
+
+# Run instrumented tests (requires emulator/device)
+./gradlew connectedAndroidTest
+
+# Clean build
+./gradlew clean
+```
+
+APK outputs: `app/build/outputs/apk/`