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