← ClaudeAtlas

agent-wavelisted

Orchestrate a wave of parallel agents over the plan/todo queue in a documentation-led repo — asks how many agents, the budget (items/waves, with hours as a soft cap), and whether to checkpoint after each wave or run continuously. Spawns isolated worktree subagents, assigns one queue item each, collects results. Use when the user says "spawn a wave of agents", "run the queue in parallel", "fan out the work", "agent wave", or invokes /agent-wave.
EvolveHQ/docflow · ★ 3 · AI & Automation · score 74
Install: claude install-skill EvolveHQ/docflow
# agent-wave Drive the implementation queue with parallel subagents, in waves. ## Honest scope (read first) In-session subagents are bounded by **this session**, not by wall-clock hours. So this skill measures budget reliably in **items and waves**, with hours as a *soft cap* (stop starting new waves once elapsed time passes it). For a true multi-hour unsupervised fleet that outlives a session, use remote agents or a scheduled run of `_agent/prompts/autonomous.md` (`/schedule`) instead — this skill points you there rather than pretending to be it. ## Step 0 — Preconditions and context 1. Confirm the repo is bootstrapped with a `plan/` queue and that `_agent/prompts/autonomous.md` exists (a real verify gate is required — see the **bootstrap** skill, Q8). 2. Read `CONVENTIONS.md` for the **multi-agent mode** and **integration model**. - **Mode 1 (single agent):** refuse. Parallel agents in one checkout clobber each other. Tell the user to re-bootstrap as mode 2/3, or run the autonomous prompt sequentially instead. - **Mode 2 (shared checkout):** allowed but warn — file contention is real; LOCKS must be respected and wave width kept low. - **Mode 3 (worktrees):** the intended mode. Each subagent works in its own isolated worktree. ## Step 1 — Ask the wave parameters (one at a time, recommend) 1. **Wave width N** — how many agents per wave. *Recommended: min(queue depth, 3)* — modest, keeps review tractable. 2. **Budget** — total it