swarm-work

What problem does it solve?

Coordinating implementation tasks across multiple contributors and worktrees is error-prone and slow when done manually, especially when tasks have dependencies and require tests after each integration step. Swarm-work automates dispatch, isolated execution, merging, and test gating so maintainers can safely scale parallel work without corrupting the main tree.

Core Features & Use Cases

• Dependency-aware batching: Parses a plan, builds a dependency graph, and runs only tasks whose dependencies are satisfied.
• Worktree isolation and parallel execution: Dispatches up to five worktree-isolated worker agents per batch so each task runs in its own branch and environment.
• Safe integration and test gating: Retries failed workers once, merges branches sequentially with --no-ff, runs detected test suites after each batch, and stops on conflicts or persistent failures.
• Use case: Ideal for executing implementation plans like adding authentication, utilities, or config loaders where tasks specify files, acceptance criteria, and explicit dependencies.

Quick Start

Run the swarm-work skill with the path to your plan file to execute tasks in isolated worktrees, run tests after each batch, and receive a final completion report.