What problem does it solve?
Swarm removes the manual overhead of turning a raw idea into a reviewed, tested pull request by orchestrating an end-to-end, multi-agent workflow that handles specification, planning, parallel implementation, review, knowledge extraction, and PR delivery.
Core Features & Use Cases
- Interactive PM specification: Guided clarifying questions, scope proposals, and a written spec saved to docs/specs/YYYY-MM-DD-<topic>.md, requiring explicit user confirmation before automated phases.
- Automated parallel planning: Dispatches Research, Codebase, and Docs agents in parallel to produce a merged implementation plan saved to docs/plans/YYYY-MM-DD-<topic>.md.
- Isolated parallel work and test gating: Runs worker agents in isolated worktrees, executes batches with retries, merges changes, runs tests after each batch, and collects abnormal reports for later knowledge extraction.
- Integration review and auto-fix: Runs an integration agent against the combined diff to auto-fix P1 issues and surface P2/P3 notes.
- Ship flow with dual reviews and controlled merge: Creates a PR, runs tests, posts dual-agent reviews as comments, counts critical issues, and requires explicit user confirmation to merge.
- Use case: Start a new feature or small project and let Swarm create the spec, plan tasks, run parallel worker agents, validate integration, extract learnings, and open the PR for human-approved merge.
Quick Start
Use the swarm skill by invoking /swarm followed by a one-sentence idea to start the interactive PM session and automated pipeline.