torben
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
5.6 KiB
5.6 KiB
type, concept_type, tags, created, modified, related, sources, provenance, summary
| type | concept_type | tags | created | modified | related | sources | provenance | summary | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| types/concept.md | architecture |
|
2026-07-26 | 2026-08-29 |
|
|
sourced | Typisierte Schicht aus Entities und Beziehungen über den Wiki-Seiten, die eine reichere Wissensdarstellung und graphbasierte Abfragen ermöglicht. |
Knowledge Graph
Typ: Architektur (Strukturierte Wissensrepräsentation)
Definition
Ein Knowledge Graph ist eine typisierte, strukturierte Ebene über Wiki-Seiten, die Entities und ihre Beziehungen darstellt. Während das ursprüngliche LLM Wiki Seiten mit Wikilinks verwendet (was funktioniert), erfasst das Hinzufügen einer Knowledge-Graph-Ebene eine reichere Struktur, die bessere Abfrage und Entdeckung ermöglicht.
Dieses Konzept wird in LLM Wiki Pattern v2 als Verbesserung der ursprünglichen flachen Seitenstruktur eingeführt.
Kernpunkte
Was das Original richtig macht
Seiten mit Wikilinks sind:
- Menschenlesbar
- Einfach zu erstellen und zu pflegen
- Gut für Narrativ-Informationen
- Funktionieren gut für kleine bis mittlere Wikis
Was fehlt
Wikilinks allein erfassen nicht:
- Entity-Typen (person, project, concept usw.)
- Beziehungstypen (uses, depends on, contradicts usw.)
- Beziehungssemantik (Richtung, Stärke, Vertrauen)
- Strukturelle Verbindungen, die Keyword-Suche vermisst
Die Knowledge-Graph-Lösung
Der Graph ergänzt (ersetzt nicht) Wiki-Seiten durch:
1. Entity Extraction Bei der Aufnahme einer Quelle strukturierte Entities extrahieren:
- Typen: People, projects, libraries, concepts, files, decisions, systems, tools, technologies
- Attribute: Für jede Entity typspezifische Metadaten speichern
- Beispiele: "React" (type: library), "Auth migration" (type: project), "Sarah" (type: person)
2. Typed Relationships Nicht alle Verbindungen sind gleich. Typisierte Beziehungen mit semantischem Gewicht verwenden:
| Beziehung | Gewicht | Beschreibung |
|---|---|---|
| depends on | Hoch | Funktionale Abhängigkeit |
| uses | Mittel | Tool/Library-Nutzung |
| implements | Hoch | Schnittstellen-/Spec-Implementierung |
| extends | Mittel | Vererbung/Erweiterung |
| replaces | Mittel | Austauschbeziehung |
| conflicts with | Hoch | Inkompatibilität |
| requires | Hoch | Voraussetzung |
| produces | Mittel | Ausgabe/Artefakt |
| consumes | Mittel | Eingabe/Ressource |
| owns | Mittel | Verantwortung |
| maintains | Mittel | Wartungsverantwortung |
| causes | Hoch | Kausalität |
| fixed | Hoch | Behebung |
| supersedes | Hoch | Versionskontrolle für Wissen |
| contradicts | Hoch | Gegensätzliche Aussagen |
| relates to | Niedrig | Allgemeine Beziehung |
3. Graph-Traversal für Abfragen Statt nur Keyword-Suche kann das LLM:
- Bei einem Entity-Knoten beginnen (z. B. Redis)
- Durch Beziehungskanten nach außen gehen
- Alles Nachgelagerte finden (z. B. alle Services, die von Redis abhängen)
- Verbindungen erfassen, die Keyword-Suche vermisst
Beispiel-Abfrage: „Wie wirkt sich ein Redis-Upgrade aus?"
- Bei Redis-Knoten beginnen
- „depends on"-Kanten nach außen folgen
- Finde: Service A, Service B, Service C
- „uses"-Kanten von diesen Services folgen
- Finde: Deployment X, Deployment Y
- Ergebnis: Vollständige Auswirkungsanalyse
Implementierung
Basierend auf Agent Memory und iii Engine:
- Entities extrahieren bei Quellaufnahme
- Im Graph-Datenbank oder strukturiertem Format speichern
- Bidirektionale Links pflegen zwischen Graph-Knoten und Wiki-Seiten
- Graph-Traversal aktivieren für komplexe Abfragen
- Graph visualisieren für menschliches Verständnis
Graph vs. Seiten
| Aspekt | Seiten | Graph |
|---|---|---|
| Zweck | Lesen, Narration | Navigation, Entdeckung |
| Stärke | Menschenlesbar, reichhaltiger Kontext | Maschinenlesbar, präzise Beziehungen |
| Anwendungsfall | Ein Thema verstehen | Verbindungen finden, Auswirkungsanalyse |
| Wartung | LLM schreibt Prosa | LLM extrahiert Struktur |
Best Practice: Beide verwenden. Seiten zum Lesen, Graph zur Navigation und Entdeckung.
Vorteile
- Bessere Abfragen: Verbindungen finden, die Keyword-Suche vermisst
- Auswirkungsanalyse: Abhängigkeiten und Beziehungen nachverfolgen
- Entdeckung: Verwandte Entities automatisch anzeigen
- Präzision: Typisierte Beziehungen sind aussagekräftiger als untypierte Links
- Skalierbarkeit: Graph-Struktur ermöglicht effizientes Traversal
Wann zu verwenden
- Wikis mit >100 Seiten (wo Keyword-Suche zu fehlschlagen beginnt)
- Domänen mit komplexen Beziehungen (Softwaresysteme, Organisationen)
- Situationen, die Auswirkungsanalyse oder Abhängigkeitsverfolgung erfordern
- Multi-Hop-Abfragen (finde X, das sich auf Y bezieht, das sich auf Z bezieht)
Wann NICHT zu verwenden
- Kleine Wikis (<100 Seiten) - Wikilinks könnten ausreichend sein
- Einfache, lineare Wissensbereiche
- Situationen, in denen der Overhead nicht gerechtfertigt ist
Verwandte Concepts
- Agent Memory - Produktionsimplementierung
Siehe auch
- Hybrid Search (nutzt Graph-Traversal als einen Stream)
- Event-Driven Automation (für automatische Graph-Updates)
- Supersession (als Graph-Beziehung verfolgt)
Beziehungen
- exemplifies: LLM Wiki Pattern
- see-also: Memory Lifecycle
- see-also: Entity Extraction
- composition: Typed Relationships
- see-also: Graph Traversal