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,14 @@
+# ADR-0003: Slots statt Modellnamen, eine Lifecycle-Pipeline
+
+- Status: angenommen
+- Datum: 2026-10-11
+
+## Entscheidung
+- Clients (n8n, Hermes, Skills) sprechen **Slots** an (`tier1-general`, `verifier-small`, …). Was hinter einem Slot steht (Basismodell, Adapter, Engine, Node), legt nur die Registry fest.
+- Jede Änderung hinter einem Slot ist ein **Kandidat**, egal ob Basismodell, Adapter, Quantisierung, Embedding-Modell oder Engine. Jeder Kandidat durchläuft dieselbe Pipeline: Build → Eval → Shadow → Canary → Promote, mit Rollback.
+- Adapter sind über `(base_model, cluster, version)` adressiert. Ein Basiswechsel zieht das Neutraining der Adapter nach sich.
+- Trainingsdaten werden **modellneutral** gespeichert (Nachrichtenlisten ohne Chat-Template).
+
+## Folgen
+- Ein Modellwechsel ist eine Registry-Änderung und betrifft keinen Workflow.
+- Die Pipeline muss pro Kandidatentyp wissen, welche Golden Sets sie prüft.