worktree-agent

Coordinate multiple AI agents across parallel git worktrees with manifests and lock management.

Updated Jan 11, 2026
One-click install
npx skills add https://github.com/AdemKao/ai-cowork --skill worktree-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-agent
Source: https://github.com/AdemKao/ai-cowork/tree/main/.ai/skills/worktree-agent
Command: npx skills add https://github.com/AdemKao/ai-cowork --skill worktree-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinating multiple AI agents across parallel git worktrees to enable scalable, conflict-free development workflows.

Core Features & Use Cases

  • Assess parallelization viability and outline a dedicated worktree structure for each agent.
  • Create a central coordination session with manifests, progress tracking, and per-task worktrees.
  • Manage inter-agent communication, lock management, and synchronization points to streamline collaboration.

Quick Start

Create a new worktree coordination session and set up two parallel worktrees for API and UI tasks.

Frequently Asked Questions about worktree-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate parallel AI agents using git worktrees to prevent file conflicts?

Git worktree coordination enables parallel AI development by assigning each agent a dedicated worktree, central manifest, and progress tracker to isolate changes and enforce synchronization. This prevents merge conflicts across feature branches.

What is a git worktree session for multi-agent software projects?

A worktree session is a central coordination environment that manages manifests, lock management, and inter-agent communication for multiple AI agents. It tracks progress and enforces synchronization points across distinct feature worktrees.

How do I set up parallel worktrees for separate API and UI development tasks?

You create a new worktree coordination session and outline a dedicated worktree structure for each agent. The system then partitions tasks, creating separate worktrees for the API and UI tasks to run in parallel.

How does lock management work for AI agents sharing context in parallel development?

Lock management enforces synchronization points by restricting access to shared files or resources during parallel development. This ensures AI agents communicate and coordinate progress without overwriting each other's shared context updates.

When should I assess parallelization viability for multi-agent git worktrees?

Assess parallelization viability before creating a worktree coordination session to ensure your multi-agent software project supports task partitioning. This evaluation determines if distinct worktrees can operate independently without constant synchronization.