diff --git a/packages/migrate-config/src/migrate-config-cli.js b/packages/migrate-config/src/migrate-config-cli.js
old mode 100644
new mode 100755
index 84604627..b0152dd8
--- a/packages/migrate-config/src/migrate-config-cli.js
+++ b/packages/migrate-config/src/migrate-config-cli.js
@@ -6,6 +6,18 @@
 
 /* global process, console */
 
+/*
+ * IMPORTANT!
+ *
+ * Because this file is executable, `npm install` changes its permission to
+ * include the executable bit. This is a problem because it causes the file to
+ * be marked as changed in Git, even though it hasn't. This, in turn, causes
+ * JSR to think the directory is dirty and fails the build. To prevent this,
+ * we ran:
+ * $ git update-index --chmod=+x packages/migrate-config/src/migrate-config-cli.js
+ * This tells Git to ignore changes to the executable bit on this file.
+ */
+
 //-----------------------------------------------------------------------------
 // Imports
 //-----------------------------------------------------------------------------