1 agents

society-coordinator

society-coordinator

Overview

The Society Coordinator is an L3 agent operating in the general domain of the Prismatic Platform. This agent specializes in coordinating epistemic societies, managing repair queues, and implementing collective intelligence protocols that enable the platform's 552 agents to function as a coherent, self-improving organism rather than a collection of independent processes.

An epistemic society, in the context of the Prismatic Platform, is a dynamically formed group of agents that collaborate on shared knowledge domains, collectively maintain belief states, and jointly evolve their capabilities through structured feedback loops. The Society Coordinator manages the lifecycle of these societies -- from formation through maturation to dissolution or merger -- ensuring that the platform's collective intelligence continuously improves.

The coordinator operates under the NABLA Infinity epistemic framework, which mandates that all beliefs within a society are traceable, time-stamped, and supported by multiple independent signals. This prevents the emergence of echo chambers or unchallenged assumptions within any epistemic society.

Epistemic Society Architecture

The platform organizes its agents into overlapping epistemic societies, where each society focuses on a specific knowledge domain or operational concern.

SocietyFocusMember CountHealth
Quality SocietyCode quality, testing, static analysis45 agentsOptimal
Intelligence SocietyOSINT, entity resolution, analysis62 agentsOptimal
Security SocietyDefensive ops, compliance, vulnerability38 agentsOptimal
Architecture SocietySystem design, scalability, patterns28 agentsOptimal
Epistemic SocietyKnowledge management, belief systems22 agentsOptimal
Development SocietyTooling, productivity, CI/CD35 agentsOptimal

Society Lifecycle Management

The Society Coordinator manages each society through a defined lifecycle.

Formation -> Initialization -> Active Operation -> Maturation -> Evolution/Dissolution
PhaseDurationActivitiesCoordinator Role
FormationMinutesMember selection, charter creationInitiator
InitializationHoursKnowledge base seeding, role assignmentFacilitator
Active OperationOngoingNormal operations, knowledge sharingMonitor
MaturationWeeks-MonthsCapability refinement, specializationGuide
EvolutionDaysMerger, split, or capability expansionOrchestrator
DissolutionHoursKnowledge preservation, member reassignmentArchivist

Repair Queue Management

One of the coordinator's critical functions is managing the repair queue -- a prioritized list of knowledge defects, capability gaps, and operational failures that require society-level intervention.

defmodule PrismaticAgents.SocietyCoordinator do
  @moduledoc """
  L3 Society Coordinator.
  Manages epistemic societies, repair queues, and collective intelligence.
  """

  use GenServer
  require Logger

  @coordination_interval_ms :timer.minutes(5)

  defstruct [
    :societies,
    :repair_queue,
    :collective_health,
    :last_coordination_at,
    status: :coordinating
  ]

  @spec start_link(keyword()) :: GenServer.on_start()
  def start_link(opts \\ []) do
    GenServer.start_link(__MODULE__, opts, name: __MODULE__)
  end

  @impl true
  def init(_opts) do
    societies = discover_active_societies()
    schedule_coordination()
    {:ok, %__MODULE__{societies: societies, repair_queue: :queue.new()}}
  end

  @impl true
  def handle_info(:coordinate, state) do
    {processed, remaining} = process_repair_queue(state.repair_queue, state.societies)
    health = assess_collective_health(state.societies)

    :telemetry.execute(
      [:prismatic, :agents, :society_coordinator, :cycle],
      %{repairs_processed: processed, queue_depth: :queue.len(remaining)},
      %{society_count: length(state.societies), health: health}
    )

    schedule_coordination()

    {:noreply, %{state |
      repair_queue: remaining,
      collective_health: health,
      last_coordination_at: DateTime.utc_now()
    }}
  end

  @impl true
  def handle_cast({:enqueue_repair, repair_item}, state) do
    prioritized_queue = insert_by_priority(state.repair_queue, repair_item)
    {:noreply, %{state | repair_queue: prioritized_queue}}
  end

  defp process_repair_queue(queue, societies) do
    {items_to_process, remaining} = dequeue_batch(queue, 10)

    processed =
      items_to_process
      |> Enum.map(fn item -> route_repair_to_society(item, societies) end)
      |> Enum.count(&match?({:ok, _}, &1))

    {processed, remaining}
  end

  defp assess_collective_health(societies) do
    societies
    |> Enum.map(&assess_society_health/1)
    |> Enum.reduce(0, fn health, acc -> acc + health end)
    |> Kernel./(max(length(societies), 1))
  end
end

Collective Intelligence Protocol

The Society Coordinator implements a collective intelligence protocol that enables societies to make decisions that exceed the capability of any individual agent.

Protocol StepDescriptionMechanism
Signal CollectionGather perspectives from all society membersTelemetry aggregation
Diversity CheckEnsure sufficient viewpoint diversityNABLA plurality axiom
Weighted SynthesisCombine signals with competence-based weightingBayesian aggregation
Contradiction AnalysisIdentify and preserve contradictory signalsContradiction preservation axiom
Confidence AssessmentCalculate collective confidence in conclusionsTrinity Gate validation
Decision EmissionPublish society-level decisions with provenanceImmutable audit trail

Repair Item Classification

PriorityDescriptionSLAExample
P0Society-breaking defectImmediateKnowledge base corruption
P1Capability gap affecting operations1 hourMissing analysis capability
P2Performance degradation4 hoursSlow inference pipeline
P3Enhancement opportunity24 hoursNew data source integration
P4Long-term improvement1 weekAlgorithm optimization

Society Health Metrics

MetricDescriptionTarget
Member ResponsivenessAverage response time to coordination requests< 5 seconds
Knowledge FreshnessAge of most recent knowledge contribution< 1 hour
Repair Queue DepthOutstanding repair items< 10
Cross-Society CollaborationInter-society knowledge exchange events> 50/day
Belief ConsistencyPercentage of non-contradictory beliefs> 95%

Inter-Society Knowledge Transfer

One of the Society Coordinator's most valuable capabilities is facilitating knowledge transfer between societies. When one society develops a capability or discovers a pattern that could benefit another society, the coordinator manages the transfer process to ensure knowledge is correctly contextualized and adapted for the receiving society's domain.

Knowledge Transfer Protocol

defmodule PrismaticAgents.SocietyCoordinator.KnowledgeTransfer do
  @moduledoc """
  Manages inter-society knowledge transfer with context adaptation.
  Ensures transferred knowledge is correctly mapped to receiving domain.
  """

  @spec initiate_transfer(atom(), atom(), map()) :: {:ok, map()} | {:error, term()}
  def initiate_transfer(source_society, target_society, knowledge_item) do
    with {:ok, validated} <- validate_transferability(knowledge_item, target_society),
         {:ok, adapted} <- adapt_context(validated, source_society, target_society),
         {:ok, verified} <- verify_no_contradictions(adapted, target_society),
         :ok <- inject_into_society(adapted, target_society) do
      :telemetry.execute(
        [:prismatic, :agents, :society_coordinator, :knowledge_transfer],
        %{},
        %{source: source_society, target: target_society, item: knowledge_item.id}
      )

      {:ok, %{
        source: source_society,
        target: target_society,
        item_id: knowledge_item.id,
        adaptation_changes: adapted.changes,
        transferred_at: DateTime.utc_now()
      }}
    end
  end

  defp adapt_context(knowledge, source, target) do
    mappings = fetch_domain_concept_mappings(source, target)

    adapted =
      knowledge
      |> Map.update(:terminology, %{}, &apply_term_mappings(&1, mappings))
      |> Map.update(:references, [], &remap_references(&1, target))
      |> Map.put(:provenance, %{
        original_society: source,
        adapted_for: target,
        adapted_at: DateTime.utc_now()
      })

    {:ok, adapted}
  end
end
Transfer TypeDescriptionFrequencySuccess Rate
Pattern TransferProven quality patterns shared across societiesWeekly92%
Tool SharingAnalytical tools adapted for new domainsMonthly85%
Insight BroadcastStrategic insights shared with all societiesAs discoveredN/A
Failure LessonsPost-mortem learnings distributedPer incident98%
Capability SeedingNew capability introduced from external sourcesQuarterly78%

Society Formation Criteria

Not every group of agents warrants a formal epistemic society. The Society Coordinator evaluates formation requests against strict criteria to ensure that societies provide genuine collective intelligence value rather than merely adding organizational overhead.

CriterionRequirementRationale
Minimum Membership5+ agentsBelow this threshold, direct coordination is more efficient
Shared Knowledge DomainAgents share at least 60% domain overlapWithout overlap, collective reasoning lacks foundation
Complementary CapabilitiesMembers bring diverse analytical perspectivesHomogeneous societies produce echo chambers
Sustained NeedExpected operational duration > 30 daysShort-term collaboration handled by mission planning
Clear CharterDocumented purpose, scope, and success criteriaSocieties without clear purpose drift and decay

Integration Points

AIAD Specification Compliance

AIAD ComponentStatus
Agent specification fileCompliant
Behavioral rules16 rules defined
Telemetry integrationFull coverage
NM/ND doctrine enforcementActive
SEADF integrationRegistered

Society Performance Benchmarks

The Society Coordinator evaluates each society against standardized performance benchmarks that measure both the society's internal health and its contribution to the platform's overall intelligence capability.

BenchmarkMeasurementExcellentGoodNeeds AttentionCritical
Decision QualityAccuracy of society-level decisions> 98%95-98%90-95%< 90%
Response TimeTime from query to society response< 5s5-15s15-60s> 60s
Knowledge GrowthNew knowledge items per week> 5020-505-20< 5
Collaboration IndexInter-member knowledge exchanges per day> 2010-205-10< 5
Repair ResolutionRepair items resolved within SLA> 98%95-98%90-95%< 90%

Authority Level

L3 - Strategic Command - Multi-domain coordination with authority to create, modify, and dissolve epistemic societies and manage their collective intelligence protocols.


Connect & Contribute

Created by Tomáš Korcak (korczis) | Open Source under GHL