phuryn

Swarm Protocol — Design skill for Claude Code

Design community

Coordination protocol for agent-first teams.

How to install Swarm Protocol

This entry records only its repository, not the path inside it, so there is no exact command to give. Open phuryn/swarm-protocol and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Swarm Protocol does

Coordination protocol for agent-first teams. No UI. No sprints. No Jira. Just state sync.

Alternatives in Design

Od Contribute — Open a first-contribution PR (or bug issue) on nexu-io/open-design — works for non-coders too 91.8k ★
Brainwave — Learn to create modern websites with sleek parallax effects and bento box layouts 1.9k ★
Claude Agent Teams UI — You're the CTO, agents are your team 645 ★

README

🐝 Swarm Protocol

[![Tests](https://github.com/phuryn/swarm-protocol/actions/workflows/test.yml/badge.svg)](https://github.com/phuryn/swarm-protocol/actions/workflows/test.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-0d9488?style=flat-square)](https://github.com/phuryn/swarm-protocol/blob/main/LICENSE) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-0d9488?style=flat-square)](https://github.com/phuryn/swarm-protocol/blob/main/CONTRIBUTING.md)

**Coordination protocol for agent-first teams. No UI. No sprints. No Jira. Just state sync.**

**Status: Alpha — building in public. [19 MCP tools](#all-19-tools) implemented, integration tests passing.**

The Coordination Loop

Drop [`COORDINATION.md`](claude-md/COORDINATION.md) into your repo's `CLAUDE.md` and agents coordinate automatically:

Agent starts session
  → get_team_status        "What's in flight?"
  → claim_work             "I'm taking this — here are my files"
  → check_conflicts        "Anyone else touching src/api/router.ts?"
  → heartbeat              "Still working" (every 10-15 min)
  → complete_claim          "Done — this unblocks intent_xyz"
                              ↳ intent_xyz status: blocked → open
                              ↳ Next agent picks it up automatically

Zero Slack messages. Zero status meetings. Agents coordinate through shared state.

What This Is

A headless coordination layer exposed as an MCP server — the same protocol Claude Code already speaks. No REST API. No dashboard. Agents query it to see what's in flight, claim work, detect file conflicts, and hand off unblocked tasks.

This is a **coordination protocol, not a project management tool.** Jira was built for humans clicking buttons. This is state synchronization infrastructure for teams where agents are the primary development interface.

The CLAUDE.md integration pattern is as important as the server itself. Agents coordinate automatically without humans configuring anything.