chemenu/kb/concepts/Three-Layer Architecture.md

type, concept_type, tags, created, modified, related, sources, confidence, confidence_base, provenance, summary

type	concept_type	tags	created	modified	related	sources	confidence	confidence_base	provenance	summary
types/concept.md	architecture	llm-wiki layers structure	2026-07-26	2026-08-29	see-also LLM Wiki Pattern contrasts RAG composition Memory Lifecycle composition Knowledge Graph	Source - LLM Wiki Pattern Source - LLM Wiki v2	0.95	0.95	sourced	Strukturmodell des LLM-Wiki-Musters mit drei Schichten: unveränderliche Rohquellen, vom LLM gepflegtes Wiki und Schemakonfiguration, die Knowledge Compounding trägt.

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