{"slug":"implementation/reference-architecture","title":"24 · Reference Architecture","section":"implementation","sectionLabel":"Implementation","status":"unclassified","type":"document","path":"implementation/reference-architecture.mdx","bytes":2782,"description":"Every logical plane → services, packages, apps, contracts, runtime, storage, external systems. How the Founder Canon maps to reality.","updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"\n## Every Logical Plane Becomes Something Runnable\n\nThe Founder Canon defines logical planes. This view maps each plane to **services, packages, apps, contracts, runtime, storage, and external systems** — without redefining the Canon.\n\n| Logical plane (Canon) | Implemented as |\n|---|---|\n| **Business Context Spine** | `services/spine`, `packages/spine-*`, D1/KV + canonical entities, governed writers |\n| **Human Workbench** | `apps/web` + `apps/docs` (Mintlify) — projections over the Spine |\n| **AI Workbench** | `services/ai` + `services/twin`, AI Gateway, ADK runtime, AI Continuity store (G-10) |\n| **Work** | `packages/work`, `services/work`, Work state machine, evidence store |\n| **Projection / Context Assembly** | Projection Engine + Context Fetch + Active Context Bundle contracts |\n| **Capability Fabric** | `packages/capability`, ADK, MCP Pool routing, native + Marketplace capabilities |\n| **Governance / Authority** | Policy engine, approval flows, Authority resolver |\n| **Hermes** | `services/hermes`, execution routes, evidence capture |\n| **Sync / Verify / Reconcile** | Loader, Normalizer, Pipeline (four flows), verification + reconciliation |\n| **Identity / Tenancy / Security** | IW One Auth (Descope + Nango), tenancy isolation, audit/observability |\n| **Distribution** | `apps/web`, Continuity Bridge, MCP, APIs, SDKs |\n\n\nThe canon diagram is the contract. This page is the map. Drift is tracked in [Codebase Alignment](/implementation/codebase-alignment) — this page never redefines the Canon.\n\n\n## Where Detail Lives\n\n* **Contracts** — [Contracts](/implementation/contracts): schemas, commands, events, capabilities, projections, authority, Work, memory, integration.\n* **Runtime wiring** — [Runtime Wiring](/implementation/runtime-wiring): what imports what, what invokes what, live vs orphaned paths.\n* **ADRs** — [ADRs](/implementation/adrs): why AI Workbench superseded Twin Workbench, three continuities, Spine Agents, Discovery/Activation boundary, MCP routing.\n\n## Where to Go Next\n\n<CardGroup cols={2}>\n  \n    Founder Canon → repository reality. Drift register G-01 → G-10.\n  \n  \n    Central index of every contract the runtime obeys.\n  \n  \n    Actual dependency graph: what is live, what is orphaned.\n  \n</CardGroup>\n"}