Skip to content

Architecture decisions

Two classes — do not mix them up:

Class Prefix Owner How they land here
Portal-owned (cross-hub) WS-### This repo Hand-written from closed workspace proposals
Runtime (binary) adr-00N engineering-runtime Aggregated at build/sync time — never hand-edited here

Portal ADRs use WS-### so they never collide with the runtime series as it grows.


Portal-owned (WS-###)

ADR Title
WS-001 Why the Workspace Hub exists
WS-002 Why Runtime and Control Plane are separate hubs
WS-003 Why App API owns published contracts
WS-004 Why the Developer Portal is private
WS-005 Why documentation ships with implementation
WS-006 Why build-the-product knowledge will be read from the portal (direction — not implemented)

Runtime (aggregated)

See Runtime ADRs — five binary ADRs, each stamped with source path and commit SHA.