Files
computer-playbook/skills/i8-worktree-down/SKILL.md
kevinveenbirkenbach f6b361f42c feat(agents): add the worktree skills and the path they write to
A second branch needs its own checkout to be worked on in parallel, with its own
slot, subnet, ports and container names so two deploys do not take each other's.
The two skills route to the make targets that create and release one.

The sandbox gains the worktree directory as a writable path, without which the
checkout cannot be created and the skills are unusable. It is the only change
to the permission file: one write path, no deny or ask rule touched.
2026-08-06 21:34:05 +02:00

1.1 KiB

name, description
name description
i8-worktree-down Stop a branch worktree's compose stack, release its checkout and free its slot (make worktree-down). Trigger when a parallel worktree is no longer needed or when its branch is blocked as already checked out. Infinito.Nexus specific.

Follow the instructions from AGENTS.md, then run make worktree-down branch=<branch> (the default action of this skill). Pass the same base=<dir> that make worktree-up was given, otherwise the target looks in the default parent directory and reports no worktree at that path.

The target refuses to drop a worktree with uncommitted changes. Show the operator that status and let them decide; only add force=true when they explicitly ask for it, because it discards the changes.

When the checkout is already gone but the branch is still held, run make worktree-prune instead.

Begin by clarifying every open requirement with the active-listening skill, then work under the robot skill. The task is finished only when the slot is reported as released and the branch is checkable out again.