cluster-knaster/docs/adr/0003-slots-und-eine-lifecycle-pipeline.md

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.