Skip to content

ADR Template

Michael Zargham edited this page May 16, 2026 · 2 revisions

ADR-XXX:

Status: Accepted | Superseded | Deprecated Date: YYYY-MM-DD Deciders: Michael Zargham Related: ADR-NNN (if applicable); Related Wiki Page

Context

What is the issue motivating this decision? What constraints, requirements, or alternatives shaped the question? Reference the relevant Design Spec sections (e.g., §4.3, §9.A.2) and any prior research that informed the choice.

Decision

What is the chosen approach? State it crisply. One to three sentences.

Consequences

Positive

  • ...

Negative / Tradeoffs

  • ...

Neutral

  • ...

Alternatives Considered

  • Alternative A: ... (rejected because: ...)
  • Alternative B: ... (rejected because: ...)

Implementation Notes

Optional. Pointers to specific files in flexo-rtm (or in this research repo) that implement this decision. For ADRs locked at the design phase, this section may instead reference normative locations in Design Spec.

References

  • Design Spec (relevant section)
  • Related ADRs: ADR-NNN
  • External URLs if applicable

Start here

Foundation

Internal Research

External Research

v0.1 Certification Model

Roadmap and future work

Three-Layer Architecture

Ontology Design

Interface Contracts (normative)

Adapter Contracts (background)

Reproducibility

Open issues

Decision Log

Meta

Clone this wiki locally