torben
18ae28f918
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.
4.9 KiB
4.9 KiB
type, concept_type, tags, created, modified, related, sources, confidence, confidence_base, provenance, summary
| type | concept_type | tags | created | modified | related | sources | confidence | confidence_base | provenance | summary | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| types/concept.md | workflow |
|
2026-07-26 | 2026-08-29 |
|
|
0.95 | 0.95 | sourced | Ablösen alten Wissens durch neue, widersprechende Information; gibt dem Wiki eine Versionierung mit ausdrücklicher Verknüpfung und Erhalt der Historie. |
Supersession
Typ: Workflow (Knowledge Version Control)
Definition
Supersession ist der Prozess des expliziten Ersetzens alten Wissens durch neues Wissen, wenn die neuen Informationen das Alte widersprechen oder aktualisieren. Es stellt Versionskontrolle für Wissen bereit und stellt sicher, dass das Wiki sich im Laufe der Zeit korrekt entwickelt, ohne historischen Kontext zu verlieren.
Dies ist eine Kernkomponente der Memory Lifecycle-Verwaltung.
Kernpunkte
Das Problem
Ohne Supersession:
- Alte und neue widersprechende Aussagen koexistieren ohne Anzeichen, welche aktuell ist
- Benutzer müssen widersprechende Informationen manuell abgleichen
- Das Wiki wird zum Friedhof veralteter Fakten
- Keine Audit-Trail wie sich Wissen entwickelt hat
Die Lösung
Wenn neue Informationen eine bestehende Aussage widersprechen oder aktualisieren:
- Erstelle die neue Aussage mit aktuellen Informationen
- Verlinke explizit die neue Aussage mit der alten
- Markiere die alte Aussage als supersediert mit:
- Zeitstempel der Supersession
- Referenz auf die ersetzende Aussage
- Bewahrter Inhalt (für historische Referenz)
- Aktualisiere Querverweise um auf die neue Aussage zu zeigen
- Erhöhe Konfidenz der neuen Aussage (erbt von alten + neuen Quellen)
Supersession-Metadaten
Für jede supersedierte Aussage speichern:
superseded_by: [claim_id]
superseded_on: YYYY-MM-DD
supersession_reason: [contradiction|update|correction]
original_content: "..." # Preserved for history
Arten der Supersession
| Typ | Beschreibung | Beispiel |
|---|---|---|
| Widerspruch | Neue Info widerspricht direkt alte | „Port ist 1234" → „Port ist 1235" |
| Aktualisierung | Neue Info macht alte Info veraltet | „Nutzt Python 3.8" → „Nutzt Python 3.11" |
| Korrektur | Alte Info war falsch | „Autor ist X" → „Autor ist Y" |
| Verfeinerung | Neue Info fügt wichtiges Detail hinzu | „Nutzt Redis" → „Nutzt Redis 7.0 für Caching" |
Implementierung
Auslöser
Supersession kann ausgelöst werden durch:
- Manuell: Benutzer markiert alte Aussage explizit als supersediert
- Automatisch: Event-Driven Automation erkennt Widerspruch während Ingest
- Geplant: Periodischer Lint identifiziert veraltete Aussagen
Automatisierungs-Workflow
On new source ingest:
1. Extract claims from new source
2. For each claim:
a. Check for contradictions with existing claims
b. If contradiction found:
i. Calculate confidence of both claims
ii. If new claim has higher confidence:
- Create supersession relationship
- Mark old as superseded
iii. If old claim has higher confidence:
- Flag for human review
iv. If equal confidence:
- Flag for human review
c. If no contradiction, add as new claim
Konfidenz-Vererbung
Wenn Aussage B Aussage A ersetzt:
- Aussage B erbt Konfidenz-Boost von Aussagen A's Quellen (falls immer noch gültig)
- Aussage B's Konfidenz = min(1.0, B_confidence + A_confidence * inheritance_factor)
- Typischer inheritance_factor = 0.3-0.5
Vorteile
- Klarheit: Klare Anzeige von aktuellen vs. historischen Kenntnissen
- Nachverfolgbarkeit: Vollständige Geschichte wie sich Wissen entwickelt hat
- Vertrauen: Benutzer können die Progression des Verständnisses sehen
- Genauigkeit: Alte, falsche Informationen bleiben nicht erhalten
- Wiederherstellung: Kann rollback, wenn Supersession fehlerhaft war
Wann zu verwenden
- Jede faktische Aussage, die sich mit der Zeit ändern kann
- Technische Spezifikationen
- Versionabhängige Informationen
- Zeitkritisches Wissen
- Jeder Bereich mit sich entwickelndem Verständnis
Wann NICHT zu verwenden
- Subjektive Meinungen
- Historische Fakten (als-ist bewahren)
- Definitionen, die sich nicht ändern
Verwandte Concepts
- Memory Lifecycle - Übergeordnetes Concept
- Confidence Scoring - Bestimmt welche Aussage in Widerspruch gewinnt
- Contradiction Resolution - Der Entscheidungsprozess für Supersession
- Knowledge Graph - Struktur zur Verfolgung von Supersession-Beziehungen
- LLM Wiki Pattern - Gesamtes Pattern
Siehe auch
- Event-Driven Automation (für automatisierte Supersession)
- Forgetting (komplementärer Mechanismus)
- Self-Healing (für automatisierte Supersession-Erkennung)
- Audit Trail (zum Nachverfolgen von Supersession-Historie)