ruflo

๐Ÿ‘‘ Hive Mind

/docs/core-features/hive-mind

The Hive Mind system implements queen-led hierarchical coordination where strategic queen agents direct specialized workers through collective decision-making and shared memory.

Queen Types:

Queen TypeBest ForStrategy
StrategicResearch, planning, analysisHigh-level objective coordination
TacticalImplementation, executionDirect task management
AdaptiveOptimization, dynamic tasksReal-time strategy adjustment

Worker Specializations (8 types): researcher, coder, analyst, tester, architect, reviewer, optimizer, documenter

Consensus Mechanisms:

AlgorithmVotingFault ToleranceBest For
MajoritySimple democraticNoneQuick decisions
WeightedQueen 3x weightNoneStrategic guidance
Byzantine2/3 supermajorityf < n/3 faultyCritical decisions

Collective Memory Types:

  • knowledge (permanent), context (1h TTL), task (30min TTL), result (permanent)
  • error (24h TTL), metric (1h TTL), consensus (permanent), system (permanent)

CLI Commands:

bash
npx ruflo hive-mind init                    # Initialize hive mind
npx ruflo hive-mind spawn "Build API"       # Spawn with objective
npx ruflo hive-mind spawn "..." --queen-type strategic --consensus byzantine
npx ruflo hive-mind status                  # Check status
npx ruflo hive-mind metrics                 # Performance metrics
npx ruflo hive-mind memory                  # Collective memory stats
npx ruflo hive-mind sessions                # List active sessions

Performance: Fast batch spawning with parallel agent coordination