diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
new file mode 100644
index 00000000..9bd88416
--- /dev/null
+++ b/.github/copilot-instructions.md
@@ -0,0 +1,14 @@
+# Copilot Instructions — oncall-mobile-android
+
+This file is a pointer, not a content store.
+
+For real docs, read in order:
+
+1. `AGENTS.md` — role of the app, single-config bootstrap, package layout, key Kotlin entry points.
+2. `README.md` — build + run instructions.
+3. `TESTING.md` — local test setup.
+4. `flake.nix` — Nix dev shell (Android SDK + JDK pinning).
+
+Package namespace is `com.centralcloud.oncall` (post-rename — `io.heckel.ntfy` is gone from the source tree).
+
+SMS-relay subsystem lives under `com.centralcloud.oncall.sms.*`; see those files' inline docstrings.