v3/docs/adr/ADR-369-dream-cycle-swarm-ib-vq-inter-agent-messaging.md
Status: Proposed Date: 2026-07-19 Authors: claude (dream-cycle agent, 2026-07-19) Dream Cycle: Slot 4 — swarm deep dive Source: arXiv:2602.02035 (ICRA 2026), arXiv:2606.07557 (SPIN, 2026)
Ruflo's current swarm messaging layer transmits uncompressed text/JSON payloads between agents via SendMessage. At 8 agents (anti-drift default), this is tolerable. At 16–64 agents (the target range for tensor-train topology per SPIN, arXiv:2606.07557), uncompressed inter-agent communication becomes the primary bandwidth and latency bottleneck.
ICRA 2026 (arXiv:2602.02035) reports the first method to simultaneously improve task performance (+181.8%) and reduce inter-agent bandwidth (−41.4%) using information-bottleneck (IB) theory combined with vector quantization (VQ) on the inter-agent message channel. This breaks the historical performance-bandwidth tradeoff in multi-agent coordination.
No existing ADR (ADR-001 through ADR-319) covers inter-agent message compression. This is an architectural decision because it changes the serialization contract between all agents at the SendMessage boundary.
Adopt IB+VQ compression as an optional (opt-in, then default) encoding layer for inter-agent messages in the ruflo swarm layer:
--compress ib-vq flag to swarm init and SendMessage. Messages are encoded via a learned codebook (VQ codebook size 256–1024). Codebook is shared at swarm init time and cached per session.maxAgents >= 8. Maintain JSON fallback for single-agent sessions and --no-compress escape hatch.swarm-messaging-bench results before enabling Phase 2 default. Require ≥50% task improvement and ≥20% bandwidth reduction vs uncompressed baseline at 8 agents.maxAgents < 8 sessions