diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 000000000..ee906336b
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,12 @@
+## AGENTS.md for Magisk
+
+### General
+
+- Prefix every shell command with `scripts/env.py` to ensure that commands are executed with the correct environment.
+
+### App
+
+- All application related source code lives under `app` directory. When working on the application codebase, use `app` as the working directory.
+- The `app` directory is itself a Gradle project. Use `./gradlew` with corresponding tasks to build the app.
+- The Magisk app is written in Kotlin and Java. Prefer Kotlin for all new code.
+- After doing changes in `app`, make sure to build the relevant modules to ensure they build successfully.