rlm-worktree

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.