# nehemc2026/ai-operating-protocol architecture

> Architecture diagram of the GitHub repository nehemc2026/ai-operating-protocol, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nehemc2026/ai-operating-protocol
- Repository: https://github.com/nehemc2026/ai-operating-protocol

## Overview

This repository is a WorkBuddy-specific AI behavior protocol, not executable software. Its principal workflow is Plan (align) → Craft (implement), with Review as a cross-cutting review mode and Ask as a user-triggered, review-only mode. The protocol also defines risk-based behavior, authorization boundaries, and stopping criteria. The README documents these capabilities and installation; no source excerpts were provided, so the graph uses only documented relationships.

Main entry points: [`SKILL.md`](https://github.com/nehemc2026/ai-operating-protocol/blob/main/SKILL.md) (Operating Protocol), [`EVOLUTION.md`](https://github.com/nehemc2026/ai-operating-protocol/blob/main/EVOLUTION.md) (Evolution Record)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_workbuddy["WorkBuddy"]
node_protocol["Operating Protocol<br/>[SKILL.md]"]
node_plan["Plan Mode<br/>[SKILL.md]"]
node_craft["Craft Mode<br/>[SKILL.md]"]
node_review["Review Mode<br/>[SKILL.md]"]
node_ask["Ask Mode<br/>[SKILL.md]"]
node_risk["Risk Rules<br/>[SKILL.md]"]
node_stop["Stop Rule<br/>[SKILL.md]"]
node_history["Evolution Record<br/>[EVOLUTION.md]"]

node_workbuddy -->|"loads skill"| node_protocol
node_user -->|"starts alignment"| node_plan
node_plan -->|"aligns then implements"| node_craft
node_review -->|"reviews decisions"| node_plan
node_user -->|"triggers review"| node_ask
node_ask -->|"requests review"| node_review
node_protocol -->|"defines grading"| node_risk
node_protocol -->|"defines stopping"| node_stop
node_history -->|"records evolution"| node_protocol

click node_protocol "https://github.com/nehemc2026/ai-operating-protocol/blob/main/SKILL.md"
click node_plan "https://github.com/nehemc2026/ai-operating-protocol/blob/main/SKILL.md"
click node_craft "https://github.com/nehemc2026/ai-operating-protocol/blob/main/SKILL.md"
click node_review "https://github.com/nehemc2026/ai-operating-protocol/blob/main/SKILL.md"
click node_ask "https://github.com/nehemc2026/ai-operating-protocol/blob/main/SKILL.md"
click node_risk "https://github.com/nehemc2026/ai-operating-protocol/blob/main/SKILL.md"
click node_stop "https://github.com/nehemc2026/ai-operating-protocol/blob/main/SKILL.md"
click node_history "https://github.com/nehemc2026/ai-operating-protocol/blob/main/EVOLUTION.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_user,node_review toneBlue
class node_workbuddy toneIndigo
class node_protocol,node_plan,node_craft,node_ask,node_risk,node_stop,node_history toneTeal
```

## Components

### Other components

- **User**
- **WorkBuddy**
- [Operating Protocol](https://github.com/nehemc2026/ai-operating-protocol/blob/main/SKILL.md): `SKILL.md`
- [Plan Mode](https://github.com/nehemc2026/ai-operating-protocol/blob/main/SKILL.md): `SKILL.md`
- [Craft Mode](https://github.com/nehemc2026/ai-operating-protocol/blob/main/SKILL.md): `SKILL.md`
- [Review Mode](https://github.com/nehemc2026/ai-operating-protocol/blob/main/SKILL.md): `SKILL.md`
- [Ask Mode](https://github.com/nehemc2026/ai-operating-protocol/blob/main/SKILL.md): `SKILL.md`
- [Risk Rules](https://github.com/nehemc2026/ai-operating-protocol/blob/main/SKILL.md): `SKILL.md`
- [Stop Rule](https://github.com/nehemc2026/ai-operating-protocol/blob/main/SKILL.md): `SKILL.md`
- [Evolution Record](https://github.com/nehemc2026/ai-operating-protocol/blob/main/EVOLUTION.md): `EVOLUTION.md`

## Connections

- WorkBuddy → Operating Protocol: loads skill (evidence: `README.md`)
- User → Plan Mode: starts alignment (evidence: `README.md`)
- Plan Mode → Craft Mode: aligns then implements (evidence: `README.md`)
- Review Mode → Plan Mode: reviews decisions (evidence: `README.md`)
- User → Ask Mode: triggers review (evidence: `README.md`)
- Ask Mode → Review Mode: requests review (evidence: `README.md`)
- Operating Protocol → Risk Rules: defines grading (evidence: `README.md`)
- Operating Protocol → Stop Rule: defines stopping (evidence: `README.md`)
- Evolution Record → Operating Protocol: records evolution (evidence: `README.md`)