Aufbau Wissensdatenbank

🧠 Zusammenfassung¶

Hier ist die Analyse zu unserer Wissensdatenbank dokumentiert.

🎯 Zweck¶

Nachvollziehbarkeit der Zielsetzung, Probleme, etc.

📦 Kontext¶

🧩 Details¶

Definitionen¶

Zielbild der Wissensdatenbank¶

Was ist der primäre Zweck? Einerseits Unterstützung für Menschen und andererseits Primärquelle für KI-Agenten.
Sollen Agenten nur konsumieren oder auch aktiv schreiben? Die Agenten sollen auch aktiv schreiben - wurde ein Artikel überarbeiten bzw. neu angelegt, soll dies in einem eigenen Slack Channel vermerkt werden, sodass ein menschlicher User reviewen kann.
Was ist der gewünschte Effekt in 3 Monaten? Einerseits Dokumentation der Entscheidungen und Umsetzungen, und andererseits stabile Prozesse.

Für KI Agenten notwendig: - deterministische Struktur - maschinenlesbar - versionierbar - klarer Scope pro Dokument

Was soll ein Agent konkret in 30 Tagen selbstständig können?

Informationsarchitektur¶

klassisches Wiki scheidet aufgrund der Anforderungen aus
Welche Wissensarten haben wir? Prozesse, Wissen über Kundenprojekte, Technische Patterns(?), Entscheidungen
Jeder Artikel sollte strikt typisiert sein, zum Beispiel:

concept → Was ist etwas? process → Schritt-für-Schritt playbook → Ziel + Strategie + Umsetzung decision → Warum wurde etwas so gemacht? client → Kundenspezifisches Wissen system → Architektur / Komponenten

Wie groß ist ein Artikel maximal?
Was ist die kleinste sinnvolle Einheit? 1 Artikel = 1 Konzept

Atomic Knowledge Units (AKU)

Soll ein Agent eigenständig Wissen erzeugen dürfen?

Template-Design¶

Das Template ist wichtiger als der Content selbst.

Welche fixen Sektionen braucht jeder Artikel?
Welche Felder müssen zwingend ausgefüllt werden?
Was darf optional sein?

Governance & Ownership¶

Ohne das wird die WDB innerhalb von Wochen unbrauchbar.

Wer darf Artikel erstellen?
Wer reviewed sie und stellt die Korrektheit sicher?

Skalierend (empfohlen) 1. Agent erstellt + updated 2. Confidence Score 3. Mensch greift nur bei Unsicherheit ein

Wer ist verantwortlich für Aktualität bzw. Wann gilt ein Artikel als „veraltet“?
Wie gehen wir mit widersprüchlichem Wissen um?
Gibt es „Single Source of Truth“ Regeln?

Integration in euren Workflow (Gamechanger)¶

Die WDB darf kein Selbstzweck sein.

Wann wird Wissen erstellt?
Nach jedem Projekt? Währenddessen?
Wo ist der Einstiegspunkt? Chat? API?
Write Path Agent erkennt: „Neues Wissen entstanden“ und erstellt Artikel basierend auf Template
Read Path Agent nutzt WDB kontextuell, kein „Full Dump“, sondern gezielte Retrievals

Technisches¶

Wo liegt die DB? Git (empfohlen)
Wie erfolgt Zugriff? Schreibend File-based, menschlicher Lesezugriff zusätzlich über WebUI, Agenten bekommen Zugriff auf das GIT Repo

Kritische Risiken (aus Erfahrung)¶

Diese Dinge killen solche Initiativen:

❌ „Wir schreiben später sauber“

→ passiert nie

❌ „Freitext reicht“

→ KI wird unbrauchbar

❌ „Jeder darf alles“

→ Chaos

❌ „Wir bauen zuerst Tooling“

→ falsche Reihenfolge

Für die Designentscheidungen siehe Aufbau Wissensdatenbank - Entscheidungen.