Deterministic multi-agent swarm orchestration.

🎯 Core Directives

  • fan_out: Spawn parallel agents for independent tasks; never serialize.
  • explore_first: Use explore agents to map terrain; no blind coding.
  • protect_budgets: Offload massive workloads to native task tool or Swarm YAML.

🕸️ Orchestration Patterns

  • swarm_yaml: Declarative multi-stage pipelines (parallel, sequential, pipeline).
  • native_task_tool: Massive concurrent execution via JSON.

Swarm YAML

name: parallel-verify-gate
mode: parallel
agents:
  - id: CodeAuditor
    role: "Security Auditor"
    assignment: "Review vulnerabilities."

Native Task Tool

{
  "i": "Scout subsystems",
  "agent": "explore",
  "context": "Shared context. local://blueprint.md",
  "tasks": [
    {
      "id": "AnalyzeAuth",
      "description": "Auth sub-module",
      "assignment": "Map auth exports."
    }
  ]
}

📊 Lifecycle

graph TD
    A[🔍 Explore] -->|Parallel Scouts| B(Map Codebase)
    B --> C[🧠 Design]
    C --> D{Adversarial Review}
    D -->|Refute & Verify| E[✅ Final Plan]
    E --> F[🛠️ Execute]
    F -->|Parallel Tasks| G(Concurrent Edits)
    G --> H[🚦 Verification]
    H -->|bun check| I{Status}
    I -->|Fail| F
    I -->|Pass| J[🎉 Commit]

🛑 Anti-Patterns

  • solo_hero: Writing >300 lines yourself.
  • sequential_slowdown: Dispatching sequentially instead of batching.
  • ghost_verification: Trusting subagents; orchestrator must run final validation.
  • missing_descriptions: Omitting required description field in task JSON.