using-git-worktrees

Create isolated git worktrees with safe directory selection and baseline test verification.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/victorqnguyen/victors-architecture --skill using-git-worktrees-victorqnguyen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/victorqnguyen/victors-architecture/tree/main/packages/core/skills/using-git-worktrees
Command: npx skills add https://github.com/victorqnguyen/victors-architecture --skill using-git-worktrees-victorqnguyen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Isolates feature work from the current workspace by creating git worktrees with smart directory selection and safety verification.

Core Features & Use Cases

  • Isolated workspaces via git worktree creation to avoid disrupting the main branch.
  • Safe directory selection and verification to prevent accidental commits of worktree data.
  • Auto-detection of project name and location, plus automatic project setup and baseline test checks.

Quick Start

Create an isolated git worktree for a new feature and verify the baseline tests pass.

Frequently Asked Questions about using-git-worktrees

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an isolated git workspace for feature work?

You can create an isolated git workspace by setting up a git worktree to separate feature work from your current directory. This approach uses smart directory discovery and safety verification to prevent accidental commits of worktree data.

What is a git worktree and when should I use it for feature development?

A git worktree provides an isolated workspace linked to your main repository, allowing you to handle feature work without disrupting the main branch. Use it when starting feature work that requires safe directory selection and workspace isolation.

How do I prevent accidental git commits when using git worktrees?

You can prevent accidental commits in git worktrees by implementing safety verification via gitignore checks. This verifies that your worktree directory is ignored by the main repository, protecting your isolated workspace data from being accidentally committed.

Can I automatically run project setup and baseline tests after creating a git worktree?

Yes, after creating a git worktree, you can run optional project setup and baseline test verification. This automatically configures your isolated workspace and verifies that baseline tests pass before you begin your actual feature work.

Does git worktree creation work across diverse project types?

Git worktree creation supports diverse project types through auto-detection of project name and location. The process implements directory discovery and pre-implementation checks to ensure the isolated workspace is correctly configured across different project structures.

What are the limitations of using git worktrees for isolated feature work?

A key limitation of using git worktrees is the risk of accidental commits without proper safety verification. You must ensure gitignore checks and pre-implementation checks are actively configured to prevent worktree data from disrupting the main branch.