← ClaudeAtlas

worktree-isolationlisted

Isolate non-trivial work in a sibling git worktree using `basicly worktree`, covering sibling placement on a harness branch, dependency + git-hook provisioning, and safe cleanup. Use when starting a unit of work that should not touch the main checkout, when parallel tracks would collide, or when deciding whether a change needs its own worktree.
niksavis/basicly · ★ 1 · AI & Automation · score 74
Install: claude install-skill niksavis/basicly
<!-- Generated by `basicly skills-build` from skill.yaml. Do not edit; edit the source. --> # Worktree Isolation ## Scope Owns running a unit of work in an isolated **sibling** git worktree via the `basicly worktree` commands: where the worktree goes, how it is provisioned so its gates actually run, and how it is torn down without endangering the main checkout. It is not for: - Merging a finished worktree branch back or resolving conflicts (that is the merge orchestrator's job — not yet part of `basicly worktree`). - Creating or claiming the beads issue the work tracks (see `tool-br`). - Git staging, diffing, or commit-message formatting (see `tool-git`, `conventional-commits`). ## When to isolate - **Isolate** any non-trivial change: multi-file work, anything that runs the gates, or work that could run in parallel with another track. - **Skip** trivial mechanical edits (a typo, a one-line doc fix) — those go straight to the source branch. A worktree has a real setup cost; do not pay it for throwaway work. ## Placement rule (non-negotiable) A worktree lives at the **sibling** path `<repo>.worktrees/<name>` on branch `harness/<name>`, forked from the configured base branch (`[worktree].base_branch` in `basicly.toml`, or the current branch). Never create work worktrees **inside** the repo (e.g. in-repo `.claude/worktrees/`): an in-repo worktree pollutes the repo's own file walk and is not provisioned, so its git hooks fall back to a system toolchain and **run no