Chemenu 2.1.0 - deterministischer Wissenskompiler

Chemenu kompiliert Rohnotizen zu einem verlinkten, quellengebundenen Wiki:
raw/ -> types/ + tools/ -> kb/ -> reports/. Was mechanisch ist, macht
tools/wikitool; was Urteil braucht, macht ein Agent unter Contracts, deren
Grenzen in Code durchgesetzt sind statt im Prompt.

Dieser Commit ist der Startpunkt der oeffentlichen Historie. Die vorherige
Entwicklung fand in einer privaten Instanz statt und ist nicht Teil dieses
Repositorys; ihre Erzaehlung steht vollstaendig in CHANGES.md, das mit 44
Eintraegen von 0.1.0 bis 2.1.0 erhalten geblieben ist.

Der mitgelieferte Korpus ist ein Testbett und eine Demo: 170 Seiten ueber den
Stack selbst - Gates, Lint, Versionierung, Suche, das Wiki-Muster. Er
dokumentiert das Werkzeug mit den eigenen Mitteln des Werkzeugs.

Lizenz: AGPL-3.0 fuer den Stack (tools/, types/), CC-BY-4.0 fuer die Inhalte.
Die Grenze zwischen beiden ist der Dateiplan, den dist export berechnet -
siehe NOTICE.

kb/concepts/Three-Layer Architecture.md

@@ -0,0 +1,266 @@
+---
+type: types/concept.md
+concept_type: architecture
+tags: [llm-wiki, layers, structure]
+created: 2026-07-26
+modified: 2026-08-29
+related: [LLM Wiki Pattern, RAG, Memory Lifecycle, Knowledge Graph]
+sources: [Source - LLM Wiki Pattern, Source - LLM Wiki v2]
+confidence: 0.95
+confidence_base: 0.95
+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
+
+- [[LLM Wiki Pattern]]
+- AGENTS.md
+- [[RAG]]
+- [[Knowledge Compounding]]
+- [[Memory Lifecycle]]
+- [[Knowledge Graph]]
+- [[Implementation Spectrum]]
+