Architecture Decision Records (ADR)

This folder contains documents explaining WHY certain architectural decisions were made, not just WHAT was decided.

What is an ADR?

An ADR documents: - The context/problem at the time - The decision made - The consequences (positive and negative)

Why ADRs?

• Prevents repeating past mistakes
• Helps new team members understand choices
• Creates historical record of evolution

Index

ID	Title	Status	Date
001	Multi-tenancy Implementation	Accepted	2026-01
002	JWT vs Session Auth	Accepted	2026-01

Creating a New ADR

# ADR-XXX: Title

## Status
Accepted | Deprecated | Superseded

## Context
What was the situation?

## Decision
What was decided?

## Consequences
- Positive: ...
- Negative: ...