fix: replace subgraph diagram with simple 3-node flowchart — subgraphs with external connections break Mermaid layout

This commit is contained in:
matthalltech 2026-04-01 13:47:11 +00:00
parent a2e1a4f7e0
commit f4e6d87f62

View file

@ -11,27 +11,13 @@
## How it works ## How it works
```mermaid ```mermaid
flowchart TB flowchart LR
subgraph host["Your Machine"] host["Your Machine<br/>Secrets and workspace folders"]
secrets["Secrets and Keys"] container["Bounded Container<br/>Claude Code, Codex, Gemini"]
folders["Workspace Folders"] repo["Git Repository<br/>Rules, state docs, scripts"]
end
subgraph container["Bounded Container — Agents Work Here"] host -->|mounts into| container
claude["Claude Code"] container -->|reads and writes| repo
codex["Codex CLI"]
gemini["Gemini CLI"]
end
subgraph repo["Git Repository — The Persistent Memory"]
rules["Rules"]
state["State Docs"]
tools["Scripts"]
end
folders -->|mounts into| container
container <-->|reads before acting / writes when done| repo
secrets -.->|stays on host — never enters container| host
``` ```
The container is bounded and disposable. The repository is permanent. Agents read the repo before every session — not the chat history — so context survives restarts, rebuilds, and parallel sessions. The container is bounded and disposable. The repository is permanent. Agents read the repo before every session — not the chat history — so context survives restarts, rebuilds, and parallel sessions.