recursive-worktree

Create and validate isolated git worktrees for recursive-mode runs.

128|10|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/try-works/recursive-mode --skill recursive-worktree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: recursive-worktree
Source: https://github.com/try-works/recursive-mode/tree/main/skills/recursive-worktree
Command: npx skills add https://github.com/try-works/recursive-mode --skill recursive-worktree

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use this skill at the start of a recursive-mode run to set up an isolated git worktree, ensuring a clean baseline and keeping main/master safe from phase work.

Core Features & Use Cases

  • Create a feature-branch worktree in a prioritized location (e.g., .worktrees/ or worktrees/) to host Phase 0 work.
  • Verify a clean baseline, ensure git-ignore rules are respected, and record the baseline state in 00-worktree.md.
  • Output artifacts to the run directory and provide guidance for subsequent phases, routing, and memory capture.

Quick Start

Run this skill at the start of a run to create a feature-branch worktree and begin the Phase 0 baseline setup.

Frequently Asked Questions about recursive-worktree

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an isolated git worktree to keep my main branch safe during development?

To create an isolated git worktree, this skill bootstraps a feature-branch worktree in a prioritized directory like .worktrees/ to host Phase 0 work, ensuring your main or master branch remains protected from phase-specific changes.

Why should I use a git worktree for recursive-mode branch management?

Using a git worktree for recursive-mode branch management provides a clean baseline for your run, enforces a Phase 0 checklist, and records the baseline state in a 00-worktree.md artifact to prevent uncommitted changes from affecting subsequent phases.

How do I set up a recursive run baseline with git worktrees?

You set up a recursive run baseline by applying this skill at the start of a run; it validates a clean baseline, verifies git-ignore rules are respected, and outputs routing readiness guidance to the canonical run directory.

Can I use git worktrees to protect my main branch without manual git commands?

Yes, you can protect your main branch automatically as the skill creates a feature-branch worktree, records the baseline state, and prepares worktree routing without requiring manual git worktree add commands or branch checkout.

What happens if my baseline is not clean when starting a recursive-mode run?

If your baseline is not clean, the skill enforces a Phase 0 checklist to verify baseline cleanliness and ensure git-ignore rules are respected before proceeding, preventing uncommitted or untracked files from polluting the isolated worktree.

Does the recursive-worktree skill generate artifacts for subsequent development phases?

Yes, the skill outputs a ready 00-worktree.md artifact in the run directory that records the baseline state and provides guidance for subsequent phases, routing, and memory capture during your recursive-mode run.