בס״ד

Unified Brain — the architecture direction (researched 2026-06-22)

docs/UNIFIED_BRAIN_ARCHITECTURE.md · last changed (pre-VM history) · rendered from GitHub master

Unified Brain — the architecture direction (researched 2026-06-22)

Sam asked: knowing what we know, how would we have built the bot/brain differently, is the stack (Apps Script + Google + cloud) right, cost-aware, and what's the best way now. This is the grounded answer after researching the last few weeks of Claude Code / agent developments. Living doc.

The diagnosis (it has a name)

What Sam felt — "the bot's a problem, we never finished unifying the brain" — is the #1 documented agent-architecture failure of 2026: siloed memory. Running multiple AI surfaces with separate memory/brains means no single one has the complete picture. The field's fix: one unified memory layer every surface reads + writes. We've been hand-building exactly that.

Today we have N brains pretending to be one: the Telegram bot (its own Apps Script + Claude call + prompt + tools + transcript), the MIS, Claude Code (me), the portal — each siloed, sharing only storage, not live awareness or guardrails. That is why the bot guessed "NKE ~$77": it doesn't share the MIS price data or my no-guessing guardrail.

How we'd build it differently — one brain, many faces

A single brain: one unified memory, one tool set, one set of guardrails. The bot / portal / Claude Code / Chanie's / Mildred's all become thin faces that call it. Wire a rule once ("never quote a price without the MIS tool") and every face inherits it — the bot literally couldn't hallucinate.

Native primitives that now exist (stop hand-rolling)

Is the stack right? (cost-aware)

The punchline

The unified brain is the SINGLE answer to everything Sam asked: untether from the PC · smarter at day 100 · open the bottleneck · the bot shouldn't lie. Not five projects — one. First brick: wire the bot to the shared brain's MIS price tool (the NKE fix) + the no-guess guardrail.

Sources

Claude Code changelog · Releasebot (Anthropic updates) · The New Stack (dreaming) · 9to5Mac (managed agents) · Dotzlaw (Code with Claude 2026, infinite context) · SitePoint (personal AI agent OS).

Source trail · docs/UNIFIED_BRAIN_ARCHITECTURE.md @ master · rendered 2026-07-02 7:23 PM EDT by scripts/build-docs.py · the .md in the repo is the truth; this page is the phone-readable view