worktree — Isolated Session & Branching Engine

Operating Invariants

Path Isolation: Confine all branch edits, shell commands, and test executions strictly within .agents/worktree/<branch>; forbid modifying root repository files from a worktree session.
Dirty Tree Breaker: Verify working tree cleanliness via git status --porcelain before deleting a worktree; forbid deleting worktrees containing uncommitted modifications.
Pre-Mutation Gate: Stage worktree creation or removal in Canonical Changeset format and halt turn immediately; forbid executing worktree mutations on disk without affirmative human authorization.

<branch>: Strictly format as <type>/<slug> (feat/, fix/, refactor/, chore/, test/).
<path>: Dedicated path strictly under .agents/worktree/<branch>.
Privacy Anchor: Root .gitignore must contain .agents/worktree/.