diff --git a/.planning/notes/2026-10-07-embedded-admin-release-gate.md b/.planning/notes/2026-10-07-embedded-admin-release-gate.md
new file mode 100644
index 0000000..dbbee9f
--- /dev/null
+++ b/.planning/notes/2026-10-07-embedded-admin-release-gate.md
@@ -0,0 +1,6 @@
+---
+date: "2026-10-07 01:03"
+promoted: false
+---
+
+Release rule: before creating or pushing any SummerCMS version tag that includes changes under `admin/`, rebuild the embedded SPA with `npm --prefix admin run build`, commit the resulting `modules/boardwalk/dist` changes, and run `./scripts/check-admin-dist.sh`. Do not tag until the drift check passes and the tag commit contains the generated bundle, because consuming Go binaries serve the embedded `modules/boardwalk/dist`, not `admin/src`.