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

---
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 (Codebasen, 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]]

<!-- wikitool:links -->
## Beziehungen

- **see-also:** [[LLM Wiki Pattern]]
- **contrasts:** [[RAG]]
- **composition:** [[Memory Lifecycle]]
- **composition:** [[Knowledge Graph]]
<!-- /wikitool:links -->