diff --git a/docs/MIGRATION-NOTE.md b/docs/MIGRATION-NOTE.md
new file mode 100644
index 0000000..cdc1c60
--- /dev/null
+++ b/docs/MIGRATION-NOTE.md
@@ -0,0 +1,6 @@
+# Migration Note
+
+- Published as an orphan snapshot on 2025-12-27 to bypass shallow-history push restriction; prior history is not preserved on Gitea.
+- Local backup tag for the pre-reset state: `backup-pre-reset-main` (shallow, kept locally only).
+- Original local source path before publish: `/Users/sovereign/vm/vm-core`.
+- Remote target after publish: `git.vaultmesh.org:vaultsovereign/vm-core.git` on branch `main`.