Worktree Manager

Selects confirmed native worktree facilities or the governed portable repository worktree fallback, validates placement, and reports cleanup guidance.

richfrem 44855f2 4 files · 1.6 KB Updated

File contents

Worktree Manager

Use this skill when a task needs an isolated worktree or when the active runtime may provide native worktree management.

  1. Probe the active runtime with scripts/capability_probe.py.
  2. Treat the returned capability result as authoritative. Never infer native worktree support from a model name or an installed binary.
  3. If native_worktree is true, follow the returned activation guidance and retain the task's control-plane gates.
  4. Otherwise use the portable plan from scripts/worktree_manager.py and delegate lifecycle operations to the issue-worktree-agent skill; its path must remain below <repo>/.worktrees/<task-id>.
  5. Report the selected strategy, exact path, branch, activation guidance, and cleanup command before mutating the repository.

Native and portable execution have the same approval, verification, and review requirements. Native execution is an implementation facility, not a governance bypass.

richfrem/agent-plugins-skills/tree/main/plugins/agent-agentic-os/skills/worktree-manager commit 44855f26a7

Frequently asked questions

npx skillmds@latest add richfrem/worktree-manager