Menu
Opinionated worktree workflow with .git/checkouts convention. Load explicitly with /worktree-workflow.
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
This skill should be used when the user mentions "bd", "beads", "what's next", "add task", "add epic", or asks about issue tracking. First check if a .beads directory exists in the project - if not, this skill does not apply.
Launch and manage loosely coupled cmux subagents: parallel interactive Codex sessions in cmux columns for user-given subtasks, using explicit sttts-* branches and the bundled codex-worktree wrapper. Use when the user says 'start cmux codex subagent', 'cmux codex session', 'codex cmux session', asks to launch a Codex subagent in cmux, or asks to start, check status, tail output, focus, or close a cmux subagent.
Record prompts to git notes and MR/PR descriptions. Triggers on 'record prompt', 'prompt recording', 'log prompts'.
Tilt local development and e2e testing. Triggers on tilt, kind cluster, e2e tests, test/tilt, local dev cluster.
Clean up worktrees for merged branches. Triggers on 'prune worktrees', 'cleanup worktrees', 'remove merged worktrees'.
Git worktree commands and usage. Triggers on 'worktree', 'worktrees', 'create worktree', 'git worktree'.
| name | worktree-workflow |
| description | Opinionated worktree workflow with .git/checkouts convention. Load explicitly with /worktree-workflow. |
| version | 0.2.8 |
| user_invocable | true |
Opinionated workflow for git worktrees using .git/checkouts/ convention.
This skill must be explicitly loaded - it does not auto-trigger.
All worktrees are created in .git/checkouts/:
git worktree add .git/checkouts/<branch> -b <branch>
cd .git/checkouts/<branch>
Benefits:
When this workflow is active:
.git/checkouts/ - consistent locationEnable for a repo:
git config --local claude.worktrees true
mkdir -p .git/checkouts
Disable:
git config --local --unset claude.worktrees
git worktree add .git/checkouts/<branch> -b <branch>
cd .git/checkouts/<branch>
# All work happens here
Use /prune-worktrees to check for merged branches and clean up.
Manual cleanup:
git worktree remove .git/checkouts/<branch>
git worktree prune