branch-setup

Create an isolated Git worktree with dependencies and baseline tests.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/heymishy/2x2-v3-28-03-20216 --skill branch-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: branch-setup
Source: https://github.com/heymishy/2x2-v3-28-03-20216/tree/main/.github/skills/branch-setup
Command: npx skills add https://github.com/heymishy/2x2-v3-28-03-20216 --skill branch-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates an isolated git worktree for a story before implementation begins, protecting the main branch from in-progress work and enabling reproducible testing environments.

Core Features & Use Cases

  • Isolated worktree creation on feature/[story-slug] branch to keep work separate from the main line.
  • Verifies that the worktree directory is git-ignored and updates .gitignore if needed.
  • Installs dependencies appropriate to the project's tech stack (npm, cargo, pip, poetry, etc.).
  • Runs a clean baseline test suite to ensure a ready state before coding begins.
  • Aligns with DoR sign-off and provides a smooth handoff to the implementation plan.

Quick Start

Invoke the branch-setup skill after DoR sign-off to create a new feature worktree, install dependencies, and verify a clean baseline.

Frequently Asked Questions about branch-setup

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

FAQPage Schema
How do I create an isolated git worktree for a new feature branch?

Creating an isolated git worktree involves automating directory discovery, feature branch creation, .gitignore validation, and dependency installation. This skill manages that setup to protect your main branch from in-progress changes.

What is the best way to protect the main branch from in-progress feature work?

The best way to protect the main branch is using an isolated git worktree on a feature branch. This separates in-progress changes, installs dependencies independently, and runs baseline tests to ensure a clean starting state.

Does git worktree setup automatically install dependencies for different tech stacks?

Yes, the worktree setup automatically detects common project types including npm, cargo, pip, and poetry, installing the appropriate dependencies within the isolated feature branch directory.

How do I verify a clean baseline test suite before starting implementation?

You verify a clean baseline test suite by running tests immediately after worktree creation and dependency installation. The skill executes this check and provides actionable guidance if any baseline tests fail before coding begins.

When do I need to validate .gitignore for a new git worktree?

You need to validate .gitignore for a new git worktree during the setup process. The skill verifies that the worktree directory is properly git-ignored and automatically updates the .gitignore file if needed.

Why does worktree creation require DoR sign-off before starting?

Worktree creation requires DoR sign-off to ensure the story is fully prepared before implementation begins. This aligns the isolated environment setup with project readiness criteria and enables a smooth handoff to the implementation plan.