kb/concepts/ bekommt Areas: layout: fuer concept, Area-Titel aus jedem Type-Spec, Schwellen-Empfehlung im lint (schliesst #59)

Files changed: - CHANGES.md - README.md - VERSION - kb/concepts/Ambient Environment Dependency.md - kb/concepts/Anti-Cramming Heuristic.md - kb/concepts/Audit Trail.md - kb/concepts/BM25.md - kb/concepts/Bulk Operations.md - kb/concepts/CI Integration.md - kb/concepts/COLLECTION.md - kb/concepts/CPPC.md - kb/concepts/Checkpoint Audit.md - kb/concepts/Claude Code Auto Mode.md - kb/concepts/Command Round-Trip Integrity.md - kb/concepts/Confidence Scoring.md - kb/concepts/Consolidation Tiers.md - kb/concepts/Content Quality Control.md - kb/concepts/Context Isolation.md - kb/concepts/Contradiction Resolution.md - kb/concepts/Cross-platform Agent Skills.md - kb/concepts/Crystallization.md - kb/concepts/Delete Rather Than Anonymize.md - kb/concepts/Denylist over Allowlist.md - kb/concepts/Detect-Repair Asymmetry.md - kb/concepts/Diff-Reviewable Agent Edits.md - kb/concepts/Dual Licensing by File Plan.md - kb/concepts/Entity Extraction.md - kb/concepts/Episodic Memory.md - kb/concepts/Event-Driven Automation.md - kb/concepts/Filter on Ingest.md - kb/concepts/Forgetting.md - kb/concepts/Graph Traversal.md - kb/concepts/Green Suite Blind Spot.md - kb/concepts/Hooks.md - kb/concepts/Hybrid Search.md - kb/concepts/INDEX.md - kb/concepts/Implementation Spectrum.md - kb/concepts/Index Scaling.md - kb/concepts/Issue Label Scheme.md - kb/concepts/Iteration and Cost Limits.md - kb/concepts/KB Migration.md - kb/concepts/KB Stack Versioning.md - kb/concepts/Knowledge Compounding.md - kb/concepts/Knowledge Graph.md - kb/concepts/LLM Wiki Pattern.md - kb/concepts/Lint Workflow.md - kb/concepts/MCP-Leseserver.md - kb/concepts/Mass-Update Gate.md - kb/concepts/Memory Lifecycle.md - kb/concepts/Mesh Sync.md - kb/concepts/Modbus.md - kb/concepts/Multi-Agent Collaboration.md - kb/concepts/Naming Convention Conflict.md - kb/concepts/OKF Compatibility.md - kb/concepts/Optional Instance Context File.md - kb/concepts/Personalization Plane.md - kb/concepts/Privacy and Governance.md - kb/concepts/Procedural Memory.md - kb/concepts/Publish-Remote Gate.md - kb/concepts/Quality Scoring.md - kb/concepts/Quality and Self-Correction.md - kb/concepts/RAG.md - kb/concepts/Reciprocal Rank Fusion.md - kb/concepts/SSD TRIM.md - kb/concepts/Scale Ceiling.md - kb/concepts/Self-Healing.md - kb/concepts/Semantic Lint Automation.md - kb/concepts/Semantic Memory.md - kb/concepts/Session Orientation.md - kb/concepts/Shared vs Private.md - kb/concepts/Split Merge Reclassify.md - kb/concepts/Split Threshold.md - kb/concepts/Structural Enforcement over Documented Rule.md - kb/concepts/Stub Threshold.md - kb/concepts/Supersession.md - kb/concepts/Three-Layer Architecture.md - kb/concepts/Token Economics.md - kb/concepts/Typed Relationships.md - kb/concepts/User Management.md - kb/concepts/Vector Search.md - kb/concepts/Work Coordination.md - kb/concepts/Workflow Extraction.md - kb/concepts/Workflow Orchestration.md - kb/concepts/Working Memory.md - kb/concepts/Write-Once Frontmatter Fields.md - kb/concepts/architectures/Consolidation Tiers.md - kb/concepts/architectures/Context Isolation.md - kb/concepts/architectures/Cross-platform Agent Skills.md - kb/concepts/architectures/Episodic Memory.md - kb/concepts/architectures/Hybrid Search.md - kb/concepts/architectures/Implementation Spectrum.md - kb/concepts/architectures/Knowledge Graph.md - kb/concepts/architectures/LLM Wiki Pattern.md - kb/concepts/architectures/MCP-Leseserver.md - kb/concepts/architectures/Memory Lifecycle.md - kb/concepts/architectures/OKF Compatibility.md - kb/concepts/architectures/Optional Instance Context File.md - kb/concepts/architectures/Personalization Plane.md - kb/concepts/architectures/Procedural Memory.md - kb/concepts/architectures/RAG.md - kb/concepts/architectures/Scale Ceiling.md - kb/concepts/architectures/Semantic Memory.md - kb/concepts/architectures/Three-Layer Architecture.md - kb/concepts/architectures/Token Economics.md - kb/concepts/architectures/Working Memory.md - kb/concepts/decisions/Delete Rather Than Anonymize.md - kb/concepts/decisions/Denylist over Allowlist.md - kb/concepts/decisions/Diff-Reviewable Agent Edits.md - kb/concepts/decisions/Dual Licensing by File Plan.md - kb/concepts/decisions/Issue Label Scheme.md - kb/concepts/decisions/KB Stack Versioning.md - kb/concepts/decisions/Structural Enforcement over Documented Rule.md - kb/concepts/patterns/Audit Trail.md - kb/concepts/patterns/BM25.md - kb/concepts/patterns/Command Round-Trip Integrity.md - kb/concepts/patterns/Confidence Scoring.md - kb/concepts/patterns/Contradiction Resolution.md - kb/concepts/patterns/Entity Extraction.md - kb/concepts/patterns/Filter on Ingest.md - kb/concepts/patterns/Forgetting.md - kb/concepts/patterns/Graph Traversal.md - kb/concepts/patterns/Mesh Sync.md - kb/concepts/patterns/Quality Scoring.md - kb/concepts/patterns/Reciprocal Rank Fusion.md - kb/concepts/patterns/Self-Healing.md - kb/concepts/patterns/Shared vs Private.md - kb/concepts/patterns/Typed Relationships.md - kb/concepts/patterns/Vector Search.md - kb/concepts/patterns/Work Coordination.md - kb/concepts/problems/Ambient Environment Dependency.md - kb/concepts/problems/Detect-Repair Asymmetry.md - kb/concepts/problems/Green Suite Blind Spot.md - kb/concepts/problems/Naming Convention Conflict.md - kb/concepts/problems/Write-Once Frontmatter Fields.md - kb/concepts/protocols/CPPC.md - kb/concepts/protocols/Modbus.md - kb/concepts/protocols/SSD TRIM.md - kb/concepts/workflows/Anti-Cramming Heuristic.md - kb/concepts/workflows/Bulk Operations.md - kb/concepts/workflows/CI Integration.md - kb/concepts/workflows/Checkpoint Audit.md - kb/concepts/workflows/Claude Code Auto Mode.md - kb/concepts/workflows/Content Quality Control.md - kb/concepts/workflows/Crystallization.md - kb/concepts/workflows/Event-Driven Automation.md - kb/concepts/workflows/Hooks.md - kb/concepts/workflows/Index Scaling.md - kb/concepts/workflows/Iteration and Cost Limits.md - kb/concepts/workflows/KB Migration.md - kb/concepts/workflows/Knowledge Compounding.md - kb/concepts/workflows/Lint Workflow.md - kb/concepts/workflows/Mass-Update Gate.md - kb/concepts/workflows/Multi-Agent Collaboration.md - kb/concepts/workflows/Privacy and Governance.md - kb/concepts/workflows/Publish-Remote Gate.md - kb/concepts/workflows/Quality and Self-Correction.md - kb/concepts/workflows/Semantic Lint Automation.md - kb/concepts/workflows/Session Orientation.md - kb/concepts/workflows/Split Merge Reclassify.md - kb/concepts/workflows/Split Threshold.md - kb/concepts/workflows/Stub Threshold.md - kb/concepts/workflows/Supersession.md - kb/concepts/workflows/User Management.md - kb/concepts/workflows/Workflow Extraction.md - kb/concepts/workflows/Workflow Orchestration.md - kb/index.md - kb/log.md - tools/CONTRACT.md - tools/README.md - tools/chemenu/catalog.py - tools/chemenu/commands/index_build.py - tools/chemenu/lint_core.py - tools/chemenu/tests/conftest.py - tools/chemenu/tests/test_cite_cmd.py - tools/chemenu/tests/test_git_publish.py - tools/chemenu/tests/test_index_build.py - tools/chemenu/tests/test_lint.py - tools/chemenu/tests/test_new_page.py - tools/chemenu/tests/test_provenance.py - tools/chemenu/tests/test_type_resolver.py - tools/chemenu/tests/test_xref.py - types/concept.md - types/type-spec.md
2026-09-08 10:07:46 +02:00
parent 63b4bb82d9
commit 7f74303a00
103 changed files with 703 additions and 180 deletions
@@ -0,0 +1,158 @@
+---
+type: types/concept.md
+concept_type: workflow
+tags: [crystallization, knowledge, distillation, workflow]
+created: 2026-07-26
+modified: 2026-08-29
+related:
+  - exemplifies: LLM Wiki Pattern
+  - part-of: Memory Lifecycle
+  - rests-on: Event-Driven Automation
+sources: [Source - LLM Wiki v2]
+confidence: 0.85
+confidence_base: 0.85
+provenance: sourced
+summary: Verdichten abgeschlossener Erkundungen, Debugging-Sitzungen und Recherchen zu strukturierten Wiki-Auszügen als eigenständige Wissensquellen.
+---
+# Crystallization
+
+**Typ:** Arbeitsablauf (Wissensdestillation aus Erkundung)
+
+## Definition
+
+Crystallization ist der Prozess, bei dem eine **abgeschlossene Arbeitskette** (ein Forschungsthread, eine Debug-Sitzung, eine Analyse, eine Erkundung) genommen und **automatisch destilliert** wird in eine strukturierte Zusammenfassung. Das ursprüngliche Muster erwähnt, gute Antworten zurück ins Wiki zu organisieren; Crystallization geht weiter, indem es Erkundungen als erstklassige Quellen behandelt.
+
+## Kernpunkte
+
+### Das Problem
+
+Ohne Crystallization:
+- Wertvolle Erkenntnisse aus Erkundungssitzungen gehen verloren
+- Muster, die durch Debugging oder Forschung entdeckt werden, werden nicht erfasst
+- Jede Erkundung beginnt von vorne
+- Wissen wächst nicht aus abgeschlossener Arbeit
+
+### Die Lösung
+
+**Erkundungen als Quellen** behandeln - genau wie Artikel oder Arbeiten. Das Wiki sollte:
+1. Die Ergebnisse von Erkundungen aufnehmen
+2. Den Wissensgraphen aktualisieren
+3. Bestehende Aussagen stärken oder in Frage stellen
+
+### Crystallization-Prozess
+
+Für eine abgeschlossene Arbeitskette automatisch eine **strukturierte Zusammenfassung** erstellen:
+
+**Zusammenfassungskomponenten:**
+| Komponente | Beschreibung | Beispiel |
+|-----------|-------------|---------|
+| **Frage** | Wie lautete die ursprüngliche Frage/Problem? | "Warum schlägt der Build fehl?" |
+| **Methode** | Welcher Ansatz wurde gewählt? | "Logs verfolgt, Abhängigkeiten überprüft" |
+| **Dateien/Entitäten** | Welche Dateien, Systeme, Entitäten waren beteiligt? | "Dockerfile, build.sh, Jenkins" |
+| **Erkenntnisse** | Was wurde entdeckt? | "Fehlende BuildKit-Abhängigkeit" |
+| **Lektionen** | Welche allgemeinen Lektionen ergaben sich? | "Immer BuildKit-Version überprüfen" |
+| **Ergebnis** | Wie war das Ergebnis? | "Durch Hinzufügen der BuildKit-Abhängigkeit repariert" |
+| **Verwandt** | Links zu verwandten Wiki-Seiten | "[[Docker]], [[Python]]" |
+
+**Ausgabe:** Die Zusammenfassung wird zu einer **erstklassigen Wiki-Seite**, typischerweise in `kb/sources/` oder als Konzept-Seite.
+
+### Was wird kristallisiert
+
+| Arbeitstyp | Crystallization-Ausgabe |
+|-----------|----------------------|
+| Forschungsthread | Forschungsergebnisse-Seite |
+| Debugging-Sitzung | Debug-Analyse-Seite |
+| Analyse | Analyseergebnisse-Seite |
+| Deep Dive | Deep Dive-Zusammenfassung-Seite |
+| Vergleich | Vergleichsseite (siehe Vergleichsseite-Vorlage) |
+
+### Automatisierung
+
+Mit [[Event-Driven Automation]] integrieren:
+
+**Trigger:** Bei Sitzungsende (oder expliziter Crystallization-Befehl)
+
+**Maßnahmen:**
+1. Das Sitzungstranskript/Log analysieren
+2. Schlüsselinformationen extrahieren (Frage, Methode, Erkenntnisse, etc.)
+3. Involvierte Entitäten und Konzepte identifizieren
+4. Strukturierte Zusammenfassung erstellen
+5. Als neue Wiki-Seite organisieren
+6. Verwandte Entitäts-/Konzept-Seiten aktualisieren
+7. `kb/index.md` und `kb/log.md` aktualisieren
+8. Extrahierte Fakten zu angepassten [[Consolidation Tiers]] fördern
+
+## Beispiel
+
+**Sitzung:** Debugging von fehlgeschlagenen CI-Builds
+
+**Crystallized Output:** `kb/sources/debug-ci-build-failure-2026-07-26.md`
+
+```markdown
+# Debug: CI Build Failure - 2026-07-26
+
+**Question:** Why are CI builds failing in the last 24 hours?
+
+**Method:**
+- Checked CI logs for errors
+- Compared failing vs. passing builds
+- Reviewed recent changes
+- Tested locally
+
+**Entities Involved:**
+- [[Docker]]
+- [[Gitea Actions]]
+
+**Findings:**
+- Builds fail with "BuildKit not found" error
+- Recent update to BuildKit version in Dockerfile
+- Actions Cache Server connectivity issue
+
+**Lessons:**
+- Remote BuildKit requires port 1234 to be accessible
+- Actions Cache Server needs host network mode
+- Version mismatches can cause silent failures
+
+**Outcome:** Fixed by updating BuildKit configuration and network settings
+
+**Related:**
+```
+
+## Vorteile
+
+- **Knowledge Compounding:** Erkenntnisse aus Erkundungen werden permanent erfasst
+- **Reduzierte Redundanz:** nicht die gleichen Probleme erneut debuggen
+- **Mustererkennung:** Lektionen entstehen über mehrere Crystallizations
+- **Automatische Dokumentation:** Erkundungen dokumentieren sich selbst
+- **Quellenvielfalt:** Erkundungen sind wertvolle Quellen neben Artikeln
+
+## Wann zu verwenden
+
+- Jedes Wiki, das für Forschung oder Debugging verwendet wird
+- Mehrseissions-Erkundungen
+- Situationen, in denen Erkundungseinsichten wertvoll sind
+- Domänen mit wiederkehrenden Problemen oder Mustern
+
+## Wann NICHT zu verwenden
+
+- Triviale, einmalige Fragen
+- Situationen, in denen der Overhead nicht gerechtfertigt ist
+- Vollständig ad-hoc Erkundung (keine Struktur zum Kristallisieren)
+
+## Verwandte Konzepte
+
+- [[Consolidation Tiers]] - Wo kristallisiertes Wissen befördert wird
+- [[Knowledge Compounding]] - Der Gesamteffekt
+
+## Siehe auch
+
+- [[Implementation Spectrum]] (Crystallization als erweiterte Funktion)
+- [[Quality and Self-Correction]] (Sicherung der Qualität kristallisierten Inhalts)
+
+<!-- wikitool:links -->
+## Beziehungen
+
+- **exemplifies:** [[LLM Wiki Pattern]]
+- **part-of:** [[Memory Lifecycle]]
+- **rests-on:** [[Event-Driven Automation]]
+<!-- /wikitool:links -->