setting-up-implementation-worktree

An isolated git worktree creates a separate working directory linked to your repository, letting you work on a feature branch without affecting your main workspace. This Skill sets up a fresh worktree, validates dependencies, runs tests, and confirms readiness before you begin implementation.

Use a worktree when you need a verifiably clean baseline, must run tests in isolation, or want to work on multiple branches simultaneously without switching. This Skill removes and recreates worktrees to guarantee a reproducible environment and prevent interference from your active workspace.

Before creating a worktree, your git state must be clean, tests must pass, and dependencies must be installed. This Skill runs these checks automatically, installs dependencies in the new worktree, verifies tests pass, and confirms the environment is ready for implementation work.

After creating an isolated worktree, this Skill automatically installs dependencies and runs your test suite to verify the environment works correctly. This validation step guarantees a clean baseline before you start any implementation.

This Skill removes any existing worktree for your current branch and recreates it from scratch. Recreation ensures reproducibility and eliminates stale state or lingering configuration that could compromise test isolation.