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 exec ["Execution Backend layer"]
        TE[TeamExecutor]
        DE[DagExecutor]
        CE[CritiqueExecutor]
    end

    subgraph gov ["Governance / Lifecycle layer"]
        CU[Custodian]
        SR[SourceRegistry]
        PD[PlatformDeployment]
        WH[Warehouse]
    end

    DOCS --> proto
    DOCS --> ctrl
    DOCS --> gov
    proto --> ctrl
    OPS --> TE
    OPS --> DE
    OPS --> CE
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

Execution Backend Layer

Repo Role
TeamExecutor coordinator/worker/verifier team execution — replaces kodo
DagExecutor DAG workflow executor (rustworkx) — replaces Archon
CritiqueExecutor adversarial and reflexion critique loops — new capability

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

Forks and External Integrations

Third-party forks (openclaw, firecrawl, PraisonAI, etc.) and retired integrations (kodo → replaced by TeamExecutor, Archon → replaced by DagExecutor) are documented at 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 — contracts, execution backends (team_executor/dag_executor/critique_executor/aider_local), run artifact persistence, and structured failu…

    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