conducty-worktrees

Conducty Worktrees — Parallel Isolation

Use git worktrees (Bash) to isolate parallel prompts that target the same repository, preventing conflicts during concurrent execution.

When to Use

Use worktrees when a parallelization group has two or more prompts targeting the same repository. If all prompts in a group target different repos, worktrees are unnecessary.

[!tip] Claude Code shortcut When dispatching a subagent via the Task tool, pass isolation: "worktree" to let the harness create and clean up a temporary worktree automatically. Use this skill when you need explicit, named worktrees that survive across multiple subagent dispatches in the same group.

Tracer Worktree Strategy

The tracer prompt (marked ★ TRACER) runs on the main branch, not in a worktree. It validates plan assumptions against the real repo state. Only after the tracer passes do you create worktrees for the remaining prompts.

This ensures the tracer tests reality, not an isolated copy.

Workflow

Step 1: Wait for Tracer

The tracer prompt executes first on the main branch (via [[conducty-execute]]). If it passes, proceed. If it fails, the plan needs revision — don't create worktrees for a flawed plan.

Step 2: Create Worktrees

For each remaining prompt that targets the same repo:

cd /path/to/project
git worktree add ../conducty-wt-P{N} -b conducty/P{N}

This creates:

• A sibling directory conducty-wt-P{N} with a full working copy
• A branch conducty/P{N} tracking the current HEAD (which now includes the tracer's commits)

Update each prompt's Directory field in the plan to point to the worktree path (Edit tool).

Step 3: Verify Baselines

For each worktree, run the project's test suite or build command (Bash):

cd ../conducty-wt-P{N}
# run project-specific test/build command

If the baseline fails, the worktree inherits a broken state — flag this before execution begins. A broken baseline wastes the entire prompt.

Step 4: Execute