How am-will/swarms works
Swarms is a set of agent-orchestration skills for planning software work and executing it in dependency-aware parallel waves. The documented main workflow starts with a user request, proceeds through codebase research, clarification, planning and review, then hands the plan to an orchestrator that launches subagents, checks their work and advances through waves. README evidence supports this workflow and the Context7 integration; the other skill files are present in the tree but their behavior is not documented in the available excerpts.
Main entry points: swarm-planner/SKILL.md Swarm Planner · parallel-task/SKILL.md Orchestrator
Components 17
Planning
- Swarm Planner
skills/swarm-planner/SKILL.md - Codebase Research
skills/swarm-planner/SKILL.md - Clarifications
skills/swarm-planner/SKILL.md - Dependency Plan
skills/swarm-planner/SKILL.md - Plan Review
skills/swarm-planner/SKILL.md
Execution
- Parallel Task
skills/parallel-task/SKILL.md - Orchestrator
skills/parallel-task/SKILL.md - Subagents
skills/parallel-task/SKILL.md - Wave Execution
skills/parallel-task/SKILL.md - Work Verification
skills/parallel-task/SKILL.md
Other Skills
- Co-design
skills/co-design/SKILL.md - Spark Parallel
skills/parallel-task-spark/SKILL.md - Tmux Parallel
skills/parallel-task-tmux/SKILL.md - Super Swarm
skills/super-swarm/SKILL.md - Spark Super Swarm
skills/super-swarm-spark/SKILL.md
Other components
- User
- Context7 MCP
Connections 13
- User → Swarm Planner: requests planning
README.md - Swarm Planner → Codebase Research: researches codebase
README.md - Swarm Planner → Context7 MCP: fetches docs
README.md - Swarm Planner → Clarifications: asks questions
README.md - Swarm Planner → Dependency Plan: produces plan
README.md - Swarm Planner → Plan Review: spawns review
README.md - User → Parallel Task: requests execution
README.md - Parallel Task → Orchestrator: coordinates work
README.md - Orchestrator → Dependency Plan: parses tasks
README.md - Orchestrator → Subagents: launches parallel
README.md - Orchestrator → Wave Execution: advances waves
README.md - Subagents → Work Verification: returns summaries
README.md - Orchestrator → Work Verification: verifies work
README.md