Worktree isolation

Skill 0SxD/openrouter-swarm-orch-agent/agentic_auto_buildX_ai_bundle_repos/sagex_plugin_v0.1_example_copy/skills/worktree-isolation

Create and manage git worktrees for parallel coding agent isolation. Invoke when two independent coding tasks need to run simultaneously (max 2).From its SKILL.md

Install

npx -y skills add 0SxD/openrouter-swarm-orch-agent --skill worktree-isolation

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.1 KB, 755 tokens by cl100k_base, as published. Nobody here has run it

Worktree Isolation Pattern

When to Use

Two independent coding tasks can run in parallel (no shared files)
Each task is self-contained (different feature branches)
Max 2 worktrees active at any time (= max 2 concurrent agents)

Step 1 — Create Worktree

Use the EnterWorktree tool or bash equivalent:

git worktree add _worktrees/{task-id} -b feature/{task-id}-{short-description}

Each worktree gets its own:

Working directory: _worktrees/{task-id}/
Feature branch: feature/{task-id}-{short-description}
Complete copy of the codebase (shares .git objects, not files)

Step 2 — Dispatch Agent to Worktree

In Agent tool call, direct the agent to work within the worktree path:

Agent reads/writes ONLY within _worktrees/{task-id}/
Agent has NO access to main working tree files
Agent has NO knowledge of what the other worktree agent is doing

Step 3 — Stage 1 Audit (before merge)

Each worktree's output goes through the full 5-gate audit pipeline:

Semgrep (plugin)
CodeRabbit (plugin)
Code-review + pr-review-toolkit (plugins)
Security-guidance (plugin)
Clone repo comparison (_repos/)

ALL gates must PASS before merge is allowed.

Step 4 — Merge Back

After Stage 1 PASS + Austin approval:

# Return to main working tree
git checkout main

# Merge the feature branch (no fast-forward for audit trail)
git merge feature/{task-id}-{short-description} --no-ff

# Clean up
git worktree remove _worktrees/{task-id}
git branch -d feature/{task-id}-{short-description}

Step 5 — Stage 2 (GitHub PR Airlock)

After merge to local main:

Push branch → open PR (Austin approval required)
GitHub Actions: remote semgrep + CodeRabbit
Austin reviews → merges

Rules

NEVER share files between worktrees
NEVER run more than 2 worktrees simultaneously
ALWAYS delete worktree after merge (no stale worktrees)
ALWAYS run full audit before merge
Worktree directory: _worktrees/ (gitignored)

Multi-Agent Worktree Usage

All coding agents use worktrees — not just Claude sub-agents:

Agent	Worktree?	Branch pattern	Notes
Claude (Opus)	NO — stays on main	n/a	Orchestrator. Never leaves main working tree.
Claude (Sonnet)	YES	feature/{task-id}-claude-{desc}	Dispatched by Opus
Gemini (AntiGravity)	YES	feature/{task-id}-gemini-{desc}	Works in IDE on its own worktree
Codex	YES	feature/{task-id}-codex-{desc}	Works in IDE on its own worktree

Opus NEVER works in a worktree — it stays on main to orchestrate and review
Each coding agent gets its own worktree and feature branch
No two agents share a worktree
All worktree output goes through Claude's 5-gate audit pipeline before merge

Emergency Cleanup

git worktree list              # see all active worktrees
git worktree remove --force _worktrees/{task-id}  # force remove
git worktree prune             # clean up stale entries

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.