diff --git a/local/docs/GRUB-INTEGRATION-PLAN.md b/local/docs/GRUB-INTEGRATION-PLAN.md
index 17b82a71..f3bf04ad 100644
--- a/local/docs/GRUB-INTEGRATION-PLAN.md
+++ b/local/docs/GRUB-INTEGRATION-PLAN.md
@@ -207,12 +207,16 @@ bootloader = "grub"
 efi_partition_size = 16
 ```
 
-Or via CLI:
+Or via CLI (note: INSTALLER_OPTS replaces defaults, so --cookbook=. must be included):
 ```bash
 ./target/release/repo cook installer
-make all CONFIG_NAME=redbear-full INSTALLER_OPTS="--bootloader grub"
+make all CONFIG_NAME=redbear-full INSTALLER_OPTS="--cookbook=. --bootloader grub"
 ```
 
+**Note:** The config file approach (`redbear-full-grub.toml`) is preferred over the CLI flag
+because INSTALLER_OPTS completely replaces the default value (`--cookbook=.`) rather than
+appending to it. Omitting `--cookbook=.` breaks local package resolution for GRUB.
+
 ## GRUB Recipe Design
 
 The GRUB recipe uses `template = "custom"` because GRUB must be built for the