From 37c92efd8068a2b0fda629104684442cb85e666b Mon Sep 17 00:00:00 2001
From: deeaitch <himrodim@gmail.com>
Date: Wed, 29 Jul 2026 16:46:23 -0400
Subject: [PATCH] ADR template

---
 reference/decisions/template.md | 38 +++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 reference/decisions/template.md

diff --git a/reference/decisions/template.md b/reference/decisions/template.md
new file mode 100644
index 0000000..a14c3d8
--- /dev/null
+++ b/reference/decisions/template.md
@@ -0,0 +1,38 @@
+# ADR-NNNN: Decision Title
+
+* **Status:** Proposed
+* **Date:** YYYY-MM-DD
+
+## Context
+
+Describe the problem or architectural question that requires a decision.
+
+Explain the relevant requirements, constraints, risks, and assumptions. Keep this section focused on why the decision is needed.
+
+## Decision
+
+Describe the selected approach clearly and directly.
+
+## Alternatives Considered
+
+### Alternative 1
+
+Briefly describe the alternative and why it was not selected.
+
+### Alternative 2
+
+Briefly describe the alternative and why it was not selected.
+
+## Consequences
+
+### Positive
+
+* List the main benefits of the decision.
+
+### Negative
+
+* List the costs, limitations, and trade-offs introduced by the decision.
+
+## Notes
+
+Add implementation details, unresolved questions, or links to related documents when necessary.