diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..ab0b2f7
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,18 @@
+# AGENTS
+
+## Overview
+- Android app built with Kotlin + Jetpack Compose.
+
+## Build
+Requires Java 17 and Android SDK.
+
+```bash
+export JAVA_HOME="/opt/homebrew/Cellar/openjdk@17/17.0.18/libexec/openjdk.jdk/Contents/Home"
+./gradlew assembleDebug
+```
+
+## Run
+TODO: Add local run/install instructions (e.g., `installDebug`, emulator/device setup) once confirmed.
+
+## Test
+TODO: Add test/lint commands once confirmed.