# 9. Architecture Decisions

## 9.1 ADR 001: Use of arc42 for Documentation

**Status**: Decided
**Context**: Project was lacking a clear architectural overview.
**Decision**: Adopt the arc42 template for documenting the system architecture in Markdown.
**Consequences**: Structured documentation that is version-controlled and rendered via Sphinx.

## 9.2 ADR 002: Mermaid for Diagrams

**Status**: Decided
**Context**: Need for diagrams in the documentation.
**Decision**: Use Mermaid.js as it allows "diagrams as code" and integrates well with Sphinx.
**Consequences**: Diagrams are text-based, version-controllable, and automatically rendered.