doubleuuser/rlm-workflow/rlm-worktree

NEVER WORK ON MAIN/MASTER BRANCH WITHOUT EXPLICIT CONSENT

Phase 0R: 00-requirements.md (user-created first)
    ->
Phase 0W: 00-worktree.md (isolated workspace setup; this skill)
    ->
Phase 1: 01-as-is.md

# Check in priority order
ls -d .worktrees 2>/dev/null     # Preferred (hidden)
ls -d worktrees 2>/dev/null      # Alternative

grep -i "worktree.*director" CLAUDE.md 2>/dev/null
grep -i "worktrees" CLAUDE.md 2>/dev/null

No worktree directory found. Where should I create worktrees?
 
1. .worktrees/ (project-local, hidden - RECOMMENDED)
2. ~/.config/rlm-workflow/worktrees/<project-name>/ (global location)
 
Which would you prefer? (1/2)

# Check if directory is ignored (respects local, global, and system gitignore)
git check-ignore -q .worktrees 2>/dev/null || git check-ignore -q worktrees 2>/dev/null

project=$(basename "$(git rev-parse --show-toplevel)")
branch_name="rlm/${run_id}"

current_branch=$(git branch --show-current)
 
if [ "$current_branch" = "main" ] || [ "$current_branch" = "master" ]; then
    # STOP - Require explicit consent
    echo "WARNING: Currently on $current_branch branch."
    echo "RLM Workflow requires isolated worktrees."
    echo ""
    read -p "Create worktree and switch to feature branch? (yes/no): " consent
    
    if [ "$consent" != "yes" ]; then
        echo "Aborted. Please run from a feature branch or consent to worktree creation."
        exit 1
    fi
fi

# Determine full path
case $LOCATION in
  .worktrees|worktrees)
    path="$LOCATION/$run_id"
    ;;
  ~/.config/rlm-workflow/worktrees/*)
    path="~/.config/rlm-workflow/worktrees/$project/$run_id"
    ;;
esac
 
# Create worktree with new branch
git worktree add "$path" -b "$branch_name"
cd "$path"

# Node.js
if [ -f package.json ]; then 
    echo "Detected Node.js project"
    npm install
fi
 
# Rust
if [ -f Cargo.toml ]; then 
    echo "Detected Rust project"
    cargo build
fi
 
# Python
if [ -f requirements.txt ]; then 
    echo "Detected Python project (requirements.txt)"
    pip install -r requirements.txt
elif [ -f pyproject.toml ]; then 
    echo "Detected Python project (pyproject.toml)"
    poetry install || pip install -e .
fi
 
# Go
if [ -f go.mod ]; then 
    echo "Detected Go project"
    go mod download
fi
 
# Java/Maven
if [ -f pom.xml ]; then 
    echo "Detected Maven project"
    mvn compile -q
fi
 
# Java/Gradle
if [ -f build.gradle ] || [ -f build.gradle.kts ]; then 
    echo "Detected Gradle project"
    ./gradlew compileJava --quiet 2>/dev/null || gradlew compileJava --quiet 2>/dev/null
fi
 
# .NET
if [ -f *.csproj ] || [ -f *.sln ]; then 
    echo "Detected .NET project"
    dotnet restore
fi

# Detect test command and run
if [ -f package.json ]; then
    # Check for npm test script
    if grep -q '"test"' package.json; then
        echo "Running npm test..."
        npm test
    fi
elif [ -f Cargo.toml ]; then
    echo "Running cargo test..."
    cargo test
elif [ -f requirements.txt ] || [ -f pyproject.toml ]; then
    echo "Running pytest..."
    pytest -q || python -m pytest -q
elif [ -f go.mod ]; then
    echo "Running go test..."
    go test ./...
elif [ -f pom.xml ]; then
    echo "Running Maven tests..."
    mvn test -q
elif [ -f build.gradle ] || [ -f build.gradle.kts ]; then
    echo "Running Gradle tests..."
    ./gradlew test --quiet 2>/dev/null || gradlew test --quiet 2>/dev/null
elif [ -f *.csproj ] || [ -f *.sln ]; then
    echo "Running dotnet tests..."
    dotnet test --verbosity quiet
fi

## Worktree Details
 
**Location:** `/full/path/to/.worktrees/run-id`
**Branch:** `rlm/run-id`
**Created from:** `main` (commit: abc123)
**Setup commands executed:**
-npm install
-npm test (47 passing, 0 failing)
 
**Baseline verified:** ✅

branch=$(git branch --show-current)
 
if [ "$branch" = "main" ] || [ "$branch" = "master" ]; then
    echo "╔════════════════════════════════════════════════════════════╗"
    echo "║  !   MAIN BRANCH PROTECTION                                ║"
    echo "╠════════════════════════════════════════════════════════════╣"
    echo "║  You are currently on the $branch branch.                  ║"
    echo "║                                                            ║"
    echo "║  RLM Workflow requires isolated worktrees to:             ║"
    echo "║  • Prevent accidental commits to production               ║"
    echo "║  • Enable parallel requirement development                ║"
    echo "║  • Maintain clean main branch history                     ║"
    echo "║                                                            ║"
    echo "║  Options:                                                  ║"
    echo "║  1. Create worktree (RECOMMENDED)                          ║"
    echo "║  2. Switch to existing feature branch                      ║"
    echo "║  3. Abort and run from feature branch                      ║"
    echo "╚════════════════════════════════════════════════════════════╝"
    echo ""
    
    # Default to worktree creation
    echo "Creating worktree by default (press Ctrl+C to abort)..."
    sleep 3
fi

## Main Branch Work Acknowledgment
 
User has explicitly requested to work on main branch.
 
**Acknowledged risks:**
-[ ] Commits go directly to production branch
-[ ] No isolation for this requirement
-[ ] Cannot run parallel requirements
-[ ] Harder to discard if abandoned
 
**Consent:** User has chosen to proceed on main branch
**Reason:** [user-provided reason]
**Recorded:** [timestamp]
 
**Recommendation:** Use worktrees for future requirements.

Run: `/.codex/rlm/<run-id>/`
Phase: `00 Worktree Setup`
Status: `DRAFT` | `LOCKED`
Inputs:
-Current git repository state
-User preference (for worktree location)
Outputs:
-`/.codex/rlm/<run-id>/00-worktree.md`
-Isolated worktree at `[location]`
Scope note: This document records isolated workspace setup and verifies clean test baseline.
 
## Directory Selection
 
**Convention checked:**
-[ ] `.worktrees/` exists
-[ ] `worktrees/` exists
-[ ] CLAUDE.md preference found
-[ ] User preference obtained
 
**Selected location:** `.worktrees/` (project-local, hidden)
 
## Safety Verification
 
**Gitignore check:**

 
**Result:** ✅ Directory is properly ignored
 
## Worktree Creation
 
**Command:**

 
**Output:**

 
**Branch created:** `rlm/run-id`
**Location:** `/full/path/to/project/.worktrees/run-id`
 
## Project Setup
 
**Detected project type:** Node.js (package.json found)
 
**Commands executed:**

 
**Output:**

 
## Test Baseline Verification
 
**Command:**

 
**Results:**
- Total: 47 tests
- Passed: 47
- Failed: 0
- Skipped: 0
 
**Baseline:** ✅ Clean (all tests passing)
 
## Main Branch Protection
 
**Original branch:** `main`
**Worktree branch:** `rlm/run-id`
**Isolation:** ✅ Working in isolated worktree
 
## Traceability
 
- RLM process -> Isolated workspace established | Evidence: worktree at `.worktrees/run-id`
 
## Coverage Gate
 
- [ ] Worktree location selected following priority rules
- [ ] Directory verified as git-ignored (if project-local)
- [ ] Worktree created successfully on feature branch
- [ ] Project setup completed without errors
- [ ] Clean test baseline verified (all tests passing)
- [ ] Main branch protection confirmed (working in isolation)
 
Coverage: PASS / FAIL
 
## Approval Gate
 
- [ ] Isolated workspace ready for development
- [ ] No pending setup issues
- [ ] Ready to proceed to Phase 1/2
 
Approval: PASS / FAIL
 
LockedAt: `YYYY-MM-DDTHH:MM:SSZ`
LockHash: `<sha256-hex>`