dispatch

Dispatches tasks to agents in isolated git worktrees for parallel execution.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/Zeyad-37/tech-agency --skill dispatch-zeyad-37
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dispatch
Source: https://github.com/Zeyad-37/tech-agency/tree/main/.claude/skills/dispatch
Command: npx skills add https://github.com/Zeyad-37/tech-agency --skill dispatch-zeyad-37

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running multiple AI agents on the same repository at once causes file conflicts and agents overwriting each other's work. This Skill isolates each task in its own git worktree with its own branch, so parallel agents never collide and each change merges back through its own PR. ## Core Features & Use Cases - Isolated Worktree Orchestration: Creates one git worktree and branch per task from a resolved base branch (main, an epic integration branch, or a release tag for hotfixes) before any agent starts. - Parallel Agent Dispatch: Spawns multiple agents simultaneously via the Task tool, each with a mandatory preamble forcing it to cd into its worktree and verify pwd and branch before working. - Base Branch Resolution: Supports --base overrides, epic integration branch detection, and hotfix tagging, ensuring each PR targets the branch it was cut from. - Use Case: Dispatch three tasks at once — @Kai implementing a login screen off an epic branch, @Sentinel setting up monitoring off main, and @Link refactoring a network module — each producing an independent PR without merge conflicts. ## Quick Start Ask the agent to dispatch @Kai to implement the login screen and @Sentinel to set up monitoring dashboards in parallel using git worktrees.

Frequently Asked Questions about dispatch

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

FAQPage Schema
How do I run multiple AI agents in parallel on the same git repository?▼

Create a separate git worktree and branch for each task, then spawn one agent per worktree with instructions to cd into its directory first. Each agent commits on its own branch and opens its own PR, so no two agents touch the same files.

How do I dispatch a task to an agent in a git worktree?▼

Run /dispatch followed by the agent name and task, for example /dispatch @Kai implement login screen. The orchestrator creates the worktree from the resolved base branch, then spawns the agent with a mandatory setup preamble that verifies the working directory.

Can I branch a dispatched task off an epic branch instead of main?▼

Yes, pass --base with the branch name or let the skill detect an epic integration branch matching epic/{EPIC-ID}-{slug}. The worktree branches from that base and its PR merges back into the same branch, never directly to main.

When should I not use git worktrees for parallel tasks?▼

Avoid dispatch when tasks have sequential dependencies, when two tasks modify the same files, or for trivial one-line fixes and planning-only work like PRDs. These cases create merge conflicts or add overhead without benefit.

What happens if an agent works in the wrong directory?▼

Stop immediately, run pwd and git branch --show-current to confirm the location, then cd into the correct worktree from the dispatch tracker. Revert any files modified in the wrong directory with git checkout -- . before resuming.

How are git worktrees cleaned up after the PR merges?▼

Cleanup is automatic: the next /create-pr run enumerates all worktrees, checks each branch against merged PRs via gh pr list, and removes merged worktrees and branches. Failed dispatches can be removed manually with git worktree remove and git branch -D.