1 files changed, 4 insertions, 2 deletions
diff --git a/AGENTS.md b/AGENTS.md
index 5bf3ac3..ffe1953 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -65,8 +65,10 @@ the config with `/usr/local/bin/` rewritten to a stub dir (stub `sb-publish`,
 ./slackrepo_setup_SBo-danix.sh
 ```
 
-Destructive: `rm -rf`s `$REPO` on every run to start clean, then re-clones upstream. Interactive
-`read` prompt inside `sbshadow` is the only confirmation (declining exits 0, run continues).
+Destructive: builds a fresh tree in `$REPO.new`, swaps it in (old tree to `$REPO.old`), runs
+`sbshadow --yes`, then deletes `$REPO.old`. A failed clone or subtree add leaves `$REPO` untouched;
+a failed `sbshadow` keeps `$REPO.old` for a manual rollback. Non-interactive: sb-builder runs it
+as a job with no stdin. `SBO_REPO` overrides the path, for trying it on a throwaway repo.
 
 ## Architecture