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.