agenticluke/knowledge-sync-plus

Wissensoperationen

Verwalte Wissen über mehrere Speicher hinweg.

Gib jeder Tatsache ein Hauptzuhause. Andere Speicher können eine kurze Notiz und einen Link zu diesem Zuhause enthalten.

Verwende diese Fertigkeit, wenn

Verwende diese Fertigkeit, wenn der Benutzer:

• Fakten oder Notizen in einer Wissensdatenbank speichern möchte.
• Eine Datei, einen Chat oder einen Datensatz importieren möchte.
• Wissen zwischen Speichern synchronisieren möchte.
• Doppelte Notizen finden oder zusammenführen möchte.
• Nach bekannten Fakten zu einem Thema suchen möchte.
• Eine gemeinsame Quelle der Wahrheit aktualisieren möchte.
• Mehr tun möchte als eine einfache Speichersuche.

Hauptregeln

• Behalte Code-Arbeit im echten geklonten Repository.
• Lege aktuelle Pläne und Arbeitsstatus in GitHub, Linear oder dem Repository ab.
• Lege lange Notizen außerhalb des Code-Repositorys ab, wenn sie nicht zum Code gehören.
• Lege langfristige, geräteübergreifende Notizen in der Wissensdatenbank ab.
• Suche, bevor du erstellst.
• Erstelle keine zwei Hauptkopien derselben Tatsache.
• Führe keine externen Aufrufe durch, es sei denn, der Benutzer fragt danach und das benötigte Tool ist bereits eingerichtet.
• Speichere niemals Schlüssel, Passwörter, Token, Cookies oder private Anmeldedaten.
• Committe oder pushe nicht, es sei denn, der Benutzer fragt danach oder hat diesen Schritt bereits genehmigt.
• Ersetze neuere Fakten nicht durch ältere Notizen.

Speicherschichten

1. Live-Arbeitsquelle

Beispiele:

• GitHub Issues, Pull Requests, Diskussionen und Release-Notizen
• Linear Issues, Projekte und Dokumente
• Dateien im echten Projekt-Repository

Verwende dies für:

• Aktuelle Pläne
• Roadmaps
• Release-Status
• Rollout-Status
• Build- und Code-Arbeit

Wenn eine Tatsache aktive Arbeit ändert, aktualisiere diese Schicht zuerst.

2. Claude Code Memory

Pfad:

~/.claude/projects/*/memory/

Verwende kurze Markdown-Dateien mit YAML-Frontmatter.

Verwende dies für:

• Benutzerentscheidungen
• Benutzerfeedback
• Kleine Projektfakten
• Kurze Referenznotizen
• Fakten, die in späteren Chats benötigt werden

Gehe nicht davon aus, dass dieser Pfad existiert oder geändert werden kann. Überprüfe zuerst.

3. MCP Memory

Häufige Werkzeuge:

• create_entities
• create_relations
• add_observations
• search_nodes

Verwende dies für:

• Benannte Personen, Teams, Werkzeuge und Projekte
• Verbindungen zwischen diesen Elementen
• Fakten, die später leicht durchsuchbar sein sollen

Verwende die genauen Werkzeugnamen des aktuellen MCP-Servers. Wenn kein Memory-Server eingerichtet ist, überspringe diese Schicht und teile dies mit.

4. Wissensdatenbank-Repository

Verwende dies für:

• Langfristige Notizen
• Sitzungsexporte
• Zusammengeführte Recherchen
• Runbooks
• Lange Dokumente

Dies ist der wichtigste geräteübergreifende Speicher für Inhalte, die kein Projektcode sind.

5. Datenspeicher

Beispiele:

• Supabase
• PostgreSQL

Verwende dies für:

• Große Zeilenmengen
• Große Dokumentsammlungen
• Volltextsuche
• Daten, die SQL benötigen

Behalte nur eine kurze Zusammenfassung und eine Datensatz-ID im Speicher.

6. Lokale Notizen und Archiv

Verwende dies für:

• Notizen, die von Personen gelesen werden sollen
• Alte Pläne
• Lokale Medienlisten
• Kurzfristige Nicht-Code-Dateien

Verwende dies nicht als zweites Code-Repository oder als Hauptzuhause für aktuelle Pläne.

Wähle das Hauptzuhause

Verwende diese Anleitung:

Wissenstyp	Hauptzuhause	Optionale Kopie
Aktueller Plan, Release oder Code-Status	GitHub, Linear oder Projekt-Repository	Kurze Speichernnotiz
Geschäftsentscheidung	Projektspeicher oder Wissensdatenbank	MCP Memory
Benutzerentscheidung oder Feedback	Claude Code Memory	MCP Memory
Kleine Referenztatsache	Claude Code Memory	MCP Memory
Große Dokumentsammlung	Datenspeicher oder Wissensdatenbank	Kurze Speicherzusammenfassung
Chat- oder Sitzungsexport	Wissensdatenbank-Repository	Kurze Speicherzusammenfassung
Lokale, kurzfristige Notiz	Lokales Archiv	Keine

Wenn zwei Optionen passen, wähle den Speicher, der die Arbeit besitzt. Füge einen Link vom anderen Speicher hinzu, anstatt den vollständigen Text zu kopieren.

Importschritte

1. Lesen und Sortieren

Finde:

• Die Quelle
• Das Thema
• Das Datum
• Den Eigentümer
• Ob die Fakten aktuell sind
• Ob der Text Geheimnisse enthält
• Das beste Hauptzuhause

Importiere keinen Text, den du nicht lesen oder dem du nicht vertrauen kannst. Markiere unsichere Fakten als unsicher.

2. Suche nach einem Treffer

Vor dem Schreiben:

• Durchsuche Speicherdateien.
• Durchsuche MCP Memory, wenn es eingerichtet ist.
• Durchsuche die Wissensdatenbank.
• Überprüfe GitHub oder Linear, wenn sie die Tatsache besitzen könnten.
• Überprüfe den Zieldatenspeicher, falls verwendet.

Suche nach Thema, Namen, Daten, IDs und Quelllinks.

3. Umgang mit Kopien und Konflikten

Wenn dieselbe Tatsache existiert:

• Aktualisiere den Haupteintrag.
• Füge neue Quelllinks oder Daten hinzu.
• Behalte nützliche Historie.
• Entferne oder markiere veraltete Kopien nur, wenn es sicher ist.

Wenn zwei Quellen widersprechen:

• Rate nicht.
• Behalte beide Behauptungen mit ihren Daten und Quellen.
• Bevorzuge die neuere Quelle nur, wenn sie die Tatsache eindeutig besitzt.
• Frage den Benutzer, wenn die Wahl Arbeit ändert oder Daten entfernt.

4. Speichern

Schreibe nur in Speicher, die im Rahmen und einsatzbereit sind.

• Aktualisiere zuerst die Live-Arbeitsquelle, wenn sich aktive Arbeit ändert.
• Halte Claude Code Memory kurz.
• Verwende MCP Memory für Fakten und Verknüpfungen.
• Lege langen Text in der Wissensdatenbank ab.
• Lege große Datensätze in einem Datenspeicher ab.
• Füge eine Quelle, ein Datum und einen Eigentümer hinzu, wenn bekannt.

Wenn ein Speicher fehlt oder schreibgeschützt ist, speichere dort nichts. Berichte, was nicht getan werden konnte.

5. Aktualisiere Indizes

Aktualisiere alle Themenlisten, Sitzungslisten oder Zusammenfassungsdateien, die zum Auffinden des neuen Eintrags verwendet werden.

Verwende Dateinamen in Kleinbuchstaben und Kebab-Schreibweise, z. B.:

release-plan-2026-05.md

6. Überprüfe das Ergebnis

Lies jeden geänderten Datensatz zurück. Stelle sicher, dass Links, Daten und Namen korrekt sind.

Synchronisationsarbeit

Synchronisiere Chats

Für Claude, Codex oder andere Chatexporte:

1. Entferne Geheimnisse und private Anmeldedaten.
2. Behalte den Quellnamen und das Datum.
3. Speichere den vollständigen Export in der Wissensdatenbank.
4. Füge eine kurze Zusammenfassung zum Speicher hinzu.
5. Aktualisiere den Sitzungsindex.
6. Committe und pushe nur mit Zustimmung des Benutzers.

Synchronisiere Arbeitsbereichszustand

Für wichtige Dateien und Einstellungen:

1. Erstelle eine Ordnerübersicht.
2. Kopiere nur nützliche, nicht geheime Fakten.
3. Entferne Schlüssel, Token, Passwörter, Cookies und private Pfade.
4. Notiere die Quelle und das Datum.
5. Verfolge Änderungen im Laufe der Zeit.

Kopiere keinen gesamten Live-Code-Ordner in ein Archiv.

Synchronisiere GitHub oder Linear

Wenn eine Tatsache aktive Arbeit ändert:

1. Finde das Element, das die Arbeit besitzt.
2. Aktualisiere dieses Element zuerst.
3. Füge bei Bedarf unterstützende Dokumente hinzu.
4. Füge eine lokale Notiz nur hinzu, wenn sie einen Mehrwert bietet.
5. Verlinke die Notiz zurück zum Hauptelement.

Synchronisiere viele Quellen

Für Chats, Lesezeichen, GitHub-Ereignisse oder andere Quellen:

1. Gruppiere Elemente nach Thema.
2. Entferne exakte und nahezu identische Kopien.
3. Behalte Quelllinks und Daten.
4. Schreibe eine klare Statusnotiz.
5. Speichere sie im Hauptzuhause.
6. Committe und pushe nur mit Zustimmung des Benutzers.

Speichermuster

Kurzfristig:
Verwende die aktuelle Aufgabenliste für die Arbeit in diesem Chat.

Mittelfristig:
Verwende kurze Dateien in ~/.claude/projects/*/memory/.

Langfristig:
Verwende GitHub oder Linear für Live-Arbeit.
Verwende die Wissensdatenbank für lange Notizen.

Verknüpfte Fakten:
Verwende MCP Memory für Elemente, Fakten und Verknüpfungen.

Wissensdateiformular

---
title: Release-Plan
type: Projekt
topics:
  - release
  - mobile-app
source: https://example.com/item/123
updated: 2026-05-12
status: aktuell
---

# Release-Plan

Kurze Fakten hier.

## Links

- Hauptarbeitselement: URL oder Dateipfad

Verwende nur Felder, die hilfreich sind. Verwende ein ISO-Datum im Format YYYY-MM-DD. Setze status auf aktuell, veraltet, archiviert oder unklar.

Konkretes Beispiel

Benutzeranfrage:

Speichere dies: Der Start der mobilen App wurde vom 1. Juni auf den 15. Juni verschoben. GitHub Issue 42 ist für den Startplan verantwortlich.

Schritte:

1. Suche nach dem Startplan in GitHub, Speicher, MCP Memory und der Wissensdatenbank.
2. Öffne Issue 42 und überprüfe, ob es das Hauptarbeitselement ist.
3. Falls erlaubt, aktualisiere Issue 42 auf den 15. Juni.
4. Aktualisiere die alte Speichernnotiz anstatt eine neue zu erstellen.
5. Füge eine MCP-Tatsache hinzu, dass das Startdatum der 15. Juni ist, und verknüpfe sie mit Issue 42.
6. Markiere jede 1. Juni-Notiz als veraltet. Behalte sie nur, wenn das alte Datum eine nützliche Historie ist.
7. Lies das gespeicherte Datum und die Links zurück.
8. Berichte über jeden geänderten Speicher und jeden übersprungenen Speicher.

Aktualisiere GitHub nicht, wenn der Benutzer nur eine Überprüfung oder Suche angefordert hat.

Grenzfälle

• Wenn die Quelle kein Datum hat, sage, dass das Datum unbekannt ist.
• Wenn der Eigentümer nicht klar ist, frage vor der Änderung eines Live-Plans.
• Wenn eine Datei zu groß ist, speichere sie in der Wissensdatenbank oder im Datenspeicher und behalte eine kurze Speichernnotiz.
• Wenn zwei Elemente denselben Namen haben, verwende IDs, Links, Eigentümer und Daten, um sie zu unterscheiden.
• Wenn der Inhalt privat sein könnte, speichere so wenig wie nötig.
• Wenn ein Geheimnis gefunden wird, lasse es aus. Kopiere oder drucke es nicht.
• Wenn ein Schreibvorgang teilweise fehlschlägt, behaupte nicht, dass die Synchronisation abgeschlossen ist. Liste auf, was funktioniert hat und was fehlgeschlagen ist.
• Wenn ein Speichervorgang nützliche Historie löschen würde, archiviere sie oder frage zuerst.
• Wenn es kein sicheres Hauptzuhause gibt, frage den Benutzer, wohin es gehen soll.
• Wenn dieselbe Tatsache in zwei Speichern erscheinen muss, behalte den vollständigen Text in einem Speicher. Füge eine kurze Notiz und einen Link im anderen hinzu.

Abschließende Prüfung

Bevor du fertig bist, bestätige:

• Es wurde kein neues Duplikat erstellt.
• Jede Tatsache hat ein Hauptzuhause.
• Alte Fakten wurden aktualisiert oder als veraltet markiert.
• Es wurde kein Geheimnis gespeichert oder gedruckt.
• Daten, Namen, IDs und Links sind korrekt.
• Indizes und Zusammenfassungen sind aktuell.
• Querverweise wurden hinzugefügt, wenn nützlich.
• Alle geänderten Datensätze wurden zurückgelesen.
• Es wurde kein Commit, Push oder externer Schreibvorgang ohne Genehmigung durchgeführt.
• Dem Benutzer wird mitgeteilt, was geändert wurde, was übersprungen wurde und warum.