AI Suite Technical Debt Register
Stand: 2026-05-30
Kurzfazit
Die AI Suite ist operativ stabil, aber die naechsten Produktreife-Schritte liegen weniger in neuen Features und mehr in Secret-Automation, Knowledge-Operationalisierung, OpenWebUI-Modellsicht und Dokumentationskonsolidierung.
P1
| Thema |
Aufwand |
Risiko |
Nutzen |
Empfehlung |
| OpenWebUI raw model visibility |
niedrig-mittel |
mittel |
verhindert falsche Modellwahl im Alltag |
Live-DB/Role-Settings exportieren, Normaluser auf Lanstyle-Aliase begrenzen |
| Nous Core Runtime Health Transparenz |
niedrig-mittel |
mittel |
trennt Gateway-Stubs von echtem Core |
Service/Port auf LXC 260 validieren und Doku korrigieren |
| Vaultwarden Live Gap ohne Secretwerte |
mittel |
mittel |
verhindert wiederkehrende Secret-Blocker |
serverseitiges Status-/Fingerprint-Inventory bauen |
| Obsidian/Qdrant Reindex Service |
mittel |
mittel |
macht Retrieval reproduzierbar |
dry-run, Snapshot, Validation, dann Timer |
| Retrieval Validation Service |
mittel |
niedrig |
misst Knowledge-Qualitaet |
Query-Suite mit Quellen/Freshness |
| Knowledge Ops Runtime Secrets |
niedrig |
mittel |
entkoppelt vom Mac |
root-only Env + Vaultwarden Entry |
| OpenCode Reject UX |
niedrig |
niedrig |
reduziert Verwirrung bei "erlaubt, aber abgelehnt" |
Client-Allow vs serverseitige Approval klar ausgeben |
P2
| Thema |
Aufwand |
Risiko |
Nutzen |
Empfehlung |
| Doku-Dubletten weiter reduzieren |
mittel |
niedrig |
bessere Operator-Lesbarkeit |
Referenzseite fuehrend, Detailseiten verlinken |
| Rotation Policy vereinheitlichen |
niedrig |
niedrig |
bessere Auditierbarkeit |
Pflichtfelder in Security/Vaultwarden-Doku |
| Teams/Jarvis Secret Owner finalisieren |
niedrig |
niedrig |
produktionsnaehere Integrationen |
vor Pilot klaeren |
| Qdrant Historical Filtering |
mittel |
niedrig |
weniger veraltete Retrieval-Treffer |
Tags/Filter fuer historical/rollback-only |
| OpenCode Hermes Context Tool aktivieren |
mittel |
mittel |
bessere Ops-Antworten |
Hybrid Routing statt kompletter Proxy |
P3
| Thema |
Aufwand |
Risiko |
Nutzen |
Empfehlung |
| Mermaid-Diagramme vereinheitlichen |
niedrig |
niedrig |
bessere Uebersicht |
Zielbild in Referenzarchitektur halten |
| Alte Roadmap-Seiten mit Statusboxen versehen |
niedrig |
niedrig |
weniger Verwirrung |
HISTORICAL / AUDIT CONTEXT Marker |
| Obsidian Tag-Taxonomie ausrollen |
mittel |
niedrig |
bessere Reindex-Qualitaet |
Governance v2 als Vorlage |
| Operator Dashboard Metriken polieren |
mittel |
niedrig |
Alltagstauglichkeit |
nach Retrieval Validation |
Bewusst nicht jetzt
| Thema |
Grund |
| automatische Reconciliation |
wuerde Governance-Risiko erhoehen |
| automatische Memory-Fact-Bestaetigung |
Fact Review muss Human-in-the-loop bleiben |
| direkte Infrastruktur-Writes durch Hermes |
Controlled Execution darf nicht umgangen werden |
| Vaultwarden Unlock aus Chat-/Tool-Kontext |
Secret Exposure Risiko in Tooltraces |