swarm-wave SKILL.md skillA

swarm-wave from voxpelli/claude-beads is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add voxpelli/claude-beads/swarm-wave@git:20260602.f6606a8

Pins git:20260602.f6606a8 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
voxpelli/claude-beads
Path
skills/swarm-wave/SKILL.md
Versions recorded
5
Latest version
git:20260602.f6606a8, committed Jun 2, 2026
First version recorded
May 8, 2026
Size
19,621 bytes
Repository stars
3
License
MIT

Orchestrate multi-agent development sprints with wave-based parallelism. Use when the user wants to plan a swarm sprint, partition work into file-disjoint waves, map file contention across open issues, run a post-wave quality gate with review agents, manage agent backpressure, run a parallel research wave, or coordinate multiple concurrent agents on a shared codebase. Works with or without beads: sources waves from the beads backlog, from a ROADMAP.md, or from a manually supplied work list.…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Swarm Wave

Orchestrate multi-agent development sprints using the swarm wave pattern: group
file-disjoint work into waves, launch parallel task agents per wave, enforce a
blocking quality gate before committing, and track sprint state in `SWARM-NN.md`
files.

File isolation is the primary safety mechanism — agents within a wave each own
distinct files, preventing merge conflicts without relying on worktrees.

This skill does not create beads issues (use `/backlog-groomer`), write
retrospectives (use `/retrospective`), or gate sprint closure (the
`sprint-review` agent handles that). It orchestrates the execution phase
between backlog grooming and sprint close.

## SWARM Files

Sprint state is tracked in `SWARM-NN.md` files in the project root (NN =
sprint number). These are gitignored — they are ephemeral working documents,
not committed artifacts.

Structure:

```markdown
# SWARM-NN — Sprint Theme

Waves: N | Issues: N | Started: YYYY-MM-DD

## Wave 1 — [Theme]

Status: pending | running | gate-pending | gate-passed | committed
Issues: id1, id2, id3

### Agent Assignments

- Agent A: [file1, file2] -> issue-id
- Agent B: [file3] -> issue-id
- Research: [topic]

### Item Status
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add voxpelli/claude-beads/swarm-wave@sha256:2d6041426045c894

The line at the top of this page pins the label git:20260602.f6606a8, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_44qdnu44rur5xur6.svg)](https://markdownregistry.com/a/art_44qdnu44rur5xur6)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between May 8, 2026 and Jun 2, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20260602.f6606a8 latest2026-06-02 f6606a8 19,621 BA view · diff
git:20260602.d9bfecd2026-06-02 d9bfecd 19,539 BA view · diff
git:20260602.6cb05c52026-06-02 6cb05c5 16,313 BA view · diff
git:20260508.dbe75662026-05-08 dbe7566 16,308 BA view · diff
git:20260508.5e1c27a2026-05-08 5e1c27a 16,029 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (19621 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

voxpelli/claude-beads · 3 stars · license MIT · pushed 2026-10-15 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_44qdnu44rur5xur6
GET https://markdownregistry.com/api/v1/resolve?ref=voxpelli/claude-beads/swarm-wave
GET https://markdownregistry.com/api/v1/blob/2d6041426045c894753c6e45f19824de743f0c0e1aac44a214b91349c74aea9b

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from voxpelli/claude-beads

CLAUDE.md CLAUDE.md file
voxpelli/claude-beads · CLAUDE.md
git:20260604.119543a · audit A · 3 stars
backlog-groomer SKILL.md skill
voxpelli/claude-beads · skills/backlog-groomer/SKILL.md · Manage the beads backlog for this project. Use when the user wants to review or triage open issues, reprioritize the…
git:20260602.039a530 · audit A · 3 stars
harden-memories SKILL.md skill
voxpelli/claude-beads · skills/harden-memories/SKILL.md · Audit the `bd remember` store and recommend which entries to prune, so each one earns its per-session `bd prime`…
git:20260603.e8734c3 · audit A · 3 stars
retrospective SKILL.md skill
voxpelli/claude-beads · skills/retrospective/SKILL.md · Run a sprint retrospective for this project. Use when the user says 'retrospective', 'retro', 'close out the sprint'…
git:20260602.998284b · audit A · 3 stars
sibling-sync SKILL.md skill
voxpelli/claude-beads · skills/sibling-sync/SKILL.md · Bilateral SYNERGY/UPSTREAM reconciliation across sibling projects. Use when the user wants to sync sibling…
git:20260604.119543a · audit A · 3 stars
synergy-tracker SKILL.md skill
voxpelli/claude-beads · skills/synergy-tracker/SKILL.md · Manage cross-project synergy tracking between sibling projects. Use when the user wants to log a shared pattern, a…
git:20260604.119543a · audit A · 3 stars
upstream-tracker SKILL.md skill
voxpelli/claude-beads · skills/upstream-tracker/SKILL.md · Manage upstream issue tracking for this project. Use when the user wants to log a bug or friction point in a vendor…
git:20260602.6cb05c5 · audit A · 3 stars
vendor-sync SKILL.md skill
voxpelli/claude-beads · skills/vendor-sync/SKILL.md · Pull latest upstream changes from vendor subtrees into this project. Use when the user says 'sync vendor', 'pull…
git:20260602.6cb05c5 · audit A · 3 stars

Every file in voxpelli/claude-beads

Browse by kind, by grade A, or by owner.