Add monorepo root orientation

1 files changed, 13 insertions, 0 deletions

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..7334970
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,13 @@
+# Player Monorepo Agent Notes
+
+This repository contains two components: `player-server/` and `player-android/`.
+
+Use `player-server/AGENTS.md` for Go server, web UI, API, database, and deployment work.
+
+Use `player-android/AGENTS.md` for Flutter Android client work.
+
+Keep root changes limited to monorepo orientation, shared ignore rules, and cross-component documentation.
+
+Do not commit local media, generated Android files, local databases, coverage files, or built binaries.
+
+Prefer component-local commands from the relevant README before adding root-level tooling.