create-worktree

To create an isolated git worktree safely, resolve the repository root first to prevent nesting. Worktrees are generated under a flat directory path at the main repository root to provide a predictable working directory structure for agents.

Git worktree nesting occurs when the repository root is not resolved before creation. Enforce a multi-step workflow that identifies the main repository root first, defining a flat worktree path to prevent subdirectories from triggering nesting bugs.

The best way to isolate agents is creating flat git worktrees under the main repository root. This approach provides each agent its own working directory while enforcing repo-root resolution to prevent nested worktree paths and bugs.

Clean up stale git worktrees by following the optional cleanup steps in the worktree workflow. After validation, remove the flat worktree directories located under the main repository root to ensure no isolated working directories remain.

You do not need to manually resolve the repository root if your worktree workflow enforces it automatically. The creation process must always resolve the repository root first to guarantee a flat, non-nested path under the main repository.

Git worktree validation prevents nesting bugs by checking paths before creation, ensuring each agent gets an isolated working directory. This flat structure under the repository root stops directory conflicts, though standard git branching handles file overwrites.