diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..ef7ef1a
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,11 @@
+# Marble Machinations Change Log
+
+## [Unreleased]
+
+- changed: directly moving marbles (to adjactent tile without anything between) now have priority over new marbles being created, instead of the two events cancelling each other
+
+## v0.2.1 - 2025-03-14
+- added "Simple comparison" level
+- fixed phantom marble (empty tile causing other marbles to bounce away) appearing after multiple machines tried to output to the same location at once
+
+## v0.2.0 - 2024-12-24