Architecture Decision Records

Die Architecture Decision Records des Owlat-Projekts — jeder hält den Kontext, die Entscheidung und die damit verbundenen Trade-offs fest.

Dieses Verzeichnis hält die wesentlichen Architekturentscheidungen des Owlat-Projekts fest. Jeder Eintrag erläutert den Kontext, die Entscheidung und die damit verbundenen Trade-offs.

Format

Wir verwenden ein leichtgewichtiges ADR-Format. Der Titel steht im YAML-Frontmatter (die Docs-Site rendert ihn als Seitenüberschrift), gefolgt von fett gesetzten Status-/Datumsfeldern und drei ## -Abschnitten:

---
title: "ADR-NNN: Title"
description: "One-sentence summary of what was decided and why."
---

- **Status:** Accepted | Superseded | Deprecated
- **Date:** YYYY-MM-DD

## Context

What prompted this decision.

## Decision

What was decided.

## Consequences

Trade-offs, and what this enables or prevents.

Entscheidungen

ADRTitelStatus
001Eigener E-Mail-Renderer statt MJMLAngenommen
002Convex als BackendAngenommen
003Notion-artiger E-Mail-BuilderAngenommen
004Monorepo mit Bun-WorkspacesAngenommen
005Eigener MTAAngenommen
006Selbstgehostetes ConvexAngenommen
007Austauschbarer LLM-ProviderAngenommen
008Prozessarchitektur der AgentenAngenommen
009Aufgabenbasiertes Modell-RoutingAngenommen
010Listing-EngineAngenommen
049Plugin-PlattformvertragAngenommen
050Host-eigene Registry für EntwurfsstrategienAngenommen
051Geordnete, ausschließlich einschränkende Autonomie-GatesAngenommen
052Connected Apps und signierte HooksAngenommen
053Sandboxed Plugin-JobsAngenommen

Einen neuen ADR hinzufügen

  1. Legen Sie eine neue Datei mit dem Namen <order>.NNN-short-title.md an, wobei <order> das Nuxt-Content-Sortierpräfix ist, das die Position in der Seitenleiste steuert, und NNN die nächste freie ADR-Nummer. Die neueste Datei ist 11.010-listing-engine.md, die nächste wäre also 12.011-short-title.md.
  2. Beginnen Sie die Datei mit YAML-Frontmatter, das title (z. B. "ADR-011: ...") und description enthält, und folgen Sie anschließend dem oben beschriebenen Format.
  3. Fügen Sie der Tabelle in diesem Index eine Zeile hinzu.
  4. Reichen Sie das Ganze mit Ihrem PR ein.