--- type: types/concept.md concept_type: architecture tags: [llm-wiki, layers, structure] created: 2026-07-26 modified: 2026-08-29 related: - see-also: LLM Wiki Pattern - contrasts: RAG - composition: Memory Lifecycle - composition: Knowledge Graph sources: [Source - LLM Wiki Pattern, Source - LLM Wiki v2] provenance: sourced summary: "Strukturmodell des LLM-Wiki-Musters mit drei Schichten: unver\xE4nderliche Rohquellen, vom LLM gepflegtes Wiki und Schemakonfiguration, die Knowledge Compounding tr\xE4gt." --- # Three-Layer Architecture **Typ:** Architecture (Foundation of LLM Wiki Pattern) ## Definition Die Three-Layer Architecture ist die strukturelle Grundlage des [[LLM Wiki Pattern]], bestehend aus drei unterschiedlichen Schichten: Rohquellen, Das Wiki und Das Schema. Jede Schicht hat eine spezifische Rolle und behält Separation of Concerns bei um die Wissens-Kompoundierungs-Effekte des Patterns zu ermöglichen. ## Kernpunkte ### Schicht 1: Rohquellen **Zweck:** Unveränderliche Quelle der Wahrheit **Merkmale:** - Kuratierte Sammlung von Quelldokumenten - Read-only aus der Perspektive des LLM - Enthält: Artikel, Papiere, Bilder, Datendateien, Notizen, Spezifikationen - **Niemals verändert** durch das LLM - Human-verwaltet: Benutzer fügt Quellen hinzu und organisiert sie **Verzeichnis:** `raw/` **Unterverzeichnisse:** - `raw/articles/` — Web-Artikel, Blog-Beiträge - `raw/documents/` — PDFs, Spezifikationen, Handbücher - `raw/notes/` — Persönliche Notizen, Besprechungstranskriptionen - `raw/assets/` — Bilder, Diagramme, Binärdateien **Begründung:** - Erhält Originalmaterial der Quelle - Stellt Audit-Trail zurück zu primären Quellen bereit - Ermöglicht Neuverarbeitung, wenn nötig - Benutzer behält Kontrolle über Quellenauswahl --- ### Schicht 2: Das Wiki **Zweck:** LLM-gepflegte Wissens-Synthese **Merkmale:** - Verzeichnis von LLM-generierten Markdown-Dateien - **Vollständig besessen und gepflegt durch das LLM** - Human liest es; LLM schreibt es - Enthält: Zusammenfassungen, Entity-Seiten, Concept-Seiten, Vergleiche, Index, Log - Dynamisch aktualisiert, während neue Quellen ingested werden **Verzeichnis:** `kb/` **Collections:** Ein Verzeichnis unter `kb/` ist eine Collection genau dann, wenn es eine `COLLECTION.md` trägt; ein Unterverzeichnis darin ist ein Bereich, der sie erbt. - `kb/entities/` — Entity-Seiten (Projekte, Systeme, Tools, Technologien, Personen) - `kb/concepts/` — Concept-Seiten (Architekturen, Patterns, Protokolle, Workflows) - `kb/sources/` — Zusammenfassungen von ingested Quellen - `kb/comparisons/` — Vergleichstabellen und Analysen - `kb/CONTRACT.md` — Regeln, die von jeder Collection geteilt werden - `kb/index.md` — Katalog aller Seiten - `kb/log.md` — Chronologisches Audit-Log In diesem Repository wurde die Wiki-Schicht am 2026-08-21 von `wiki/` zu `kb/` umbenannt, wenn jedes seiner Unterverzeichnisse zu einer First-Class-Collection mit eigenem Contract befördert wurde. Eine vierte Phase, `reports/`, hält generierten Lint-Output außerhalb des Knowledge-Baums und ist gitignoriert. **Seitentypen:** - **Source-Seiten**: Zusammenfassungen mit Metadaten, Kernpunkte, Aufgaben - **Entity-Seiten**: Strukturierte Informationen über spezifische Elemente - **Concept-Seiten**: Definitionen, Beispiele, wann zu verwenden - **Vergleichs-Seiten**: Nebeneinander-Analyse - **Index**: Content-oriented Katalog - **Log**: Chronologischer Betriebsdatensatz **Begründung:** - Trennt synthetisiertes Wissen von Rohquellen - Ermöglicht Querverweise und Verbindungen - Erlaubt LLM Konsistenz zu wahren - Bietet Mensch-lesbare Struktur --- ### Schicht 3: Das Schema **Zweck:** Konfiguration und Betriebsanweisungen für das LLM **Merkmale:** - Definiert wie das Wiki strukturiert ist - Dokumentiert Konventionen und Seitenformate - Spezifiziert Workflows (Ingest, Abfrage, Lint) - **Co-entwickelt** durch Mensch und LLM über Zeit - Normalerweise eine einzelne Konfigurationsdatei **Datei:** `AGENTS.md` (oder `CLAUDE.md` für Claude Code) **Inhalt:** - Verzeichnis-Struktur-Definitionen - Seitenformat-Templates - Workflow-Beschreibungen - Namenskonventionen - Qualitätsstandards - Wartungsplanung - Benutzereinstellungen **Begründung:** - Macht LLM zu disziplinertem Wiki-Verwalter statt generischem Chatbot - Mensch und LLM arbeiten zusammen bei Schema-Entwicklung - Stellt Konsistenz über Sessions sicher - Dokumentiert das System für zukünftige Referenz --- ## Architekturdiagramm ``` ┌─────────────────────────────────────────────────────────────┐ │ THREE-LAYER ARCHITECTURE │ ├─────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────────┐ ┌─────────────────┐ ┌───────────┐ │ │ │ LAYER 1: │ │ LAYER 2: │ │ LAYER 3: │ │ │ │ Raw Sources │───▶│ The Wiki │◀───│ The │ │ │ │ │ │ │ │ Schema │ │ │ │ - Immutable │ │ - LLM-maintained│ │ │ │ │ │ - Human-curated│ │ - Dynamic │ │ - Config │ │ │ │ - Source truth │ │ - Synthesized │ │ - Workflows││ │ └─────────────────┘ └─────────────────┘ └───────────┘ │ │ │ │ User ↔ AGENTS.md (Layer 3) ↔ LLM ↔ Wiki (Layer 2) ← Raw (Layer 1)│ │ │ └─────────────────────────────────────────────────────────────┘ ``` ## Datenfluss ### Ingest-Ablauf ``` User adds file to raw/ ↓ LLM reads source (Layer 1) ↓ LLM follows AGENTS.md instructions (Layer 3) ↓ LLM creates/updates pages in kb/ (Layer 2) ↓ LLM updates index.md and log.md ``` ### Abfrage-Ablauf ``` User asks question ↓ LLM reads index.md (Layer 2) to find relevant pages ↓ LLM reads relevant wiki pages (Layer 2) ↓ LLM follows cross-references ↓ LLM synthesizes answer with citations ↓ Valuable answers filed back into kb/ (Layer 2) ``` ## Vorteile dieser Architektur ### Separation of Concerns - **Rohquellen**: Human-Verantwortung (Kurationen, Organisation) - **Das Wiki**: LLM-Verantwortung (Wartung, Querverweise) - **Das Schema**: Gemeinsame Verantwortung (Entwicklung, Verfeinerung) ### Ermöglicht Wissens-Compounding - Rohquellen bleiben stabil für Neuverarbeitung - Wiki wächst und verbindet sich ohne Quellen zu ändern - Schema verbessert sich, wenn Mensch und LLM lernen, was funktioniert ### Wartbarkeit - Klare Grenzen zwischen Schichten - Jede Schicht kann sich unabhängig entwickeln - Einfach zu debuggen und zu verstehen ### Flexibilität - Funktioniert mit jedem LLM-Agent (Claude, Codex, etc.) - Anpassbar an verschiedene Domänen - Modulare Komponenten können ausgetauscht werden ## Vergleich mit anderen Architekturen | Feature | Three-Layer | Traditional RAG | Simple Wiki | Database | |---------|-------------|----------------|-------------|----------| | Persistenz | Ja | Nein | Ja | Ja | | Automatisierung | LLM | LLM | Manuell | Manuell | | Querverweise | Automatisch | Nein | Manuell | Manuell | | Quellen-Trennung | Ja | Teilweise | Variiert | Nein | | Skalierbarkeit | Hoch | Mittel | Niedrig | Hoch | ## Implementierungshinweise ### Für dieses Wiki - **Schicht 1**: `raw/` Verzeichnis mit Artikeln, Notizen, usw. - **Schicht 2**: `kb/` Verzeichnis mit allen generierten Inhalten - **Schicht 3**: `AGENTS.md` am Repository-Root ### Anpassung an andere Domänen - Modifiziere Schema (Schicht 3) um Domänen-Konventionen zu erfüllen - Passe Entity/Concept-Typen im Wiki an (Schicht 2) - Quellen-Schicht (Schicht 1) bleibt weitgehend gleich ## V2-Erweiterungen Die ursprüngliche Three-Layer Architecture bleibt die Grundlage. [[Source - LLM Wiki v2]] (siehe [[Source - LLM Wiki v2]]) addiert zusätzliche Schichten und Erweiterungen, die auf dieser Grundlage aufbauen: ### Zusätzliche Schichten **Schicht 4: Knowledge Graph** (Optional) - Strukturierte Darstellung von Entities und Beziehungen - Erweitert Schicht 2 (Das Wiki) mit Maschinen-lesbarer Struktur - Ermöglicht Graph-Traversal-Abfragen - Siehe: [[Knowledge Graph]] **Schicht 5: Memory Tiers** (Optional) - Working Memory, Episodic Memory, Semantic Memory, Procedural Memory - Gestaffelte Speicherung mit verschiedenen Aufbewahrung und Zugriffsmuster - Siehe: [[Consolidation Tiers]], [[Memory Lifecycle]] ### Erweiterte Schichten **Erweiterte Schicht 2 (Das Wiki):** - Kann nun Vertrauens-Scores für Fakten enthalten (siehe [[Confidence Scoring]]) - Unterstützt Supersession-Beziehungen (siehe [[Supersession]]) - Implementiert Vergessen/Aufbewahrung-Kurven (siehe [[Forgetting]]) **Erweiterte Schicht 3 (Das Schema):** - Kann Hooks und Automatisierungs-Regeln definieren (siehe [[Event-Driven Automation]], [[Hooks]]) - Kann Qualitäts-Standards und Scoring spezifizieren (siehe [[Quality and Self-Correction]]) - Kann Datenschutz- und Governance-Richtlinien konfigurieren (siehe [[Privacy and Governance]]) Die Three-Layer Architecture bleibt gültig und ausreichend für viele Anwendungsfälle. Die v2-Erweiterungen sind optionale Verbesserungen, die nach Bedarf übernommen werden können (siehe [[Implementation Spectrum]]). ## Geschichte - [1945] - Vannevar Bushs [[Memex]]-Konzept deutet auf gestaffelte Wissensverwaltung hin - [2023-2024] - LLM Wiki Pattern formalisiert Three-Layer Architecture - [2026-07-26] - Concept-Seite erstellt ## Siehe auch - AGENTS.md - [[Knowledge Compounding]] - [[Implementation Spectrum]] ## Beziehungen - **see-also:** [[LLM Wiki Pattern]] - **contrasts:** [[RAG]] - **composition:** [[Memory Lifecycle]] - **composition:** [[Knowledge Graph]]