diff --git a/README.md b/README.md
new file mode 100644
index 0000000..de0de06
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# coa-chatter
+
+[Chatter](https://www.curseforge.com/wow/addons/chatter) chat addon, patched for the Conquest of Azeroth (CoA) client.
+
+## CoA delta
+
+- `Modules/AltNames.lua` — guard nil `note`/`rank` from `GetGuildRosterInfo`. The CoA client returns these fields as `nil` instead of `""`, which crashed `ScanGuildNotes` on `strlower(note)`.
+
+Upstream: Chatter v1.2.11 (Curse package).