Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

docs: note wt step promote exception in worktree model (#1154)

worktrunk-bot104354e8fb16
diff --git a/CLAUDE.md b/CLAUDE.md
index 9235e369d..d2d8aedc3 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -283,7 +283,7 @@ Use `wt list --format=json` for structured data access. See `wt list --help` for
- Worktrees are **addressed by branch name**, not by filesystem path.
- Each worktree should map to **exactly one branch**.
-- We **never retarget an existing worktree** to a different branch; instead create/switch/remove worktrees.
+- We **never retarget an existing worktree** to a different branch; instead create/switch/remove worktrees. (The sole exception is `wt step promote`, which exchanges branches between two worktrees as an experimental escape hatch.)
## Code Quality