initial: claude code workflow bundle (plan-start, status, handoff, adr)

2026-04-17 07:28:49 +02:00
commit 20a0ab38f2
16 changed files with 978 additions and 0 deletions
@@ -0,0 +1,55 @@
+# 20 — Architecture
+
+**Letzte Aktualisierung:** {{TODAY_ISO}}
+
+Diese Datei ist **kein Ort für detaillierte Begründungen** — die leben in
+`docs/30-decisions/` als ADRs. Hier steht die kompakte Architektur-Sicht, so
+wie sie aktuell gilt. Wenn du hier etwas änderst, schreibst du idealerweise
+einen ADR, der erklärt warum.
+
+## Stack
+
+**Kurz:** {{PROJECT_STACK}}
+
+<!-- TODO: Aufdröseln nach Schicht. Beispiel:
+     - Runtime: Python 3.12, uv
+     - Web-Framework: FastAPI
+     - Persistenz: PocketBase (SQLite-basiert)
+     - Reverse-Proxy: Caddy
+     - Deployment: systemd-Unit auf NixOS
+-->
+
+- Runtime: TBD
+- Framework: TBD
+- Persistenz: TBD
+- Infrastruktur: TBD
+
+## Komponenten
+
+<!-- TODO: Kurze Liste der Hauptkomponenten mit je 1–2 Sätzen Zweck. Ein
+     simples ASCII-Diagramm oder Mermaid-Block ist oft Gold wert. -->
+
+```
+<!-- TODO: Komponenten-Skizze -->
+```
+
+## Datenfluss
+
+<!-- TODO: Wie fließen Daten durch das System? Eingänge, Transformationen,
+     Ausgänge, Persistenzpunkte. Ein Absatz reicht am Anfang. -->
+
+TBD
+
+## Externe Abhängigkeiten
+
+<!-- TODO: APIs, SaaS, Hardware, die wir nicht selbst betreiben. Jede Zeile:
+     Name, Zweck, was passiert, wenn sie ausfällt. -->
+
+- TBD
+
+## Laufende ADRs
+
+<!-- Dieser Abschnitt wird durch den `adr`-Skill gepflegt: er ergänzt die Liste
+     unten beim Anlegen eines neuen ADR. -->
+
+_(Noch keine ADRs. `adr <titel>` ausführen, um einen anzulegen.)_