From 094f4b2242c960835d17b8bd0a186c6e8f0de216 Mon Sep 17 00:00:00 2001 From: Carlos Infantes Date: Tue, 1 Sep 2026 20:54:00 +0200 Subject: [PATCH] Add DRF to Other ADR templates Adds the Decision Reasoning Format (DRF) to the Other ADR templates section: a schema-first, machine-readable counterpart to the prose templates already covered, with its companion context format. Signed-off-by: Carlos Infantes --- _posts/2024-10-25-adr-templates.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/_posts/2024-10-25-adr-templates.md b/_posts/2024-10-25-adr-templates.md index 77558bb..aeec536 100644 --- a/_posts/2024-10-25-adr-templates.md +++ b/_posts/2024-10-25-adr-templates.md @@ -63,3 +63,5 @@ Finally, you can find more explanations and examples on Medium: [Y-Statements - Numerous other ADR formats exist, many of which are also featured in [@joelparkerhenderson's GitHub repository](https://github.com/joelparkerhenderson/architecture_decision_record). The [template](http://www.iso-architecture.org/42010/templates/) for [ISO/IEC/IEEE 42010:2011](https://en.wikipedia.org/wiki/ISO/IEC_42010), the international standard for architecture descriptions of systems and software engineering, suggests nine information items for ADRs its Appendix A. It also identifies areas to consider when identifying key decisions. + +Where the templates above are prose-first, the [Decision Reasoning Format (DRF)](https://github.com/reasoning-formats/reasoning-formats) is schema-first: decisions are YAML documents validated against a JSON Schema, with the reasoning broken into named fields (constraints, objectives, assumptions, tensions, and the synthesis that resolves them) rather than free text. That makes the trade-off analysis queryable and lets a CI job reject a record that is internally inconsistent. A companion Context Reasoning Format (CRF) models organizational context - policies, systems, facts - as a graph that decisions reference, so a record can be checked against the constraints in force when it was made.