harness:using-git-worktrees

What problem does it solve?

It prevents risky cross-contamination between your current workspace and new feature work by ensuring changes happen in an isolated Git environment.

Core Features & Use Cases

• Isolated workspace detection: Detects whether you are already inside a linked worktree or a submodule and avoids creating nested worktrees unnecessarily.
• Preference-aware setup: Asks for consent when you have not declared a worktree preference, then honors existing guidance if already provided.
• Robust creation and safety checks: Prefers native worktree tools when available, otherwise falls back to git worktree add with ignored-directory verification for project-local paths, then runs setup and a clean baseline test pass.
• Use case: Starting a feature that touches many files (e.g., implementing F002) without risking your main branch or your ongoing edits.

Quick Start

Ask the AI: "Set up an isolated worktree for feature F002 and verify the baseline tests pass before I start implementing."