SB / EDGE

ARCH Case studies — postmortems & runbooks

Case studies, drawn as routes.

Written the way incidents get written up: what was built, what broke, what the design does about it. Anonymized, load-bearing, and free of hero narratives — the system is the protagonist.

ROUTE 01 ○ CLIENT — DO — SYNC

Real-Time Collaboration Platform

Presence, conflict resolution, and sync that degrades politely when the network does not. CRDT sync over Durable Objects — and what actually degrades first at ten thousand concurrent editors.

REACT · NODE.JS · WEBSOCKETS · POSTGRESQL · REDIS

ROUTE 02 ○ EDGE — TENANT — D1

Multi-Tenant SaaS on Cloudflare

Tenant isolation with Workers, D1 and R2. Routing at the edge, billing boundaries in the schema, and no shared state by accident.

WORKERS · D1 · R2 · KV · DURABLE OBJECTS

ROUTE 03 ○ QUERY — EMBED — CITE

AI Document Assistant / RAG

Retrieval that can prove where an answer came from. Evaluation loops before feature loops; a retrieval pipeline that regressed quietly, and the eval harness that now catches it.

PYTHON · FASTAPI · VECTOR DB · REACT

ROUTE 04 ○ PLAN — TOOL — VERIFY

Agentic Workflow System Design

Agents as narrow tools with contracts. Tool boundaries, checkpoints, human gates — autonomy budgeted as a governed resource.

LLMS · AGENTS · PYTHON · POSTGRESQL

ROUTE 05 ○ APP — FEATURE — DOMAIN — UI-KIT

Frontend Architecture for Enterprise Scale

Module boundaries a new hire can learn in a week and a team can hold for five years. Ownership maps, dependency rules, and the small set of conventions worth enforcing by machine.

REACT · TYPESCRIPT · DESIGN SYSTEMS · MODULE BOUNDARIES

Five case studies in system design. Each answers the same question: where do the boundaries go, and what happens when a piece fails? The interesting parts are load-bearing. Everything else is deliberately dull.

Discuss an architecture review →