worktree-guide
CommunityStreamline parallel work with AI-driven git worktrees.
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 requiredComponents
💻 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.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.