worktree-agent-isolation SKILL.md skillA

worktree-agent-isolation from arasz/ai-badger is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add arasz/ai-badger/worktree-agent-isolation@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
arasz/ai-badger
Path
features/common/skills/worktree-agent-isolation/SKILL.md
Versions recorded
5
Latest version
v1.0.0, committed Sep 28, 2026
First version recorded
Aug 12, 2026
Size
20,676 bytes
Repository stars
3
License
MIT

Use when running multiple agents in parallel, or when the user says 'worktrees only', 'agent isolation', 'parallel workstreams', or 'don't touch main': give each agent its own git worktree branched from origin/main (fetch first), integrate via GitHub PRs, keep the main checkout read-only, and avoid shared obj/ races and file-modification conflicts.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Worktree Agent Isolation

Run N independent coding agents in parallel, each in its own git worktree, with
zero file conflicts. Integrate via GitHub PRs — the main checkout is read-only.

## Why

Two agents in the same directory cause:
- **Build failures:** Shared `obj/` directories cause MSB3492 or "Building target
  completely" errors. Workaround is `rm -rf obj/` but it is destructive and racy.
- **File modification races:** One agent patches stale content.
- **Test corruption:** Process-global state (env vars, temp dirs) interferes.

## When to Use

- User says "worktrees only", "don't touch main", "agent isolation"
- Multiple independent tasks can run in parallel
- Another agent/session is using the main checkout
- User wants to see draft PRs for in-flight work visibility

## Setup

```bash
# Fetch latest main first — ensures worktrees branch from the true HEAD
git fetch origin main

# Create N worktrees from origin/main (not local main, which may be behind)
git worktree add ../project-task-a -b task/<id>-<slug> origin/main
git worktree add ../project-task-b -b task/<id>-<slug> origin/main
```

Each worktree gets its own branch, own working directory, own build artifacts.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add arasz/ai-badger/worktree-agent-isolation@sha256:d9672dd349b9985b

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_a3nzw3vlwmnb26yh.svg)](https://markdownregistry.com/a/art_a3nzw3vlwmnb26yh)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Aug 12, 2026 and Sep 28, 2026, about one every 12 days.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-09-28 ecca060 20,676 BA view · diff
v1.0.02026-09-11 c8da0f0 20,679 BA view · diff
v1.0.02026-09-04 5e53cba 20,677 BA view · diff
v1.0.02026-08-16 43e6df5 20,449 BA view · diff
v1.0.02026-08-12 7b03e88 20,088 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (20676 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

arasz/ai-badger · 3 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_a3nzw3vlwmnb26yh
GET https://markdownregistry.com/api/v1/resolve?ref=arasz/ai-badger/worktree-agent-isolation
GET https://markdownregistry.com/api/v1/blob/d9672dd349b9985b15572dd3031ad7ea342e8267fa327dffedadd45ebb5dc170

Your AI assistant 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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from arasz/ai-badger

CLAUDE.md@.ai-badger CLAUDE.md file
arasz/ai-badger · .ai-badger/CLAUDE.md
git:20261007.5d99092 · audit A · 3 stars
ai-raccoon-memory SKILL.md skill
arasz/ai-badger · .ai-badger/skills/ai-raccoon-memory/SKILL.md · Use when a project needs a memory server — search project and shared memory first, write durable facts with source…
v0.2.0 · audit A · 3 stars
archify SKILL.md skill
arasz/ai-badger · .ai-badger/skills/archify/SKILL.md · Use when the user asks to visualize system architecture, infrastructure, cloud/security topology, technical workflows…
v2.16.0 · audit A · 3 stars
artifact-verification SKILL.md skill
arasz/ai-badger · .ai-badger/skills/artifact-verification/SKILL.md · Use when verifying changed artifacts that lack a canonical test gate — specs, docs, manifests, generated files…
v1.0.0 · audit A · 3 stars
auto-wm SKILL.md skill
arasz/ai-badger · .ai-badger/skills/auto-wm/SKILL.md · Use when the user wants Claude to auto-approve tool calls — "enable autonomic/autonomous work mode", "/auto-wm"…
v1.0.0 · audit A · 3 stars
browser-usage SKILL.md skill
arasz/ai-badger · .ai-badger/skills/browser-usage/SKILL.md · Use when interacting with web pages, running manual E2E browser tests, testing UI flows, or inspecting live web…
v1.0.0 · audit A · 3 stars
call-behaviorist SKILL.md skill
arasz/ai-badger · .ai-badger/skills/call-behaviorist/SKILL.md · Use when ai-badger's own machinery needs to be observed — "did that hook even run?", "enable debug logging", "why is…
v1.0.0 · audit A · 3 stars
code-review-checklist SKILL.md skill
arasz/ai-badger · .ai-badger/skills/code-review-checklist/SKILL.md · Use when reviewing code — a PR, a diff, or freshly written changes — and you want concrete pass/fail checks rather than…
v1.0.0 · audit B · 3 stars
code-review-evidence SKILL.md skill
arasz/ai-badger · .ai-badger/skills/code-review-evidence/SKILL.md · Use when reviewing code that wraps external libs/extensions/SDKs/CLIs, or QA-reviewing a test harness: verify…
v1.0.0 · audit A · 3 stars
code-review SKILL.md skill
arasz/ai-badger · .ai-badger/skills/code-review/SKILL.md · Use when performing a code review in this repository — reviewing a pull request, a branch diff, or a requested…
v1.0.0 · audit A · 3 stars
commit-reminder SKILL.md skill
arasz/ai-badger · .ai-badger/skills/commit-reminder/SKILL.md · Use when a project has accumulated uncommitted changes and nobody has said so out loud — several edits in a row with no…
v1.0.0 · audit A · 3 stars
complete-project-scope-code-review SKILL.md skill
arasz/ai-badger · .ai-badger/skills/complete-project-scope-code-review/SKILL.md · Use when the whole project — not a diff — is the review target and the result must survive being acted on: "review the…
v1.0.0 · audit A · 3 stars

Every file in arasz/ai-badger

Other files named worktree-agent-isolation

worktree-agent-isolation SKILL.md skill
arasz/ai-badger · .ai-badger/skills/worktree-agent-isolation/SKILL.md · Use when running multiple agents in parallel, or when the user says 'worktrees only', 'agent isolation', 'parallel…
v1.0.0 · audit A · 3 stars

Browse by kind, by grade A, or by owner.