git-worktree-swarm

Orchestrate parallel git worktrees with dependency-aware task waves.

558|75|Updated Dec 18, 2025
One-click install
npx skills add https://github.com/winstonkoh87/Athena-Public --skill git-worktree-swarm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-worktree-swarm
Source: https://github.com/winstonkoh87/Athena-Public/tree/main/examples/skills/coding/git-worktree-swarm
Command: npx skills add https://github.com/winstonkoh87/Athena-Public --skill git-worktree-swarm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the orchestration of parallel git worktrees to enable multi-agent collaboration on a single repository while preserving isolation and avoiding conflicts.

Core Features & Use Cases

  • Spawn and manage multiple worktrees to run tasks concurrently without interfering with the main workspace.
  • Use dependency-aware waves to sequence tasks based on file and data dependencies.
  • Provide safe, atomic merging and cleanup to keep the main branch clean and reproducible.

Quick Start

Start the swarm to initialize multiple worktrees and assign tasks across waves.

Frequently Asked Questions about git-worktree-swarm

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

FAQPage Schema
How do I run parallel tasks on the same git repository without workspace conflicts?

You can use parallel git worktrees to spawn isolated workspaces for concurrent multi-agent execution, preventing interference with the main branch. Dependency-aware wave sequencing ensures tasks respect file and data dependencies across isolated workspaces.

What is dependency-aware wave execution for multi-agent workflows?

Dependency-aware wave execution sequences parallel tasks across multiple agents by analyzing file and data dependencies. It groups tasks into waves, ensuring that dependent tasks wait for prerequisite work to complete before executing in isolated git worktrees.

How do I manage atomic commits and merging across multiple git worktrees?

Orchestrating parallel git worktrees enforces atomic commits and coordinated merging to keep the main branch clean. After tasks complete in isolated worktrees, the system applies safe merging and cleanup to ensure reproducible collaboration.

Can I use git worktrees for multi-agent collaboration on a large codebase?

Git worktrees are suited for multi-agent collaboration on a single repository regardless of scale. The orchestration system applies phase-based setup, dependency analysis, and context isolation to ensure safe, reproducible collaboration across concurrent agents.

When should I avoid using parallel git worktrees for task execution?

You should avoid parallel git worktrees when tasks share heavy file dependencies that prevent wave isolation, or when your workflow requires synchronous, sequential execution. Worktrees are designed for concurrent, dependency-respecting tasks rather than tightly coupled sequential operations.

Does git worktree orchestration handle automatic cleanup after merging?

Yes, parallel git worktree orchestration includes safe, atomic merging and automatic cleanup. After coordinated merging completes, the system removes isolated workspaces to keep the main branch clean and reproducible for future execution waves.