Knowledge Portal · engineering documentation

Skip to content

Decision Flow

Status: Canonical
Last updated: 2026-07-05

Write an ADR when:

  • Adding or changing a platform boundary
  • Choosing between platform vs product ownership
  • Introducing a new cross-product pattern
  • Changing AI governance (benchmark, approval, registry)
mermaid
flowchart TD
    Q{Boundary or governance impact?}
    Q -->|Yes| ADR[Write ADR]
    Q -->|No| DOC[Update section doc]
    ADR --> REV[Architecture review]
    REV --> MERGE[Merge + index update]
    DOC --> MERGE

Template: STANDARDS/templates/adr-template.md

Breadcrumbs: Home → Architecture → Decision Flow

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