agenticluke/knowledge-sync-plus

Opérations de connaissances

Gérez les connaissances sur plusieurs magasins.

Donnez à chaque fait un seul emplacement principal. Les autres magasins peuvent contenir une courte note et un lien vers cet emplacement.

Utilisez cette compétence lorsque

Utilisez cette compétence lorsque l'utilisateur souhaite :

• Enregistrer des faits ou des notes dans une base de connaissances.
• Importer un fichier, une discussion ou un ensemble de données.
• Synchroniser les connaissances entre les magasins.
• Trouver ou fusionner des notes en double.
• Rechercher des faits connus sur un sujet.
• Mettre à jour une source de vérité partagée.
• Faire plus qu'une simple recherche en mémoire.

Règles principales

• Conservez le travail de code dans le vrai dépôt cloné.
• Mettez les plans actifs et l'état du travail dans GitHub, Linear ou le dépôt.
• Mettez les longues notes en dehors du dépôt de code lorsqu'elles n'appartiennent pas au code.
• Mettez les notes à long terme et multi-appareils dans la base de connaissances.
• Cherchez avant de créer.
• Ne faites pas deux copies principales du même fait.
• Ne faites pas d'appels externes sauf si l'utilisateur le demande et que l'outil nécessaire est déjà configuré.
• Ne sauvegardez jamais de clés, mots de passe, jetons, cookies ou données de connexion privées.
• Ne validez ni ne poussez sauf si l'utilisateur le demande ou a déjà approuvé cette étape.
• Ne remplacez pas des faits plus récents par des notes plus anciennes.

Couches de stockage

1. Source de travail en direct

Exemples :

• Problèmes GitHub, demandes de tirage, discussions et notes de version
• Problèmes Linear, projets et documents
• Fichiers dans le vrai dépôt du projet

Utilisez cela pour :

• Plans actuels
• Feuilles de route
• État des versions
• État des déploiements
• Travail de construction et de code

Si un fait modifie le travail actif, mettez à jour cette couche en premier.

2. Mémoire de Claude Code

Chemin :

~/.claude/projects/*/memory/

Utilisez des fichiers Markdown courts avec un frontmatter YAML.

Utilisez cela pour :

• Choix de l'utilisateur
• Retours de l'utilisateur
• Petits faits de projet
• Courtes notes de référence
• Faits nécessaires dans des discussions ultérieures

Ne supposez pas que ce chemin existe ou peut être modifié. Vérifiez d'abord.

3. Mémoire MCP

Outils courants :

• create_entities
• create_relations
• add_observations
• search_nodes

Utilisez cela pour :

• Personnes nommées, équipes, outils et projets
• Liens entre ces éléments
• Faits qui devraient être faciles à rechercher plus tard

Utilisez les noms d'outils exacts du serveur MCP actuel. Si aucun serveur mémoire n'est configuré, sautez cette couche et dites-le.

4. Dépôt de base de connaissances

Utilisez cela pour :

• Notes à long terme
• Exportations de sessions
• Recherche jointe
• Manuels de procédures
• Longs documents

C'est le magasin principal multi-appareils pour le contenu qui n'est pas du code projet.

5. Magasin de données

Exemples :

• Supabase
• PostgreSQL

Utilisez cela pour :

• Grands ensembles de lignes
• Grands ensembles de documents
• Recherche en texte intégral
• Données nécessitant SQL

Conservez seulement un court résumé et un identifiant d'enregistrement en mémoire.

6. Notes locales et archive

Utilisez cela pour :

• Notes à lire par des personnes
• Anciens plans
• Listes de médias locaux
• Fichiers non-code à court terme

N'utilisez pas cela comme un deuxième dépôt de code ou comme l'emplacement principal pour les plans actifs.

Choisissez l'emplacement principal

Utilisez ce guide :

Type de connaissance	Emplacement principal	Copie facultative
Plan actuel, version ou état du code	GitHub, Linear ou dépôt du projet	Courte note mémoire
Choix d'entreprise	Mémoire du projet ou base de connaissances	Mémoire MCP
Choix ou retour utilisateur	Mémoire de Claude Code	Mémoire MCP
Petit fait de référence	Mémoire de Claude Code	Mémoire MCP
Grand ensemble de documents	Magasin de données ou base de connaissances	Court résumé mémoire
Exportation de discussion ou session	Dépôt de base de connaissances	Court résumé mémoire
Note locale à court terme	Archive locale	Aucune

Si deux choix conviennent, choisissez le magasin qui possède le travail. Ajoutez un lien depuis l'autre magasin au lieu de copier le texte complet.

Étapes d'importation

1. Lire et trier

Trouvez :

• La source
• Le sujet
• La date
• Le propriétaire
• Si les faits sont à jour
• Si le texte contient des secrets
• Le meilleur emplacement principal

N'importez pas de texte que vous ne pouvez pas lire ou en lequel vous n'avez pas confiance. Marquez les faits incertains comme incertains.

2. Rechercher une correspondance

Avant d'écrire :

• Recherchez dans les fichiers mémoire.
• Recherchez dans la mémoire MCP lorsqu'elle est configurée.
• Recherchez dans la base de connaissances.
• Vérifiez GitHub ou Linear lorsqu'ils peuvent posséder le fait.
• Vérifiez le magasin de données cible lorsqu'il est utilisé.

Correspondance par sujet, noms, dates, identifiants et liens sources.

3. Gérer les copies et conflits

Si le même fait existe :

• Mettez à jour l'enregistrement principal.
• Ajoutez de nouveaux liens sources ou dates.
• Conservez l'historique utile.
• Supprimez ou marquez les copies obsolètes seulement lorsque c'est sûr.

Si deux sources divergent :

• Ne devinez pas.
• Conservez les deux affirmations avec leurs dates et sources.
• Préférez la source la plus récente seulement lorsqu'elle possède clairement le fait.
• Demandez à l'utilisateur lorsque le choix modifie le travail ou supprime des données.

4. Sauvegarder

Écrivez uniquement dans les magasins qui sont dans le périmètre et prêts à être utilisés.

• Mettez à jour la source de travail en direct en premier lorsque le travail actif change.
• Gardez la mémoire de Claude Code courte.
• Utilisez la mémoire MCP pour les faits et les liens.
• Mettez le texte long dans la base de connaissances.
• Mettez les grands ensembles dans un magasin de données.
• Ajoutez une source, une date et un propriétaire lorsque connus.

Si un magasin est manquant ou en lecture seule, ne sauvegardez rien là-bas. Signalez ce qui n'a pas pu être fait.

5. Mettre à jour les index

Mettez à jour toute liste de sujets, liste de sessions ou fichier de résumé utilisé pour trouver le nouvel élément.

Utilisez des noms de fichiers en kebab-case en minuscules, tels que :

release-plan-2026-05.md

6. Vérifier le résultat

Relisez chaque enregistrement modifié. Assurez-vous que les liens, dates et noms sont corrects.

Travail de synchronisation

Synchroniser les discussions

Pour les exports de discussions Claude, Codex ou autres :

1. Supprimez les secrets et les données de connexion privées.
2. Conservez le nom et la date de la source.
3. Sauvegardez l'export complet dans la base de connaissances.
4. Ajoutez un court résumé en mémoire.
5. Mettez à jour l'index des sessions.
6. Validez et poussez uniquement avec l'approbation de l'utilisateur.

Synchroniser l'état de l'espace de travail

Pour les fichiers et paramètres clés :

1. Faites un plan du dossier.
2. Copiez uniquement les faits utiles et non secrets.
3. Supprimez les clés, jetons, mots de passe, cookies et chemins privés.
4. Notez la source et la date.
5. Suivez les changements au fil du temps.

Ne copiez pas un dossier de code en direct entier dans une archive.

Synchroniser GitHub ou Linear

Lorsqu'un fait modifie le travail actif :

1. Trouvez l'élément qui possède le travail.
2. Mettez à jour cet élément en premier.
3. Ajoutez des documents de support si nécessaire.
4. Ajoutez une note locale seulement si elle apporte une valeur supplémentaire.
5. Liez la note à l'élément principal.

Synchroniser plusieurs sources

Pour les discussions, signets, événements GitHub ou autres sources :

1. Regroupez les éléments par sujet.
2. Supprimez les copies exactes et quasi identiques.
3. Conservez les liens sources et les dates.
4. Écrivez une note d'état claire.
5. Sauvegardez-la dans l'emplacement principal.
6. Validez et poussez uniquement avec l'approbation de l'utilisateur.

Motif de mémoire

Court terme :
Utilisez la liste de tâches actuelle pour le travail dans cette discussion.

Moyen terme :
Utilisez des fichiers courts dans ~/.claude/projects/*/memory/.

Long terme :
Utilisez GitHub ou Linear pour le travail en direct.
Utilisez la base de connaissances pour les longues notes.

Faits liés :
Utilisez la mémoire MCP pour les éléments, faits et liens.

Formulaire de fichier de connaissances

---
title: Plan de version
type: projet
topics:
  - version
  - application-mobile
source: https://example.com/item/123
updated: 2026-05-12
status: actuel
---

# Plan de Version

Les faits courts vont ici.

## Liens

- Élément de travail principal : URL ou chemin de fichier

Utilisez uniquement les champs qui aident. Utilisez une date ISO au format AAAA-MM-JJ. Définissez status sur actuel, obsolète, archivé ou incertain.

Exemple concret

Demande utilisateur :

Sauvegarde ceci : Le lancement de l'application mobile a été déplacé du 1er juin au 15 juin. Le problème GitHub 42 possède le plan de lancement.

Étapes :

1. Recherchez le plan de lancement dans GitHub, la mémoire, la mémoire MCP et la base de connaissances.
2. Ouvrez le problème 42 et vérifiez qu'il est l'élément de travail principal.
3. Si autorisé, mettez à jour le problème 42 au 15 juin.
4. Mettez à jour l'ancienne note mémoire au lieu d'en créer une nouvelle.
5. Ajoutez un fait MCP indiquant que la date de lancement est le 15 juin et liez-le au problème 42.
6. Marquez toute note du 1er juin comme obsolète. Conservez-la seulement si l'ancienne date est un historique utile.
7. Relisez la date et les liens sauvegardés.
8. Signalez chaque magasin modifié et tout magasin ignoré.

Ne mettez pas à jour GitHub si l'utilisateur a seulement demandé une revue ou une recherche.

Cas particuliers

• Si la source n'a pas de date, dites que la date est inconnue.
• Si le propriétaire n'est pas clair, demandez avant de modifier un plan actif.
• Si un fichier est trop volumineux, stockez-le dans la base de connaissances ou le magasin de données et conservez une courte note mémoire.
• Si deux éléments partagent un nom, utilisez des identifiants, liens, propriétaires et dates pour les distinguer.
• Si le contenu peut être privé, sauvegardez le minimum nécessaire.
• Si un secret est trouvé, laissez-le de côté. Ne le copiez ni ne l'imprimez.
• Si une écriture échoue partiellement, ne prétendez pas que la synchronisation est terminée. Listez ce qui a fonctionné et ce qui a échoué.
• Si une sauvegarde supprimerait un historique utile, archivez-la ou demandez d'abord.
• S'il n'y a pas d'emplacement principal sûr, demandez à l'utilisateur où il devrait aller.
• Si le même fait doit apparaître dans deux magasins, conservez le texte complet dans un magasin. Mettez une courte note et un lien dans l'autre.

Vérification finale

Avant de terminer, confirmez :

• Aucun nouveau doublon n'a été créé.
• Chaque fait a un seul emplacement principal.
• Les anciens faits ont été mis à jour ou marqués comme obsolètes.
• Aucun secret n'a été sauvegardé ou imprimé.
• Les dates, noms, identifiants et liens sont corrects.
• Les index et résumés sont à jour.
• Des liens croisés ont été ajoutés lorsque c'était utile.
• Tous les enregistrements modifiés ont été relus.
• Aucun commit, push ou écriture externe n'a eu lieu sans approbation.
• L'utilisateur est informé de ce qui a changé, de ce qui a été ignoré et pourquoi.