metaswarm

v0.12.0

Multi-agent orchestration framework for Claude Code, Gemini CLI, and Codex CLI — 19 agents, 14 skills, quality gates, and TDD enforcement

CodexClaude Code14 skills

by David SifryMIT379updated 1 month ago

Source

$ git clone https://github.com/dsifry/metaswarm

Clone the source, then follow the repository's marketplace instructions for your runtime. The repository root is the plugin root.

Layout

metaswarm/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/brainstorming-extension/SKILL.md
├── skills/create-issue/SKILL.md
├── skills/design-review-gate/SKILL.md
├── skills/external-tools/SKILL.md
├── skills/handling-pr-comments/SKILL.md
├── skills/handoff/SKILL.md
├── skills/migrate/SKILL.md
├── skills/orchestrated-execution/SKILL.md
├── skills/plan-review-gate/SKILL.md
├── skills/pr-shepherd/SKILL.md
├── skills/setup/SKILL.md
├── skills/start/SKILL.md
├── skills/status/SKILL.md
└── skills/visual-review/SKILL.md

Skills14

brainstorming-extensionskills/brainstorming-extension/SKILL.md

Enforces design review gate after brainstorming — bridges superpowers:brainstorming into the metaswarm quality pipeline

create-issueskills/create-issue/SKILL.md

Create comprehensive GitHub issues with TDD plans, acceptance criteria, and agent instructions for autonomous PR lifecycle management

design-review-gateskills/design-review-gate/SKILL.md

Automatic review gate that runs after brainstorming completes - spawns PM, Architect, Designer, Security, and CTO agents in parallel, iterates until all approve

external-toolsskills/external-tools/SKILL.md

Delegate implementation and review tasks to external AI CLI tools (Codex, Gemini) with cross-model adversarial review

handling-pr-commentsskills/handling-pr-comments/SKILL.md

Address PR review feedback systematically — fetch inline comments, review bodies, handle outside-diff-range comments, resolve threads with proper attribution

handoffskills/handoff/SKILL.md

Analyze the current session and write a self-contained handoff document so a fresh agent can resume the work with full context — outputs a single "Read XXX.md and do YYY." sentence

migrateskills/migrate/SKILL.md

Migrate from npm-installed metaswarm to the marketplace plugin — removes redundant files with safety checks

orchestrated-executionskills/orchestrated-execution/SKILL.md

4-phase execution loop for work units - IMPLEMENT, VALIDATE, ADVERSARIAL REVIEW, COMMIT

plan-review-gateskills/plan-review-gate/SKILL.md

Automatic adversarial review gate that spawns 3 independent reviewers in parallel after any plan is drafted - all must PASS before presenting to user

pr-shepherdskills/pr-shepherd/SKILL.md

Monitor a PR through to merge — handle CI failures, review comments, and thread resolution automatically until all checks pass

setupskills/setup/SKILL.md

Interactive project setup — detects your project, configures metaswarm, writes project-local files

startskills/start/SKILL.md

Use when starting work on any task, when the user mentions metaswarm, or when the user wants to begin tracked development work

statusskills/status/SKILL.md

Diagnostic status report — shows metaswarm installation state, project setup, and potential issues

visual-reviewskills/visual-review/SKILL.md

Take screenshots of web pages and UI using Playwright for visual review and iteration

Manifests2

.codex-plugin/plugin.json

{
  "name": "metaswarm",
  "version": "0.12.0",
  "description": "Multi-agent orchestration framework for Claude Code, Gemini CLI, and Codex CLI — 19 agents, 14 skills, quality gates, and TDD enforcement",
  "author": {
    "name": "David Sifry",
    "email": "david@sifry.com"
  },
  "homepage": "https://github.com/dsifry/metaswarm",
  "repository": "https://github.com/dsifry/metaswarm",
  "license": "MIT",
  "keywords": [
    "orchestration",
    "agents",
    "tdd",
    "quality-gates",
    "beads",
    "codex"
  ],
  "skills": "./skills/",
  "interface": {
    "displayName": "metaswarm",
    "shortDescription": "Multi-agent orchestration, quality gates, TDD, and PR shepherding for Codex",
    "longDescription": "Use metaswarm to plan, decompose, execute, review, and shepherd development work with specialized agent roles, BEADS-backed tracking, strict quality gates, and cross-platform support for Claude Code, Gemini CLI, and Codex CLI.",
    "developerName": "David Sifry",
    "category": "Coding",
    "capabilities": [
      "Interactive",
      "Read",
      "Write"
    ],
    "websiteURL": "https://github.com/dsifry/metaswarm",
    "privacyPolicyURL": "https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement",
    "termsOfServiceURL": "https://docs.github.com/en/site-policy/github-terms/github-terms-of-service",
    "defaultPrompt": [
      "Use metaswarm to set up this project.",
      "Use metaswarm to start tracked work on this task.",
      "Use metaswarm to shepherd this PR until it is ready to merge."
    ],
    "brandColor": "#0F766E",
    "screenshots": []
  }
}

.claude-plugin/plugin.json

{
  "name": "metaswarm",
  "version": "0.12.0",
  "description": "Multi-agent orchestration framework for Claude Code, Gemini CLI, and Codex CLI — 19 agents, 14 skills, 16 commands, quality gates, TDD enforcement",
  "author": {
    "name": "David Sifry",
    "email": "david@sifry.com"
  },
  "homepage": "https://github.com/dsifry/metaswarm",
  "repository": "https://github.com/dsifry/metaswarm",
  "license": "MIT",
  "keywords": [
    "orchestration",
    "agents",
    "tdd",
    "quality-gates",
    "beads"
  ]
}