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.
1---2name: coordinate-worktrees-and-threads3description: 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.4---56# Coordinate Worktrees And Threads78Establish repository ownership before a worker begins. A thread is not a9worktree, and a branch is not permission to make shared Git mutations.1011## Launch Record1213For every worker, record the worker/task identity, coordinator, repository and14base commit, worktree path, branch, read/write scope, allowed Git operations,15validation lane, output/merge target, final report route, and retention or16cleanup decision.1718## Rules1920- Give parallel writers disjoint files or directories and separate worktrees.21- When a Codex-managed worktree versus a plain Git worktree is itself a22 decision, hand that host-specific choice to23 `repository-skills:codex-gui-worktree-workflow`; retain this skill's24 host-neutral ownership record in either case.25- Serialize Git operations that change shared repository state. A worker must26 not assume it owns tags, merges, release branches, deletion, or cleanup.27- Serialize heavy build and test lanes unless the environment explicitly proves28 they are independent and safe.29- Keep final integration, conflict resolution, release, branch accounting, and30 cleanup with the coordinator unless the user explicitly assigns them.31- When a worker returns, report branch/worktree state, commits, validation,32 uncommitted changes, artifacts, and the recommended integration action.3334## Completion3536The coordinator explicitly chooses whether to retain the worker thread or37worktree for follow-up, merge/preserve its result, archive it, or remove it38after branch accounting. Never delete a worktree or branch merely because a39worker says it is done.