Architecture Decisions (ADR)

Architecture Decision Records document important technical decisions, their context and consequences.

ADR format

Each ADR should include:

• Decision
• Context
• Reasoning
• Alternatives considered
• Consequences

Current ADRs

• ADR 001: FastAPI with server-rendered Jinja
• ADR 002: SQLite-first persistence
• ADR 003: Database-backed settings
• ADR 004: Node helpers for browser remote access

Template

---
title: "ADR 000: Title"
description: "Short summary"
order: 100
version: "current"
---

## Decision

What was decided.

## Context

Why the decision was needed.

## Reasoning

Why this choice fits Kaya.

## Alternatives considered

Other options considered.

## Consequences

Trade-offs, risks and follow-up work.