diff --git a/docs/mac_studio_setup_plan.md b/docs/mac_studio_setup_plan.md
index fe1bd97..e5df390 100644
--- a/docs/mac_studio_setup_plan.md
+++ b/docs/mac_studio_setup_plan.md
@@ -1,3 +1,19 @@
+> **⚠️ ADDENDUM — 2026-08-11 (migration executed, functionally complete)**
+> This plan was executed over two nights. It is now a historical document;
+> the live source of truth is `STUDIO-MIGRATION-STATUS.md` in this directory.
+> Corrections discovered during execution:
+> - **§3 clone URLs:** handle-form (`psingletary.com/...`) failed knot lookup
+>   for some repos. Use canonical DID-form only:
+>   `git@tangled.org:did:plc:<did>/<nothing>` — full DID table is in the
+>   status doc.
+> - **§5f cleanup repo:** never lived in `~/dev` and isn't cloned from
+>   Tangled. The git repo lives at OneDrive `env/cleanup/`; its installer
+>   deploys `clean.sh` → `~/.scripts/` with label `com.user.sched-cleanup`
+>   (not `com.psingletary.*`). Studio install was done from the synced kit.
+> - **§5 general:** launchd jobs on the Studio needed `/opt/homebrew/bin`
+>   prepended to PATH, and OneDrive files are dataless stubs in launchd
+>   context (materialize or pin before relying on them).
+
 # Mac Studio Setup Plan (v2 — LAN-only, Studio as automation host)
 **Goal:** identical ~/dev layout on both machines; git/Tangled as sync,
 OneDrive as vault; Studio = always-on automation host; Mullvad untouched.