Skip to content

Architectural Decision Records (ADRs)

An Architecture Decision Record (ADR) is a short text file capturing a significant design decision, including its context, alternatives considered, and consequences. This directory acts as the historical log of architectural choices for the Intelligence Cloud Platform.


ADR Index

ID Title Status Date
ADR 0001 Docs-as-Code Standard Proposed 2026-06-21
ADR 0002 Keycloak OIDC Authentication Accepted 2026-06-21
ADR 0003 LXD Project Multi-Tenancy Accepted 2026-06-21
ADR 0004 Isolated Terraform State Storage Accepted 2026-06-21

ADR Template

When creating new records, follow the standard Michael Nygard format:

# ADR [Number]: [Title]

## Status
[Draft | Proposed | Accepted | Rejected | Superceded]

## Context
What is the problem we are trying to solve? What parameters, constraints, and requirements exist? What options were considered?

## Decision
What is the chosen solution? How does it solve the problem?

## Consequences
What are the results of this choice? What is easier, harder, or requires follow-up?