docs: adrs

Makefile

@@ -0,0 +1,5 @@
+newadr:
+	@echo "Initiating an ADR..."
+	@read -p "Enter ADR number (e.g. 001): " number; \
+	read -p "Enter ADR title: " title; \
+	cp $(CURDIR)/adr/adr-template.md $(CURDIR)/adr/adr-$${number}-$${title}.md

README.md

@@ -57,11 +57,11 @@ Jan is a monorepo that pulls in the following submodules
 
 ```shell
 ├── docker-compose.yml
-├── jan-mobile
-├── jan-web
-├── jan-backend
-├── jan-inference
-├── jan-docs
-    ├── adrs        # Architecture Decision Records
+├── mobile-client
+├── web-client
+├── app-backend
+├── inference-backend
+├── docs                # Developer Docs
+├── adrs                # Architecture Decision Records
 ```
 

adr/README.md

@@ -0,0 +1,18 @@
+# Architectural Decision Records (ADR)
+
+This is a repo of key architecture decisions for Jan. [Read more about ADRs](https://github.com/joelparkerhenderson/architecture-decision-record)
+
+
+### Get started:
+
+```sh
+# In root:
+make newadr
+```
+
+### Template:
+- **Status**: `pending`, `approved`, or `rejected`
+- **Context**: a clearly defined problem/goal
+- **Decisions**: the proposed architecture choices & changes
+- **Consequences**: pros and cons of the decision
+- **References**: any relevant materials to read

adr/adr-template.md

@@ -0,0 +1,24 @@
+# ADR {ADR-NUM}: {TITLE}
+
+## Changelog
+- {date}: {changelog}
+
+## Status
+
+What is the status, such as proposed, accepted, rejected, deprecated, superseded, etc.?
+
+{Proposed|Accepted|Rejected}
+
+## Context
+
+What is the issue that we're seeing that is motivating this decision or change?
+
+## Decision
+
+What is the change that we're proposing and/or doing?
+
+## Consequences
+
+What becomes easier or more difficult to do because of this change?
+
+## Reference