Skip to content

ProtocolWarden

ProtocolWarden is a contract-first AI operations ecosystem organized around semantic repo graphs, execution protocols, policy-controlled routing, runtime adapters, and public-safe architecture projection.

This site is the canonical public knowledge surface for the ecosystem. It explains what exists, how it fits together, what boundaries are enforced, and what is public versus private.

The short front door is the GitHub profile README. The GitHub org lists all public repos.

This Site Is

  • the public documentation surface
  • the architecture explanation layer
  • the protocol and specification hub
  • the ontology and topology explorer
  • the governance and boundary reference

This Site Is Not

  • a runtime system
  • an orchestration layer
  • a deployment manager
  • a backend service
  • an execution environment

Start Here

Ecosystem Architecture

graph TD
    subgraph surface ["Public Surface"]
        DOCS["ProtocolWarden.github.io"]
    end
    subgraph semantic ["Semantic / Protocol Layer"]
        RG[RepoGraph]
        PM[PlatformManifest]
        CX[CxRP]
        RX[RxP]
    end
    subgraph control ["Control / Runtime Layer"]
        OPS[OperationsCenter]
        SB[SwitchBoard]
        OC[OperatorConsole]
        ER[ExecutorRuntime]
    end
    subgraph gov ["Governance / Lifecycle Layer"]
        CU[Custodian]
        SR[SourceRegistry]
        PD[PlatformDeployment]
        WH[Warehouse]
    end

    surface --> semantic
    semantic --> control
    control --> gov

Core Repo Constellation

graph LR
    OC[OperatorConsole]
    OPS[OperationsCenter]
    SB[SwitchBoard]
    CX[CxRP]
    RX[RxP]
    ER[ExecutorRuntime]
    RG[RepoGraph]
    PM[PlatformManifest]
    PT[Private truth layer]
    SR[SourceRegistry]
    PD[PlatformDeployment]
    CU[Custodian]
    WH[Warehouse]
    OC --> OPS
    OPS --> SB
    OPS --> CX
    OPS --> RX
    OPS --> ER
    OPS --> PM
    OPS --> PT
    OPS --> SR
    OPS --> CU
    PM --> RG
    CU --> RG
    PD --> OPS
    WH -. utility only .-> OPS

Ecosystem in 60 Seconds

  • CxRP owns cross-repo execution and routing semantics
  • RxP owns runtime invocation semantics
  • OperationsCenter owns orchestration and governance behavior
  • SwitchBoard owns lane and backend selection
  • ExecutorRuntime owns runtime invocation mechanics
  • RepoGraph owns the shared ontology, topology, projection, and boundary language
  • PlatformManifest publishes the public graph instance and public-safe projections
  • the private-truth layer supplies private graph truth in that language
  • Custodian consumes RepoGraph boundary artifacts and enforces public-surface drift checks
  • PlatformDeployment owns deployment and local hosting concerns
  • adjacent backend consumers are runtime and content-pipeline consumers

For a short operator model, see architecture/simple-platform-model.md.

Protocol Stack Summary

  • Contracts: CxRP, RxP
  • Control plane: OperatorConsole, OperationsCenter, SwitchBoard
  • Runtime layer: ExecutorRuntime, adjacent backend consumers, managed backends
  • Inventory and governance: PlatformManifest, Custodian, SourceRegistry, PlatformDeployment
  • Utility tooling: Warehouse

Operational References

Documentation Philosophy

This repository exists to preserve architectural intent and reduce cognitive load. The public site makes the ecosystem understandable without forcing contributors to reverse-engineer the platform from source. For the short front door, see the separate ProtocolWarden repository.