54d9540c08
Files changed: - .wikitool-kb.json - AGENTS.md - CHANGES.md - INSTALL-MCP.md - INSTALL.md - README.md - VERSION - instructions/capture-session.md - instructions/dev/issue-tracking.md - instructions/german-terminology.md - instructions/kb-profiles.md - instructions/migrate-corpus.md - instructions/migrations/5.0.0-confidence-removal.md - instructions/private-instance.md - instructions/setup-instance.md - instructions/wiki-lint/SKILL.md - instructions/wiki-manage/SKILL.md - instructions/wiki-query/SKILL.md - kb/CONTRACT.md - kb/CONVENTIONS.md - kb/CONVENTIONS.md.template - 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/entities/people/Andrej Karpathy.md - kb/entities/people/E3DC GmbH.md - kb/entities/people/Rohit Gupta.md - kb/entities/people/Vannevar Bush.md - kb/entities/projects/BCDModule.md - kb/entities/projects/Chemenu.md - kb/entities/projects/andybalholm-edl.md - kb/entities/projects/goresponsiveness.md - kb/entities/projects/ha-core.md - kb/entities/projects/hacs-e3dc.md - kb/entities/projects/hacs-integration-blueprint.md - kb/entities/projects/llm-wiki-skills.md - kb/entities/projects/plugnburn-edl.md - kb/entities/projects/wiki-skills-vanillaflava.md - kb/entities/projects/wiki-skills.md - kb/entities/systems/AGENTS.md.md - kb/entities/systems/CLAUDE.md.md - kb/entities/systems/E3DC.md - kb/entities/systems/ENVIRONMENT.md.md - kb/entities/systems/Memex.md - kb/entities/systems/Tolkien Gateway.md - kb/entities/technologies/Arch Linux.md - kb/entities/technologies/Disk Encryption.md - kb/entities/technologies/Docker.md - kb/entities/technologies/GRUB.md - kb/entities/technologies/Gitea Actions.md - kb/entities/technologies/Gitea.md - kb/entities/technologies/Go.md - kb/entities/technologies/Home Assistant.md - kb/entities/technologies/Kernel PM Governors.md - kb/entities/technologies/LVM.md - kb/entities/technologies/Linux Kernel.md - kb/entities/technologies/MQTT.md - kb/entities/technologies/OPC UA.md - kb/entities/technologies/Python.md - kb/entities/technologies/Rust.md - kb/entities/technologies/Wine GE.md - kb/entities/technologies/Wine-Staging.md - kb/entities/technologies/acpi-cpufreq.md - kb/entities/technologies/amd-pstate.md - kb/entities/technologies/iii Engine.md - kb/entities/tools/AUR.md - kb/entities/tools/Act Runner.md - kb/entities/tools/Agent Memory.md - kb/entities/tools/Aura.md - kb/entities/tools/Bottles.md - kb/entities/tools/ChatGPT.md - kb/entities/tools/Claude Code.md - kb/entities/tools/Codex CLI.md - kb/entities/tools/Dataview.md - kb/entities/tools/GPG.md - kb/entities/tools/GitHub Copilot.md - kb/entities/tools/Gitea MCP Server.md - kb/entities/tools/Lutris.md - kb/entities/tools/Marp.md - kb/entities/tools/Mistral Vibe.md - kb/entities/tools/NotebookLM.md - kb/entities/tools/Obsidian Web Clipper.md - kb/entities/tools/Obsidian.md - kb/entities/tools/OpenAI Codex.md - kb/entities/tools/OpenCode.md - kb/entities/tools/Pi.md - kb/entities/tools/Proton.md - kb/entities/tools/Steam.md - kb/entities/tools/Wine.md - kb/entities/tools/awesome-llm-wiki.md - kb/entities/tools/farzaa gist.md - kb/entities/tools/gdeploy.md - kb/entities/tools/makepkg.md - kb/entities/tools/pascalandy schema.md - kb/entities/tools/qmd.md - kb/entities/tools/wikitool.md - kb/index.md - kb/log.md - raw/CONTRACT.md - tools/CONTRACT.md - tools/README.md - tools/chemenu/api.py - tools/chemenu/cli.py - tools/chemenu/commands/confidence_decay.py - tools/chemenu/commands/docs_verify.py - tools/chemenu/commands/doctor.py - tools/chemenu/commands/index_build.py - tools/chemenu/commands/new_page.py - tools/chemenu/commands/search.py - tools/chemenu/commands/touch.py - tools/chemenu/commands/version_cmd.py - tools/chemenu/conventions.py - tools/chemenu/corpus_diff.py - tools/chemenu/frontmatter_io.py - tools/chemenu/lint_core.py - tools/chemenu/mcp/server.py - tools/chemenu/page.py - tools/chemenu/search/base.py - tools/chemenu/search/filters.py - tools/chemenu/search/ripgrep.py - tools/chemenu/search/service.py - tools/chemenu/search/types.py - tools/chemenu/tests/conftest.py - tools/chemenu/tests/test_api.py - tools/chemenu/tests/test_confidence_decay.py - tools/chemenu/tests/test_corpus_diff.py - tools/chemenu/tests/test_docs_verify.py - tools/chemenu/tests/test_frontmatter_io.py - tools/chemenu/tests/test_index_build.py - tools/chemenu/tests/test_kb_scan.py - tools/chemenu/tests/test_lint.py - tools/chemenu/tests/test_mcp_server.py - tools/chemenu/tests/test_new_page.py - tools/chemenu/tests/test_page_ops.py - tools/chemenu/tests/test_provenance.py - tools/chemenu/tests/test_raw_cmd.py - tools/chemenu/tests/test_search.py - tools/chemenu/tests/test_touch.py - tools/chemenu/tests/test_type_resolver.py - tools/chemenu/tests/test_version_cmd.py - tools/chemenu/tests/test_xref.py - tools/chemenu/version.py - types/concept.md - types/concept.schema.yaml - types/entity.md - types/entity.schema.yaml - types/instruction.md - types/type-spec.md
157 lines
5.5 KiB
Markdown
157 lines
5.5 KiB
Markdown
---
|
|
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]
|
|
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 -->
|