git-worktree-workflow

Git Worktree Workflow Skill

This skill provides essential knowledge for agents working in isolated git worktrees. Use this to understand your workspace and how to work with files and git.

Your Workspace Environment

CRITICAL: You Are Already in a Git Worktree

DO NOT clone the repository! You are already working in an isolated git worktree.

• Your current directory IS the repository
• All files are already available locally
• Git credentials are pre-configured
• The repository is ready for you to work

What is a Git Worktree?

A worktree is an isolated working directory linked to a shared git repository. Multiple worktrees can exist simultaneously without interfering with each other.

Key characteristics:

• Isolated file system (your changes don't affect other jobs)
• Shared git history (commits are visible across worktrees)
• Pre-configured credentials (git push works automatically)

Check Your Current State

# Check if you're on a branch or in detached HEAD
git status

# If on a branch, see which one
git branch --show-current

# See recent commits
git log -1 --oneline

File Operations

Reading and Analyzing Files

Use these tools to explore the codebase:

• Read - Read file contents
• List - List directory contents
• Search - Search for files by name
• Grep - Search for text patterns in files
• Bash - Run shell commands for complex operations

# Find all Python test files
find tests/ -name "test_*.py"

# Search for specific error patterns
grep -r "import requests" src/

# Check current directory
pwd
ls -la

Modifying Files

Use these tools to implement fixes:

• Write - Create new files or overwrite existing ones
• Edit - Make targeted changes to existing files
• Bash - Run commands that modify files (formatters, etc.)

# Run auto-formatters (use virtual environment)
.venv/bin/black src/
.venv/bin/isort src/
.venv/bin/ruff check --fix .

# Run tests locally (use virtual environment)
.venv/bin/python -m pytest tests/
npm test