What does the .ai-context.json file do?

This file stores metadata including the worktree's purpose, creation date, and mode. It serves as a persistent context layer that helps Claude understand exactly what you are trying to achieve in that specific folder.

What is the benefit of worktrees over standard branch switching?

Worktrees allow you to have multiple branches checked out in separate directories at once. This eliminates the need to stash changes, re-index IDEs, or rebuild dependencies when switching between tasks.

Can I use this skill with existing Git worktrees?

Yes, you can use the /working-tree:adopt command to automatically generate the necessary metadata files and integrate existing worktrees into this workflow.

How do worktree modes affect Claude's behavior?

Modes like 'experiment' or 'bugfix' tell Claude the current context. In experiment mode, Claude provides more aggressive suggestions, while in bugfix or main mode, it focuses on conservative, safety-first corrections.

How do I remove a worktree using this skill?

You can use the /working-tree:destroy command, which cleans up the worktree and handles the associated metadata safely.

Git Worktree Workflow Guide

Name: Git Worktree Workflow Guide
Author: poindexter12

bypoindexter12

Developer Tools

Optimizes multi-branch development by managing Git worktrees with specialized AI-context metadata and task-specific modes.

About

The Git Worktree Guide skill provides a structured framework for managing multiple active Git branches simultaneously without the overhead of constant context switching. It introduces specialized 'Mode Semantics'—such as main, feature, bugfix, experiment, and review—which allow Claude to adjust its behavior and suggestions based on the specific purpose of the current worktree. By integrating standardized metadata like .ai-context.json and automated templates, this skill ensures that your development environment remains organized, documented, and optimized for AI-assisted coding across complex projects.

Key Features

Automated generation of worktree-specific README files for better documentation and team clarity.
Automated creation and management of worktrees via dedicated /working-tree slash commands.
Specialized worktree modes (feature, bugfix, experiment) that tailor AI behavior to the task at hand.
Integrated AI-context metadata templates to preserve branch purpose and development status.
Progressive disclosure system providing quick references, best practices, and strategic organization patterns.
0 GitHub stars

Use Cases

Isolated prototyping in 'experiment' mode where AI is encouraged to suggest more aggressive, creative solutions.
Switching instantly between a long-term feature development branch and a critical production hotfix.
Conducting code reviews in a dedicated 'review' mode worktree to avoid disrupting your own uncommitted work.

About

Key Features

Automated generation of worktree-specific README files for better documentation and team clarity.
Automated creation and management of worktrees via dedicated /working-tree slash commands.
Specialized worktree modes (feature, bugfix, experiment) that tailor AI behavior to the task at hand.
Integrated AI-context metadata templates to preserve branch purpose and development status.
Progressive disclosure system providing quick references, best practices, and strategic organization patterns.
0 GitHub stars

Use Cases

Isolated prototyping in 'experiment' mode where AI is encouraged to suggest more aggressive, creative solutions.
Switching instantly between a long-term feature development branch and a critical production hotfix.
Conducting code reviews in a dedicated 'review' mode worktree to avoid disrupting your own uncommitted work.