worktree-guide

Community

Streamline parallel work with AI-driven git worktrees.

Authorpoindexter12
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Git worktrees enable parallel development by allowing multiple branches to be checked out in separate directories, but without standardized AI metadata and templates teams can lose track of purpose, scope, and ownership. This Skill provides a structured guide for managing Git worktrees and their AI context, including templates, mode semantics, naming conventions, and best practices to improve discoverability, consistency, and safety.

Core Features & Use Cases

  • AI-context metadata templates and guidance for each worktree (e.g., .ai-context.json and README.working-tree.md) to document intent and history.
  • Mode semantics and naming conventions to influence AI behavior and team workflows across main, feature, bugfix, experiment, and review worktrees.
  • Comprehensive references and example workflows to accelerate adoption and ensure consistent practices across the repository.

Quick Start

Create a new feature worktree with a descriptive description by running /working-tree:new feature/<name> --mode feature --description 'Describe the feature'

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: worktree-guide
Download link: https://github.com/poindexter12/waypoint/archive/main.zip#worktree-guide

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.