Knowledge Portal · engineering documentation

Skip to content

Architecture Decision Records ​

Status: Canonical index
Last updated: 2026-07-05


Purpose ​

ADRs record immutable architectural decisions — context, decision, consequences, and alternatives.

Template: STANDARDS/templates/adr-template.md


Index ​

Foundation (ZEP) ​

ADRTitleStatus
ADR-001Why ZEP existsAccepted
ADR-002Documentation firstAccepted
ADR-003Runtime contractsAccepted
ADR-004Adapter architectureAccepted
ADR-005Platform vs product separationAccepted
ADR-006Enterprise architecture governanceAccepted

AI & intelligence ​

ADRTitleStatus
ADR-007Benchmark never changes runtimeAccepted
ADR-008Human approval mandatoryAccepted
ADR-009Why PL-003 existsAccepted
ADR-010Why PL-004 owns learningAccepted
ADR-011Products never own intelligenceAccepted
ADR-012Why version registry existsAccepted
ADR-013Presentation belongs to productsAccepted

Legacy location ​

Original ADR-001–006 authoring path: platform/adr/ — superseded by this directory for navigation.

Registry index: zaixos-registry ADR catalog


When to write an ADR ​

See ARCHITECTURE/decision-flow.md


Breadcrumbs: Home → ADR

ZAIXOS Knowledge Portal — public engineering docs at /docs · Staff operations at /admin