swarm

name	swarm
audience	swarm-plugin
description	Enable a high-quality swarm-like Claude Code workflow for the current session, and optionally execute a task immediately using that mode. Uses parallel subagents for breadth, independent reviewer validation for precision, and critic challenge for final confidence. Use when the user wants swarm-like behavior, higher review rigor, or maximum quality without sacrificing Claude Code speed.
disable-model-invocation	true
argument-hint	[optional task]

/swarm

Enable swarm mode for the current session. If arguments are provided, enable swarm mode first and then execute that task using the swarm-like implementation workflow.

Argument handling:

• If no arguments are provided: only enable swarm mode.
• If the first word of $ARGUMENTS is a known plugin subcommand (see list below): do NOT treat it as a swarm task. Instead, tell the user to run it as a slash command directly (e.g., /swarm close, /swarm handoff). These are OpenCode plugin commands handled by the swarm plugin's command system, not tasks for the swarm workflow. Do NOT try to interpret or execute them yourself.
• Otherwise: enable swarm mode, then treat $ARGUMENTS as the task to execute immediately.

SWARM-NAMESPACED subcommands — DO NOT confuse with Claude Code built-in commands

These are invoked as /swarm <subcommand>, NOT as bare /subcommand. The list below is generated from the COMMAND_REGISTRY (src/commands/registry.ts) and includes all registered non-deprecated base commands and subcommands:

Core / state

• /swarm status — show current swarm state
• /swarm show-plan — show current plan (optionally filter by phase number)
• /swarm plan — deprecated alias for /swarm show-plan
• /swarm agents — list registered agents
• /swarm help — show help for swarm commands (optionally [command])
• /swarm history — show completed phases summary
• /swarm config — show current resolved configuration
• /swarm export — export plan and context as JSON
• /swarm evidence — show evidence bundles [taskId]
• /swarm evidence summary — generate evidence summary with completion ratio and blockers
• /swarm evidence-summary — deprecated alias for /swarm evidence summary
• /swarm handoff — prepare state for clean model switch
• /swarm archive — archive old evidence bundles [--dry-run]
• /swarm retrieve — retrieve full output from a summary <id>
• /swarm rollback — restore swarm state or project files to a checkpoint
• /swarm reset — clear swarm state files [--confirm]
• /swarm reset-session — clear session state, preserve plan/evidence/knowledge
• /swarm recover — settle wedged coder settlements [task_id] [--force] (human-only)
• /swarm checkpoint — manage project checkpoints [save|restore|delete|list] <label>
• /swarm finalize — finalize the swarm project and archive evidence
• /swarm close — deprecated alias for /swarm finalize
• /swarm auto-proceed — toggle or set auto-proceed override [on|off]
• /swarm concurrency — manage runtime concurrency override [set|status|reset]

Harness evolution

• /swarm blueprint validate — validate a declarative harness blueprint or atomic blueprint patch
• /swarm blueprint current — show the ledger-derived current harness blueprint projection
• /swarm blueprint history — show bounded hash-verified harness version history
• /swarm blueprint diff — compare two stored harness blueprint versions
• /swarm blueprint export — export a canonical stored harness blueprint
• /swarm harness candidate validate — validate an inert harness candidate manifest
• /swarm harness candidate show — show bounded harness candidate metadata without raw patch content
• /swarm harness candidate diff — show candidate file and blueprint-change metadata without raw patch content

Diagnostics / health

• /swarm diagnose / /swarm diagnosis — run health check on swarm state (diagnosis is a deprecated alias)
• /swarm config doctor — run config doctor checks
• /swarm config-doctor — deprecated alias for /swarm config doctor
• /swarm doctor — deprecated alias for /swarm config doctor
• /swarm doctor tools — run tool registration coherence check
• /swarm doctor-tools — deprecated alias for /swarm doctor tools
• /swarm preflight — run preflight automation checks
• /swarm lanes — list active, awaiting-merge, and conflicted worktree lanes
• /swarm sync-plan — ensure plan.json and plan.md are synced
• /swarm benchmark — show performance metrics [--cumulative] [--ci-gate] [--max-cost-usd <n>]
• /swarm review — run the independent review model against a selected Git diff
• /swarm costs — show per-agent and per-task token/cost telemetry [--json]
• /swarm learning — show learning metrics and violation trends
• /swarm guardrail explain — dry-run: show what guardrails would do (executes nothing)
• /swarm guardrail-explain — deprecated alias for /swarm guardrail explain
• /swarm guardrail-log — read the guardrail decision log
• /swarm coupling — measure plan coupling and rank modules driving conflicts
• /swarm dark-matter — detect hidden file couplings via co-change NPMI analysis
• /swarm simulate — dry-run hidden coupling analysis with configurable thresholds
• /swarm ci-simulate — create a temporary merge-result worktree and run CI pre-merge
• /swarm qa-gates — view or modify QA gate profile for the current plan
• /swarm acknowledge-spec-drift — acknowledge spec drift and suppress further warnings

Knowledge / memory / curation

• /swarm knowledge — list knowledge entries
• /swarm knowledge migrate — migrate knowledge entries to the current format
• /swarm knowledge quarantine — move a knowledge entry to quarantine
• /swarm knowledge restore — restore a quarantined or archived knowledge entry
• /swarm knowledge unactionable — list unactionable knowledge entries pending hardening
• /swarm knowledge retry-hardening — reset retire candidates for re-hardening
• /swarm knowledge hive-quarantine — human-only exact-ID quarantine of hive-store entries with backup and rollback (issue #2033)
• /swarm memory — show Swarm memory commands
• /swarm memory status — show Swarm memory provider, JSONL, and migration status
• /swarm memory pending — show pending Swarm memory proposals
• /swarm memory recall-log — summarize Swarm memory recall usage
• /swarm memory value-log — show Swarm memory Q-value and reward updates
• /swarm memory compact — compact deleted/superseded/expired scratch memories
• /swarm memory stale — list stale and low-utility Swarm memories
• /swarm memory export — export current Swarm memory to JSONL files
• /swarm memory evaluate — run golden Swarm memory recall evaluation fixtures
• /swarm memory audit-verify — verify the memory audit-log hash chain (tamper detection)
• /swarm memory import — import legacy JSONL memory into SQLite
• /swarm memory migrate — run the one-time legacy JSONL to SQLite migration
• /swarm memory consolidation-log — summarize recent memory consolidation passes
• /swarm memory link — share memory across linked worktrees (requires memory.link.enabled)
• /swarm memory link status — show whether memory is cohort-linked (distinct from knowledge link)
• /swarm memory unlink — stop sharing memory; copies cohort family back to local
• /swarm curate — run knowledge curation and hive promotion review
• /swarm consolidate — run quota-bounded skill-improver consolidation

Architect MODE workflows

• /swarm brainstorm — enter architect MODE: BRAINSTORM (seven-phase planning)
• /swarm loop — enter architect MODE: LOOP (compound-engineering loop)
• /swarm council — enter architect MODE: COUNCIL (multi-model deliberation)
• /swarm clarify — clarify and refine an existing feature specification
• /swarm specify — generate or import a feature specification
• /swarm analyze — analyze spec.md vs plan.md for requirement coverage gaps
• /swarm sdd — manage OpenSpec-compatible SDD artifacts
• /swarm sdd status — show OpenSpec-compatible SDD status
• /swarm sdd validate — validate OpenSpec-compatible artifacts
• /swarm sdd project — materialize the effective spec into .swarm/spec.md
• /swarm epic — toggle Epic Mode (autonomous coupling-aware parallel activation)
• /swarm turbo — toggle Turbo Mode strategy [on|off|lean|standard|epic|status]
• /swarm full-auto — toggle Full-Auto Mode; accepts on [mode], off, or status
• /swarm guardrail reset — reset an action-local guardrail circuit after external repair
• /swarm post-mortem — run the post-mortem agent (project-end synthesis)

Read-only audits / research

• /swarm deep-dive / /swarm deep dive — launch deep codebase audit (parallel explorers, dual reviewers, critic)
• /swarm deep-research / /swarm deep research — launch cited multi-source deep research pass
• /swarm codebase-review / /swarm codebase review — run codebase-review-swarm
• /swarm design-docs / /swarm design docs — generate or sync language-agnostic design docs

PR / issue workflows

• /swarm issue — ingest a GitHub issue (intake → localization → resolution spec) [--plan] [--trace] [--no-repro]
• /swarm pr-review — launch deep PR review with multi-lane analysis
• /swarm pr-feedback — ingest and close known PR feedback (review comments, CI failures, conflicts)
• /swarm abort-pr-workflow — clear a stuck PR_REVIEW/PR_FEEDBACK mechanical gate and stop the auto-resume loop (human-only escape hatch)
• /swarm approve-plan-critic — record a MANUAL plan-critic approval to unblock the ratchet-tighter critic_pre_plan execution gate when the critic already returned APPROVED but the snapshot was not recorded (human-only escape hatch)
• /swarm approve-write — issue one exact, session-bound, one-shot write approval for a candidate action and content hash (human-only)
• /swarm ci-monitor — drive an already-reviewed, approved PR to green and merged (monitor CI, fix, merge; max 5 fix cycles)
• /swarm pr subscribe / /swarm pr-subscribe — subscribe session to PR state-change notifications
• /swarm pr unsubscribe / /swarm pr-unsubscribe — unsubscribe session from PR notifications
• /swarm pr status / /swarm pr-status — show PR monitor subscription status

CRITICAL NAMING CONFLICTS

These swarm subcommands share exact names with CC built-in commands. Invoking the bare form instead of /swarm <name> causes irreversible damage:

Swarm Command	CC Built-in	Damage
/swarm plan	CC /plan	Enters CC plan mode — blocks execution
/swarm reset	CC /reset	Wipes entire conversation context
/swarm checkpoint	CC /checkpoint	Reverts conversation history
/swarm history	CC /history	Shows CC conversation history instead of swarm phase history

All swarm commands: /swarm <subcommand>. Never the bare name.

COMMAND INVOCATION RULE

All commands in this list are invoked as /swarm <subcommand>. Never invoke the bare subcommand as a standalone slash command. /plan, /status, /reset, /checkpoint, /agents, /config, /export, /doctor are Claude Code built-in commands with completely different behaviors. The /swarm prefix is mandatory, not optional.

Examples:

• /swarm — enable swarm mode only
• /swarm implement OAuth login without breaking existing session handling — enable swarm mode, then execute the task
• /swarm fix the failing auth refresh tests and verify the session flow — enable swarm mode, then execute the task
• /swarm close — this is a plugin subcommand; tell the user it will be handled by the plugin command system
• /swarm handoff — this is a plugin subcommand; tell the user it will be handled by the plugin command system

Behavior model

The canonical swarm behavior model (goal, workflow posture, quality/speed policy, default triage model, and the mandatory implementation closeout gate) lives at .opencode/skills/swarm/SKILL.md. This file holds only the Claude Code /swarm command wiring above; the cross-agent contract is canonical.