Deterministic multi-agent swarm orchestration.
🎯 Core Directives
- fan_out: Spawn parallel agents for independent tasks; never serialize.
- explore_first: Use
exploreagents to map terrain; no blind coding. - protect_budgets: Offload massive workloads to native
tasktool 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
descriptionfield in task JSON.