rlm-worktree

Creates isolated git worktrees with verified test baselines for RLM requirement development.

2|3|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/spideynolove/claude-dotfiles --skill rlm-worktree-spideynolove
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rlm-worktree
Source: https://github.com/spideynolove/claude-dotfiles/tree/main/.agents-global/skills/rlm-workflow/skills/rlm-worktree
Command: npx skills add https://github.com/spideynolove/claude-dotfiles --skill rlm-worktree-spideynolove

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working directly on the main branch during feature development risks accidental commits to production, branch pollution, and conflicts between parallel requirements. This Skill enforces isolated git worktree setup as Phase 0 of every RLM run, with safety verification before any development begins. ## Core Features & Use Cases - Automated Worktree Creation: Detects or prompts for a worktree directory (.worktrees/, worktrees/, or a global location), verifies it is git-ignored, and creates a feature branch following the rlm/<run-id> naming pattern. - Main Branch Protection: Detects when the user is on main/master and requires explicit consent or automatically creates an isolated worktree before proceeding. - Project Setup and Baseline Verification: Auto-detects project type (Node.js, Rust, Python, Go, Maven, Gradle, .NET), installs dependencies, runs the test suite, and records a clean baseline in a Phase 0 artifact. - Use Case: When starting a new requirement like "add OAuth support", invoke this Skill to spin up .worktrees/2026-02-24-add-oauth on branch rlm/2026-02-24-add-oauth, run npm install and npm test, and confirm all 47 tests pass before writing any code. ## Quick Start Ask the AI to set up an isolated git worktree for your new requirement and verify a clean test baseline before starting development.

Frequently Asked Questions about rlm-worktree

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

FAQPage Schema
How do I create an isolated git worktree for feature development?

Run git worktree add with a target path and the -b flag to create a new branch, such as git worktree add .worktrees/my-feature -b rlm/my-feature. This Skill automates the full process including directory selection, gitignore verification, and baseline testing.

How do I prevent accidental commits to the main branch?

Use git worktrees to develop on a separate feature branch in an isolated directory. This Skill detects when you are on main or master and either creates a worktree by default or requires explicit documented consent before proceeding.

Where should git worktrees be stored in a project?

The recommended location is a hidden .worktrees/ directory inside the project, verified as git-ignored via git check-ignore. Alternatives include a worktrees/ directory or a global location like ~/.config/rlm-workflow/worktrees/<project-name>/.

Why does git check-ignore matter before creating a worktree?

If a project-local worktree directory is not git-ignored, its contents appear in git status and risk being committed to the repository. The Skill verifies ignore status first and commits a .gitignore fix if the directory is not excluded.

What happens if baseline tests fail in a new worktree?

The Skill reports the failing tests and asks whether to proceed or investigate rather than continuing silently. This ensures pre-existing failures are distinguished from bugs introduced during development, and the decision is documented in the Phase 0 artifact.

Can multiple requirements be developed in parallel with git worktrees?

Yes, each requirement gets its own worktree directory and rlm/<run-id> branch sharing the same repository. This allows three or more requirements to be developed simultaneously without branch switching or merge conflicts between workspaces.