close
Skip to content
View ProtocolWarden's full-sized avatar

Block or report ProtocolWarden

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
ProtocolWarden/README.md

ProtocolWarden

Contract-first AI operations ecosystem built around semantic repo graphs, execution protocols, policy-controlled routing, and public-safe architecture projection.

What to click next

Ecosystem at a glance

graph TD
    DOCS["protocolwarden.github.io — full docs"]

    subgraph proto ["Protocol / Semantic layer"]
        RG[RepoGraph]
        PM[PlatformManifest]
        CX[CxRP]
        RX[RxP]
    end

    subgraph ctrl ["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

    DOCS --> proto
    DOCS --> ctrl
    DOCS --> gov
    proto --> ctrl
Loading

Protocol / Semantic layer

Repo Role
RepoGraph shared graph semantics, schema governance, boundary artifact language
PlatformManifest public-safe repo graph projection publisher
CxRP contract execution routing protocol — schemas and vocabulary
RxP runtime execution protocol — invocation and result contracts

Control / Runtime layer

Repo Role
OperationsCenter planning, routing, execution dispatch, policy, evidence, run artifacts
SwitchBoard policy-driven execution-lane and backend selector
OperatorConsole operator entrypoint — persistent workspaces, context continuity, delegation
ExecutorRuntime runtime invocation mechanics consuming RxP contracts

Governance / Lifecycle layer

Repo Role
Custodian cross-repo boundary, drift, and audit enforcement
SourceRegistry source and fork tracking and lifecycle
PlatformDeployment local developer platform for the shared AI coding stack
Warehouse LLM-ready context packaging and staging

External integrations

Backend candidates and forked dependencies are documented separately so they are not confused with core platform repos. See protocolwarden.github.io/repos/external-integrations/.

Public surface

Repo Purpose
ProtocolWarden/ProtocolWarden this repo — GitHub profile front door
ProtocolWarden/ProtocolWarden.github.io full documentation site

Pinned Loading

  1. Custodian Custodian Public

    Cross-repo audit and maintenance toolkit — reusable detector framework, generic code-health scanners, and operational helpers that consumer repos extend with their own per-repo plugins via .custodi…

    Python

  2. CxRP CxRP Public

    CxRP — Contract eXecution Routing Protocol. Contract-only models, schemas, and vocabulary for execution-bound workflows across planning, lane selection, execution requests, and execution results.

    Python 1

  3. OperationsCenter OperationsCenter Public

    Planning, routing, execution, policy, and evidence service — canonical contracts, backend adapters (kodo/aider/claude), run artifact persistence, and structured failure handling.

    Python

  4. OperatorConsole OperatorConsole Public

    Operator console for Claude, Codex, and aider — persistent Zellij workspaces, context-file continuity, and OperationsCenter execution pipeline delegation.

    Python 1

  5. RxP RxP Public

    RxP — Runtime eXecution Protocol. Contract-only schemas, vocabulary, and validation helpers for normalized runtime invocation and result.

    Python

  6. SwitchBoard SwitchBoard Public

    Policy-driven execution-lane selector — routes TaskProposal to claude_cli, codex_cli, or aider_local with fallback, escalation, and adaptive routing.

    Python