ADR-0001 Bootstrap Architecture Decision Records

.adr-dir

@@ -0,0 +1 @@
+docs/decisions

.gitignore

@@ -0,0 +1,4 @@
+# MkDocs build output
+site/
+# temporary files
+tmp/

README.md

@@ -1,2 +1,3 @@
-# architecture
-Technical architecture governance for SciLifeLab infrastructure -  ensuring interoperability, standards, and sustainable design
+# SciLifeLab Architecture
+
+Technical architecture governance for SciLifeLab infrastructure - ensuring interoperability, standards, and sustainable design

docs/decisions/0001-record-architecture-decisions.md

@@ -0,0 +1,19 @@
+# ADR-0001. Record architecture decisions
+
+Date: 2025-11-25
+
+## Status
+
+Accepted
+
+## Context
+
+We need to record the architectural decisions made on this project.
+
+## Decision
+
+We will use Architecture Decision Records, as [described by Michael Nygard](http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions).
+
+## Consequences
+
+See Michael Nygard's article, linked above. For a lightweight ADR toolset, see Nat Pryce's [adr-tools](https://github.com/npryce/adr-tools).

docs/decisions/templates/template.md

@@ -0,0 +1,19 @@
+# ADR-NUMBER. TITLE
+
+Date: DATE
+
+## Status
+
+STATUS
+
+## Context
+
+The issue motivating this decision, and any context that influences or constrains the decision.
+
+## Decision
+
+The change that we're proposing or have agreed to implement.
+
+## Consequences
+
+What becomes easier or more difficult to do and any risks introduced by the change that will need to be mitigated.

scripts/adr-new

@@ -0,0 +1,17 @@
+#!/bin/bash
+# Wrapper for adr-new that formats ADR identifiers as ADR-0001, ADR-0002, etc.
+set -e
+
+# Create the ADR using the standard tool
+output=$(adr new "$@")
+
+if [ -n "$output" ] && [ -f "$output" ]; then
+    # Extract the number from filename (e.g., 0002 from 0002-some-title.md)
+    filename=$(basename "$output")
+    padded_num=$(echo "$filename" | grep -oE '^[0-9]+')
+
+    # Replace "ADR-N." with "ADR-000N." in the file
+    sed -i "s/^# ADR-[0-9]\+\./# ADR-${padded_num}./" "$output"
+
+    echo "$output"
+fi