worktree is agent-read markdown (skill) from ulises-jeremias/agent-toolkit: Manage Git worktrees per writer for Agent Toolkit swarms — isolated branches, handoff promotion,.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# Worktree
Create and maintain **worktree-per-writer** isolation for `agent-toolkit swarm` so each role works on its own branch without stepping on others. Integrates with `swarm-handoff` promotion and `github-cli-workflow` for PRs.
## When to use
- Swarm needs isolated writes: implementer, reviewer, integrator each own a worktree/branch.
- `worktree_failed` trace or `find_repo_root` error on `.git` file worktrees.
- Before `swarm promote` — ensure the handoff's worktree is clean and pushable.
- Cleanup after a run is promoted or abandoned.
## Prerequisites
- Repo is Git with `git worktree` available (`git worktree --help`).
- Swarm run exists: `.agent-toolkit/swarm/runs/<run-id>/state.json`; worktrees live under `.agent-toolkit/swarm/runs/<run-id>/worktrees/<role>-<short>/`.
- `find_repo_root` uses `git rev-parse --git-common-dir` to handle worktree `.git` files (not directories).
## Workflow
### 1. Inspect current worktrees
```bash
git worktree list
agent-toolkit swarm status --run-id <run-id> --json | jq '.worktrees'
# Expected: {implementer: {path, branch, commit}, reviewer: {path, branch}, ...}
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
GET https://markdownregistry.com/api/v1/artifacts/art_qdtpae2kwfmjgcwm
GET https://markdownregistry.com/api/v1/resolve?ref=ulises-jeremias/agent-toolkit/worktree
GET https://markdownregistry.com/api/v1/blob/7303ece6d351b143b6445ff41e5e84b10173d207e4bb8cb98ec829bc2500eece
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/adr/SKILL.md · WHAT — Create and maintain Architecture Decision Records (ADRs) per the process. Covers when
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/blast-radius/SKILL.md · Find what a change could break somewhere else before it ships, beyond the diff, and prove the one fact it's safe…
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/bug/SKILL.md · WHAT - Draft and review bugs using the Bug Template; classifies whether an issue should be
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/c4-model/SKILL.md · WHAT — C4 model methodology (Context, Container, Component, Code) guidance — what to draw at each level, when, and how…
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/chrome-devtools/SKILL.md · Use Chrome DevTools MCP to control and inspect a live Chrome instance for network, console, performance, rendering, and…
oprogramadorreal/optimus-claude · skills/worktree/SKILL.md · Creates a git worktree for isolated parallel development — new branch in a separate directory with project setup and…
outlinedriven/odin-claude-plugin · plugins/odin-git/skills/worktree/SKILL.md · Use when work needs an isolated git worktree: new work, an existing ref, a gated feature workspace, a manifest-tracked…
hidorakai002/ai-workspace-archive · ai_agent_frameworks/major_frameworks/AutoGPT/.claude/skills/worktree/SKILL.md · Set up a new git worktree for parallel development. Creates the worktree, copies .env files, installs dependencies, and…
byerlikaya/claude-starter-kit · claude-starter/skills/worktree/SKILL.md · Isolate risky or parallel file-mutating work in a git worktree so the main tree's uncommitted changes are…
byerlikaya/claude-starter-kit · plugin/skills/worktree/SKILL.md · Isolate risky or parallel file-mutating work in a git worktree so the main tree's uncommitted changes are…
allagentsdev/allagents · plugins/engineering/skills/worktree/SKILL.md · Creates and removes isolated Git worktrees under a consistent repository sibling directory. Use when starting feature…
entityprocess/allagents · plugins/engineering/skills/worktree/SKILL.md · Creates and removes isolated Git worktrees under a consistent repository sibling directory. Use when starting feature…
