Agent-Skills.md

Agent Skills: Worktrees

Git worktree management for isolated task development

UncategorizedID: srstomp/pokayokay/worktrees

Repository

srstomp/pokayokay
srstomp
2

Install this agent skill to your local

pnpm dlx add-skill https://github.com/srstomp/pokayokay/tree/HEAD/plugins/pokayokay/skills/worktrees

Skill Files

Browse the full folder contents for worktrees.

Download Skill

Loading file tree…

plugins/pokayokay/skills/worktrees/SKILL.md

Skill Metadata

Name
worktrees
Description
Git worktree management for isolated task development

Worktrees

Guide for managing git worktrees in pokayokay.

When Worktrees Are Created

| Task Type | Default | Override | |-----------|---------|----------| | feature | Worktree | --in-place | | bug | Worktree | --in-place | | spike | Worktree | --in-place | | chore | In-place | --worktree | | docs | In-place | --worktree | | test | Inherits | explicit flag |

Key Principles

  • Story-based reuse — Tasks in the same story share a worktree for related changes
  • Auto dependency install — Dependencies install automatically on worktree creation
  • Clean completion — Choose merge, PR, keep, or discard when done
  • Isolation — All worktrees live in .worktrees/ (auto-ignored by git)

Quick Start Checklist

  1. Task type determines worktree vs in-place (see table above)
  2. Story worktrees are reused across related tasks
  3. Dependencies auto-install based on detected lockfiles
  4. On completion: merge to main, create PR, keep, or discard
  5. Troubleshoot with git worktree list if issues arise

References

| Reference | Description | |-----------|-------------| | worktree-management.md | Lifecycle, completion options, dependency install, troubleshooting | | cleanup-strategies.md | Cleanup criteria, detection, disk management, scheduled cleanup | | parallel-worktrees.md | Parallel execution worktree isolation, conflict prevention |