diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8bfcac29..a6b32da6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,16 @@
+# unreleased
+
+* Rewrote bridge in Go using bridgev2 architecture.
+  * To migrate the bridge, simply upgrade in-place. The database and config
+    will be migrated automatically, although some parts of the config aren't
+    migrated (e.g. log config).
+  * It is recommended to check the config file after upgrading. If you have
+    prevented the bridge from writing to the config, you should update it
+    manually.
+  * The old-style relaybot is not yet supported and will not be migrated.
+    Setups using the relaybot will have to manually log in as a bot and use
+    `set-relay` to enable the generic relay mode.
+
 # v0.15.3 (2025-07-16)
 
 * Updated Telegram API to layer 204.