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.