Skip to content

ADR as Single Source of Truth

Rule

Architecture decisions must be recorded and updated only in decision records (ADR); all other representations must be derived from ADR.

Rationale

Prevents inconsistencies between pattern metadata, AEM, and decision workflows.

Applies To

  • ADR
  • pattern frontmatter
  • AEM generation
  • decision sync workflows

Example

If a decision is made to adopt a new pattern, the ADR must be updated to reflect this decision. The pattern metadata and AEM must then be updated based on the ADR, ensuring that the ADR remains the single source of truth for architectural decisions.


See Also