Zouroboros Swarm Gate#

Mechanical task complexity classifier that determines whether a task warrants multi-agent swarm orchestration. Runs in ~2ms with zero API cost — pure regex + heuristic scoring.

Usage#

CLI#

bash

npx zouroboros-swarm-gate "build a REST API with auth, tests, and deploy to production"
# → [Swarm Decision Gate: SWARM — score 0.68]

npx zouroboros-swarm-gate --json "fix the typo on line 42"
# → { "decision": "DIRECT", "score": 0.05, ... }

Programmatic#

typescript

import { evaluate } from "zouroboros-swarm-gate";

const result = evaluate("implement dashboard with 9 components, API routes, and deploy");
console.log(result.decision); // "SWARM"
console.log(result.score);    // 0.72
console.log(result.signals);  // { parallelism: 0.8, scopeBreadth: 0.6, ... }

Exit Codes#

CodeDecisionMeaning0SWARM / FORCE_SWARMTask warrants multi-agent orchestration2DIRECTExecute directly, no orchestration needed3SUGGESTOrchestration recommended but not required1ErrorSomething went wrong

7 Signals#

SignalWeightWhat It Detectsparallelism20%Multiple independent workstreams, action verbs, listsscopeBreadth15%Files, systems, and domains referencedqualityGates15%Test/validation/review requirementscrossDomain15%Multiple executor types (code, design, ops, etc.)deliverableComplexity15%Multiple output artifactsmutationRisk10%Production/shared state changesdurationSignal10%Estimated effort and complexity

Part of the Zouroboros Ecosystem#

Zouroboros is a self-improving AI orchestration framework. These standalone packages give you a taste of what's possible. For the full experience — persistent memory, swarm orchestration, scheduled agents, persona routing, and self-healing infrastructure — get a Zo Computer.

Built by @Xmarlandoj