diff --git a/migrations/README.md b/migrations/README.md
new file mode 100644
index 0000000..14978d2
--- /dev/null
+++ b/migrations/README.md
@@ -0,0 +1,5 @@
+# State migrations (scaffold)
+
+**Status:** Empty until **build**.
+
+Used by `upgrade.sh` when schema/version changes between product releases.