Skip to content

Contracts

Authority Order

  1. repo_owner_rules — Rules established by the repo owner
  2. canonical_adr — Cross-repo architecture decisions in docs/adr/canonical/
  3. architecture_spec — Published platform architecture in docs/platform-architecture/
  4. override_adr — Repo-local exceptions in docs/adr/overrides/
  5. operational_guidance — Operations and workflow docs
  6. historical_experience — Past decisions and experience notes

Cross-Repo Boundaries

  • dirac-framework defines canonical decisions; downstream repos may override with local ADRs.
  • Override ADRs must reference the canonical ADR they modify.
  • No downstream repo should modify files in dirac-framework.