rlm-worktree

Create an isolated git worktree with a verified clean test baseline.

67|2|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/doubleuuser/rlm-workflow --skill rlm-worktree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rlm-worktree
Source: https://github.com/doubleuuser/rlm-workflow/tree/main/skills/rlm-worktree
Command: npx skills add https://github.com/doubleuuser/rlm-workflow --skill rlm-worktree

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents accidental commits to main, avoids repository pollution, and ensures reproducible, isolated workspaces with a verified clean test baseline before development begins.

Core Features & Use Cases

  • Directory selection policy: prefers .worktrees then worktrees and consults CLAUDE.md or asks the user when ambiguous.
  • Safety verification and auto-fix: checks that project-local worktree directories are git-ignored and can add and commit .gitignore entries automatically.
  • Worktree creation and branch protection: creates rlm/<run-id> feature branches in a worktree, requires explicit consent when invoked from main/master, and records Phase 0 artifacts for traceability.
  • Project auto-setup and baseline testing: auto-detects common project types (Node, Python, Rust, Go, Java, .NET) to run setup commands and execute tests to verify a clean baseline.
  • RLM integration: enforces Phase 0 gating, locks the artifact before proceeding, and scopes all subsequent phases to the worktree context.
  • Use Case: start any RLM requirement run, perform safe isolation, run project setup and tests, and produce a Phase 0 document that proves readiness for implementation.

Quick Start

Create an isolated worktree for run 2026-02-24-add-oauth, verify the worktree directory is ignored, run project setup, and confirm a clean test baseline before proceeding.

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 to prevent accidental commits to the main branch?

To create an isolated git worktree, the tool selects a project-local directory, ensures it is git-ignored, creates a dedicated feature branch, and records a Phase 0 artifact for traceability. This prevents accidental commits and main branch contamination.

Why does my git worktree directory show up as untracked files in my repository?

Git worktree directories appear as untracked files when they are not listed in .gitignore. The tool verifies project-local worktree directories are git-ignored and can automatically add and commit the .gitignore entries to prevent repository pollution.

How do I verify a clean test baseline before starting feature development in a new worktree?

To verify a clean test baseline, the tool auto-detects your project type, runs setup commands, and executes tests immediately after creating the worktree. This ensures a verified clean test baseline before development begins.

Does this git worktree workflow support Python and Node project auto-setup?

Yes, the git worktree workflow supports auto-setup for Node, Python, Rust, Go, Java, and .NET project types. It automatically detects the project type to run appropriate setup commands and execute baseline tests.

Can I create a git worktree feature branch directly from the main branch?

You can create a git worktree feature branch from main, but the tool requires explicit consent when invoked from main or master branches. This safety verification prevents accidental branch protection violations during worktree creation.

What is the best way to isolate experiments in git without contaminating the main repository?

The best way to isolate experiments is using a git worktree that creates an rlm feature branch, applies directory selection priority rules, and ensures the workspace is git-ignored. This isolates development while maintaining a verified clean test baseline.