Menu
Worktree lifecycle management scripts — setup, teardown, heartbeat, pin, GC, merge
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Generate throughput and quality reports from coordinator audit data and episodic memory
Orchestrate the full plan-review-implement-validate-PR lifecycle with multi-vendor review convergence
Comprehensive project health diagnostic — collects signals from CI tools, existing reports, deferred issues, and code markers into a prioritized finding report
Generate changelog entries and suggest semantic version bumps from git history
Ingest raw session transcripts from coding-agent harnesses via vendor-specific adapters, normalize to a common event schema, triage for struggle signals, and write structured findings to episodic memory
Readiness gate for sync-point operations — inspect validation, rework, and active-agent state before merge
| name | worktree |
| description | Worktree lifecycle management scripts — setup, teardown, heartbeat, pin, GC, merge |
| category | Infrastructure |
| tags | ["worktree","git","infrastructure","merge"] |
| user_invocable | false |
Non-user-invocable infrastructure skill that bundles worktree lifecycle management scripts. Referenced by SDLC skills via sibling-relative paths.
<skill-base-dir>/scripts/worktree.pyGit worktree lifecycle manager for the launcher invariant (shared checkout is read-only).
Usage:
python3 "<skill-base-dir>/scripts/worktree.py" <command> [args]
Commands:
| Command | Arguments | Description |
|---|---|---|
setup | <change-id> [--agent-id ID] | Create worktree at .git-worktrees/<change-id>/ |
teardown | <change-id> [--agent-id ID] | Remove worktree and clean branch |
status | <change-id> [--agent-id ID] | Print worktree path and branch |
detect | Auto-detect if CWD is inside a worktree | |
heartbeat | <change-id> [--agent-id ID] | Update last-active timestamp (prevents GC) |
list | List all registered worktrees | |
pin | <change-id> | Protect worktree from GC |
unpin | <change-id> | Remove GC protection |
gc | [--force] | Garbage collect stale worktrees (24h default) |
Stdout (setup): WORKTREE_PATH=<path>, BRANCH_CREATED=<branch>, CREATED=true|false
Exit codes: 0 = success, 1 = error
<skill-base-dir>/scripts/merge_worktrees.pyMerges parallel agent branches into the feature branch.
Usage:
python3 "<skill-base-dir>/scripts/merge_worktrees.py" <change-id> <pkg-id>... [--json]
Arguments:
<change-id> — Feature change ID<pkg-id>... — One or more package IDs to merge--json — Output merge results as JSONExit codes: 0 = all merged, 1 = conflict or error
<skill-base-dir>/scripts/git-parallel-setup.shConfigures local git for parallel agent development (rerere, zdiff3, histogram diff).
Usage:
bash "<skill-base-dir>/scripts/git-parallel-setup.sh"