diff --git a/DECISIONS.md b/DECISIONS.md
new file mode 100644
index 0000000..7c10a26
--- /dev/null
+++ b/DECISIONS.md
@@ -0,0 +1,30 @@
+# Decision Log
+
+_Auto-generated by the Custodian State Hub._
+
+## ADR-001: flex-auth implementation language is Go
+
+**Date:** 2026-07-02  
+**Decided by:** human  
+
+This was a reasonable idea and i wanted to try.
+
+---
+
+## ADR-002: Policy packages are Rego-in-Markdown
+
+**Date:** 2026-07-02  
+**Decided by:** human  
+
+Marckdown is my goto format for human and agent understanding.
+
+---
+
+## ADR-003: Standalone core is Topaz-aligned from day one
+
+**Date:** 2026-07-02  
+**Decided by:** human  
+
+This should provide proper guidance. So we do it this way.
+
+---