hydra

Hydra — The Governed Constellation

Many heads. One Spirit. The covenant holds.

A LangGraph supervisor that routes work across specialized AI agent squads — executive strategy, software engineering, creative production — under constitutional governance with human-in-the-loop gates, budget enforcement, and cross-model judging.

Hydra is a Claude Code plugin + Python LangGraph supervisor that routes work across a constellation of heterogeneous AI agent squads — Executive (C-suite strategy), Forge (engineering), Garland (creative), plus marketing operations and a roster of governance-ready stubs. It is Pentecost, not Legion: many distinct agents under one cryptographically-anchored covenant (CONSTITUTION.md), routed via typed envelopes, audited by AgentSmith, and tagged with the eight-cell I Ching vocabulary backed by the optional TheEights memory daemon as a shared cross-project substrate.

Hydra does not re-implement the squads' work. It sits above them: classifying goals, decomposing them into typed cross-squad envelopes, dispatching subgraphs in parallel, synthesizing the result into a single decision record, and enforcing the constitutional rule of faith on every step.

The Pentecost flower sigil — central immortal head, three crown petals, eight-cell substrate. See docs/constellation/ for the full layered presentation, the reveal.js cinematic deck, and executive memos.

The Ecosystem

Hydra is one node in a mesh of nine sibling AI systems bound together by a tenth layer, AgentMesh. Each system is independently shippable; together they form a unified AI operating system. Several of the siblings below — ExecutiveSuite, RLM-Creative, MarketBliss, Senate, and Xenia — are also Hydra squads (see Squad topology); they appear here as ecosystem members in their own right.

graph TD
    subgraph MESH["🕸️ AgentMesh — binding control plane (the tenth layer)"]
      direction TB
      HYDRA["🐍 Hydra<br/><em>Supervisor · Router · Synthesizer</em>"]

      ES["👔 ExecutiveSuite<br/><em>20 C-suite agents · 4 orchestrators</em>"]
      PP["⚙️ pair-programmer<br/><em>Best-of-N harness · 39 sub-agents</em>"]
      RLM["🎨 RLM-Creative<br/><em>8 Garland Heads · Helios sub-crew</em>"]
      MB["📣 MarketBliss<br/><em>5 marketing squads</em>"]
      SENATE["⚖️ Senate<br/><em>12-jurist Curia · legal-compliance</em>"]
      XENIA["🔥 Xenia<br/><em>11-agent Hearth · customer-support</em>"]

      SMITH["🛡️ AgentSmith<br/><em>Meta-governance · N1–N10 invariants</em>"]
      EIGHTS["∞ TheEights<br/><em>Root of trust · memory · self-evolution</em>"]
    end

    HYDRA -->|"CSuiteDecisionPacket"| ES
    HYDRA -->|"PRD · DevTask"| PP
    HYDRA -->|"CreativeBrief · ShotList"| RLM
    HYDRA -->|"CreativeBrief"| MB
    HYDRA -->|"LegalReview"| SENATE
    HYDRA -->|"SupportTask"| XENIA

    ES -->|"DecisionRecord"| HYDRA
    PP -->|"DecisionRecord"| HYDRA
    RLM -->|"DecisionRecord"| HYDRA
    SENATE -->|"DecisionRecord"| HYDRA
    XENIA -->|"DecisionRecord"| HYDRA

    SMITH -.->|"validates"| HYDRA
    SMITH -.->|"validates"| ES
    SMITH -.->|"validates"| PP
    SMITH -.->|"validates"| RLM

    EIGHTS -.->|"root of trust · MemoryRef"| SMITH
    EIGHTS -.->|"MemoryRef handles"| HYDRA
    EIGHTS -.->|"memory"| ES
    EIGHTS -.->|"memory"| PP
    EIGHTS -.->|"memory"| RLM

    MESH -.->|"enroll · route · observe (no governance of its own)"| EIGHTS