docs: Architekturplan, ADRs, Spezifikationen und Umsetzungsplan

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-11 14:00:36 +02:00
commit fef930d176
15 changed files with 854 additions and 0 deletions
@@ -0,0 +1,17 @@
+# ADR-0004: Halbautomatische Pflege über einen Pflege-Agenten (HITL)
+
+- Status: angenommen
+- Datum: 2026-10-11
+
+## Kontext
+Der Mensch soll Pflegeaufträge per Prompt erteilen können und regelmäßig durch eine Service-Routine geführt werden. Vollautomatik ist bei qualitäts- und kostenrelevanten Schritten nicht gewünscht.
+
+## Entscheidung
+- Der Pflege-Agent sammelt Befunde, erzeugt **Vorschläge** und führt nur Freigegebenes aus.
+- Aufträge des Menschen werden zu Vorschlägen und brauchen eine Bestätigung.
+- Die **Freigabe-Richtlinie** (`config/policy.yaml`) entscheidet pro Aktionstyp über `auto` oder `approve`. Grundsatz: Schritte in die sichere Richtung laufen automatisch, Schritte, die Qualität oder Kosten ändern, brauchen eine Freigabe.
+- Befehle werden zuerst über eine **feste Grammatik** verstanden. Ein LLM darf Freitext nur auf diese Befehle abbilden und löst niemals selbst eine Aktion aus.
+
+## Folgen
+- Jede Aktion ist nachvollziehbar (Vorschlag, Freigabe, Ausführung, Ergebnis).
+- Der Agent ist austauschbar: Der Kanal kann n8n Chat, Telegram oder Matrix sein, die Logik liegt im Router-Service.