# Coordinate Worktrees And Threads

> Assign worktree, branch, write, validation, integration, and cleanup ownership before parallel repository work. Use when a worker will inspect or modify repository state outside the coordinator's worktree.

- Skill: `gaelic-ghost/coordinate-worktrees-and-threads` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add gaelic-ghost/coordinate-worktrees-and-threads`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gaelic-ghost/coordinate-worktrees-and-threads/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: gaelic-ghost (https://skillmd.com/u/gaelic-ghost)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/gaelic-ghost/coordinate-worktrees-and-threads

---


# Coordinate Worktrees And Threads

Establish repository ownership before a worker begins. A thread is not a
worktree, and a branch is not permission to make shared Git mutations.

## Launch Record

For every worker, record the worker/task identity, coordinator, repository and
base commit, worktree path, branch, read/write scope, allowed Git operations,
validation lane, output/merge target, final report route, and retention or
cleanup decision.

## Rules

- Give parallel writers disjoint files or directories and separate worktrees.
- When a Codex-managed worktree versus a plain Git worktree is itself a
  decision, hand that host-specific choice to
  `repository-skills:codex-gui-worktree-workflow`; retain this skill's
  host-neutral ownership record in either case.
- Serialize Git operations that change shared repository state. A worker must
  not assume it owns tags, merges, release branches, deletion, or cleanup.
- Serialize heavy build and test lanes unless the environment explicitly proves
  they are independent and safe.
- Keep final integration, conflict resolution, release, branch accounting, and
  cleanup with the coordinator unless the user explicitly assigns them.
- When a worker returns, report branch/worktree state, commits, validation,
  uncommitted changes, artifacts, and the recommended integration action.

## Completion

The coordinator explicitly chooses whether to retain the worker thread or
worktree for follow-up, merge/preserve its result, archive it, or remove it
after branch accounting. Never delete a worktree or branch merely because a
worker says it is done.