git-worktree-isolation

Git worktrees isolate agent workspaces by creating multiple working directories from a single repository, mapping each to a Linear issue, Git branch, and PR. This prevents cross-contamination between parallel tasks while sharing a single repository.

The 1:1:1 mapping links one workspace to one Linear issue, one Git branch, and one PR. This structured directory mapping ensures isolated workspaces remain synchronized with their corresponding issue tracking and version control lifecycle.

Set up parallel feature development by creating an isolated worktree for each issue and agent. The workspace uses a defined directory structure and frontmatter contract, ensuring safe parallel development across multiple agents without interference.

Linear issues are used to map workspaces to branches and PRs. While the core worktree isolation relies on Git, the defined directory structure and frontmatter contract are specifically designed to coordinate workspaces mapped to Linear issues.

You clean up isolated workspaces using lifecycle hooks for cleanup provided by the workspace management process. This ensures safe operations by automatically removing the dedicated worktree directory once the associated PR is completed.

Git worktrees for multi-agent collaboration require strict adherence to the defined frontmatter contract and directory structure to prevent workspace interference. Users must manage lifecycle hooks carefully to ensure safe operations and proper cleanup.