From a054a56c808c8d4efd1fa6116ad967f65fc0786b Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sun, 21 Jun 2026 04:22:40 +0000
Subject: [PATCH] docs: capture concentric bus topology (draft, pending
 confirmation)

Onion model from the design exchange: Hermes at the core; inner-brain bus
(Pony optional) carrying soul/metacog/drive-box/COBOL ontology; Ada (D1) as the
membrane; Ichor (Pony) as the OUTER bus carrying stomach/economy, microagents,
SAE, GoDAGRAG; External outside. Corrects earlier models (Hermes is core not
external; Ichor is outer not brain bus). Draft -- to be red-lined.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015hmgREHNsxYCuim33yUF2c
---
 docs/bus-topology.md | 59 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 docs/bus-topology.md

diff --git a/docs/bus-topology.md b/docs/bus-topology.md
new file mode 100644
index 0000000..51ea70f
--- /dev/null
+++ b/docs/bus-topology.md
@@ -0,0 +1,59 @@
+# Gen.03 — concentric bus topology  *(DRAFT — captured live, correct freely)*
+
+The body is an **onion**: Hermes at the core, organs in rings around it, Ada as
+the membrane between inner and outer, the world on the outside. Nothing reaches
+the core without crossing inward through the rings.
+
+```
+External (world: user / network)
+  │
+  ▼  outer bus — ICHOR (Pony)
+┌─────────────────────────────────────────────────────────┐
+│ OUTER ORGANS                                             │
+│   • stomach / economy organ  (small-model operated;      │
+│       digests external input → RAG context)              │
+│   • microagents                                          │
+│   • SAE  (sparse autoencoder)                            │
+│   • GoDAGRAG  (Graph of Directed Acyclic Graphs of RAGs) │
+└─────────────────────────────────────────────────────────┘
+  │
+  ▼  ADA (D1) — the border / membrane (screens, provenance, rate)
+┌─────────────────────────────────────────────────────────┐
+│ INNER ORGANS         inner-brain bus (Pony OPTIONAL)     │
+│   • soul (B2)                                            │
+│   • metacog (C2)                                         │
+│   • drive-box (A1)                                       │
+│   • COBOL ontological structures (E1)                    │
+└─────────────────────────────────────────────────────────┘
+  │
+  ▼
+HERMES  ← innermost core (the OpenHermes agent)
+```
+
+## Layers (innermost → outermost)
+1. **Hermes** — innermost core. The OpenHermes agent. **Not external.**
+2. **Inner-brain bus** — connects the inner organs around Hermes. **May be Pony,
+   but need not be.** Carries: soul, metacog, drive-box, COBOL ontology.
+3. **Ada (D1)** — the membrane between inner and outer. Screens everything
+   crossing in/out (blocklist / provenance / rate — `Trust_Boundary`).
+4. **Ichor (Pony)** — the **outer** bus. Connects the outer organs and wires up
+   to Ada. (This is the bus already scaffolded in `src/ichor/`.)
+5. **Outer organs** — stomach/economy (small model), microagents, SAE, GoDAGRAG.
+6. **External** — the world. Reaches in only via the outer ring → Ada.
+
+## Flow of a turn
+external input → **stomach digests** it → **GoDAGRAG** builds RAG context →
+across **Ichor** → **Ada (D1)** screens (input is already pre-digested context) →
+**inner bus** → inner organs (soul/metacog/drive-box/COBOL) → **Hermes** →
+synthesis flows back out the same rings.
+
+## Corrections this doc bakes in (vs earlier wrong models)
+- **Hermes is the core, not an external harness on Ichor.**
+- **Ichor is the OUTER bus** (organs → Ada), not the brain bus.
+- **The inner bus is transport-flexible** (Pony optional).
+- The cerebellum/harness is **not** an Ichor organ.
+
+## Open / to place
+- Exact tier + role of each outer organ's hand-off to Ada.
+- Whether the inner bus is Pony or another mechanism (decides 2nd-broker vs not).
+- How Hermes-at-core is reached from the inner bus (in-process vs IPC).