The architecture of everything

Every tool, what it does, and how it all connects — built as one system that compounds.

The whole thing in one breath: ideas go into an engine that builds them to a high standard. Everything the engine builds stands on one shared toolbox, so the apps all feel like one family and get made fast. Each finished app joins the fleet used day to day — and writes itself into a memory that every future build can read. So the system doesn't just make things; it remembers what it made and gets better each time. That loop is the design. New to all this? Jump to "How you'd actually use it" below the map — it answers "where would I even start?"

View the plain-English overview
the brain the engine the foundation the fleet (apps) the ventures

watch one idea travel the loop

How "Lineage" — a car-history verdict app — got built

the idea

A verdict engine

"Tell me if this used car is worth buying."

the engine

Run the 11 stages

Elevated, branded, forged, graded, gated.

the foundation

Built from the kit

Design, security, AI — already solved.

the fleet

Ships as an app

A real, working product you can open.

the brain

Remembered

One line in the registry — now improvable.

Architecture map A five-layer diagram connected in a loop: brain, engine, foundation, fleet, and ventures. the engine runs on the vault's standards injects the house kit into every build every app inherits it the tools serve the ventures every build registers itself — the brain remembers THE BRAIN THE ENGINE — idea to excellent product THE FOUNDATION THE FLEET — the apps used every day THE VENTURES

Tip — click any box for what it is, what happens inside it, the tools at play there, and what it connects to. Switch on "In depth" for more.

if you wanted to use it

How you'd actually use it

The honest answer to "where do I even fit in?": day to day you really only touch two things — a Terminal window where you talk to the AI, and Obsidian where you read your notes. Everything else either gets done by the AI when you ask, or runs by itself underneath. Here's the actual rhythm.

A normal day — what you actually do

  1. Morning. Open Terminal, type claude, and say "what's on my plate?" It reads its memory and tells you where everything stands.
    you + Terminal → the brain
  2. As things come up. Drop in a note, an article, or a voice memo and say "save this." It files it where it belongs.
    → social-kb
  3. When you want to make something. Say "let's build X." The engine runs the steps and pulls you in only at the key decisions.
    → the engine
  4. To look something up. Open Obsidian and read — it's all written down and cross-linked.
    you + Obsidian → the brain
  5. End of day. Say "capture this session." It writes down what happened so tomorrow doesn't start from zero.
    → the brain

Runs by itself — you never touch it

  • The apps stay on around the clock and restart themselves if one crashes. · launchd
  • Your notes sync to every device automatically. · iCloud
  • The public apps stay online on their own. · Cloudflare

To begin (about 30 minutes, one time)

Install three things — Homebrew, Claude Code, Obsidian — then paste the bootstrap file into the AI and answer its questions. The vault builds itself. The field guide has the exact copy-paste commands; you don't need to understand them, just run them in order.

the machinery underneath

What it all runs on

These are the off-the-shelf tools the system is built from — the names you'll see in the setup guide. Here's what each one is, in plain English, and which part of the map above it powers. (Click a box up in the map to see exactly which of these come into play there.)

The Mac

The single computer the whole system lives and runs on — the apps, the memory, all of it.

powers everything

Homebrew

The installer for developer tools — like an app store you run by typing. It put the rest of this list on the Mac.

powers the setup

Terminal

The text-command window on the Mac — the cockpit the whole system is driven from, instead of clicking buttons.

powers the engine

Claude Code

The AI that reads and writes the files and actually does the building. It's the engine's hands — it runs the stages and writes the apps.

powers the engine

Obsidian

The app that opens the vault as readable, linked notes. It's how a human reads the brain — the AI writes it, Obsidian displays it.

powers the brain

iCloud

Syncs the vault across all devices, so the brain reads the same on the Mac, the phone, and the iPad.

powers the brain

Git

Version history and backup for the code — a time machine that records every change so nothing is ever lost.

powers the foundation

Python

The programming language most of the apps are written in — how each one becomes a small working web app.

powers the fleet

launchd

The Mac's built-in scheduler. It keeps the apps running around the clock and restarts them automatically if one ever crashes.

powers the fleet

Tailscale

A private, secure network that lets the phone reach the Mac's apps from anywhere — without putting them on the open internet.

powers the fleet

Cloudflare

Where the public web apps live on the internet — the trip app, the hub page, and this very page you're reading.

powers the fleet

Local AI & media tools

Free tools that run on the Mac itself — transcribe audio, read on-screen text, pull video from a link — no cloud bill, no data leaving.

powers the fleet