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

0•

Developer Tools

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

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

01Automated generation of worktree-specific README files for better documentation and team clarity.

02Automated creation and management of worktrees via dedicated /working-tree slash commands.

03Specialized worktree modes (feature, bugfix, experiment) that tailor AI behavior to the task at hand.

04Integrated AI-context metadata templates to preserve branch purpose and development status.

05Progressive disclosure system providing quick references, best practices, and strategic organization patterns.

060 GitHub stars

Use Cases

01Isolated prototyping in 'experiment' mode where AI is encouraged to suggest more aggressive, creative solutions.

02Switching instantly between a long-term feature development branch and a critical production hotfix.

03Conducting code reviews in a dedicated 'review' mode worktree to avoid disrupting your own uncommitted work.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add poindexter12/waypoint working-tree

For use in Claude.ai and ChatGPT

Download Skill