Opérations de Connaissances
Gérez un système de connaissances multi-couches pour ingérer, organiser, synchroniser et récupérer des connaissances à travers plusieurs magasins.
Privilégiez le modèle d'espace de travail vivant :
- le travail de code vit dans les vrais dépôts clonés
- le contexte d'exécution actif vit dans GitHub, Linear et les fichiers de contexte de travail locaux au dépôt
- les notes humaines plus larges peuvent vivre dans un dossier
context/archivenon lié à un dépôt - la mémoire durable inter-machines appartient à la base de connaissances, pas à un espace de travail de dépôt fantôme
Quand Activer
- L'utilisateur souhaite sauvegarder des informations dans sa base de connaissances
- Ingérer des documents, conversations ou données dans un stockage structuré
- Synchroniser des connaissances entre systèmes (fichiers locaux, mémoire MCP, Supabase, dépôts Git)
- Dédupliquer ou organiser des connaissances existantes
- L'utilisateur dit « sauvegarde ça dans la KB », « synchronise les connaissances », « que sais-je sur X », « ingère ceci », « mets à jour la base de connaissances »
- Toute tâche de gestion de connaissances au-delà d'un simple rappel mémoire
Architecture des Connaissances
Couche 1 : Vérité d'exécution active
- Sources : Issues GitHub, PRs, discussions, notes de version, issues/projets/docs Linear
- Utilisation : l'état opérationnel courant du travail
- Règle : si quelque chose affecte un plan d'ingénierie actif, une feuille de route, un déploiement ou une version, le placer ici en priorité
Couche 2 : Mémoire Claude Code (Accès Rapide)
- Chemin :
~/.claude/projects/*/memory/ - Format : Fichiers Markdown avec frontmatter
- Types : préférences utilisateur, retours, contexte de projet, référence
- Utilisation : contexte à accès rapide qui persiste entre les conversations
- Chargé automatiquement au début de chaque session
Couche 3 : Serveur de Mémoire MCP (Graphe de Connaissances Structuré)
- Accès : outils mémoire MCP (
create_entities,create_relations,add_observations,search_nodes) - Utilisation : recherche sémantique dans toutes les mémoires stockées, cartographie des relations
- Persistance inter-sessions avec une structure de graphe interrogable
Couche 4 : Dépôt de base de connaissances / magasin de documents durables
- Utilisation : notes durables organisées, exportations de sessions, recherche synthétisée, mémoire opérateur, documents longs
- Règle : c'est le magasin durable privilégié pour le contexte inter-machines lorsque le contenu n'est pas du code appartenant à un dépôt
Couche 5 : Magasin de données externe (Supabase, PostgreSQL, etc.)
- Utilisation : données structurées, stockage de documents volumineux, recherche plein texte
- Utile pour : documents trop grands pour les fichiers mémoire, données nécessitant des requêtes SQL
Couche 6 : Dossier d'archives / contexte local
- Utilisation : notes humaines, plans de jeu archivés, organisation de médias locaux, documents temporaires non liés au code
- Règle : accessible en écriture pour le stockage d'informations, mais pas un espace de travail de code fantôme
- Ne pas utiliser pour : les modifications de code actives ou la vérité du dépôt qui devrait vivre en amont
Workflow d'Ingestion
Lorsque de nouvelles connaissances doivent être capturées :
1. Classifier
De quel type de connaissance s'agit-il ?
- Décision métier -> fichier mémoire (type projet) + mémoire MCP
- État actif de la feuille de route / version / implémentation -> GitHub + Linear d'abord
- Préférence personnelle -> fichier mémoire (type utilisateur/retour)
- Information de référence -> fichier mémoire (type référence) + mémoire MCP
- Document volumineux -> magasin de données externe + résumé en mémoire
- Conversation/session -> dépôt de base de connaissances + résumé court en mémoire
2. Dédupliquer
Vérifier si cette connaissance existe déjà :
- Rechercher dans les fichiers mémoire les entrées existantes
- Interroger la mémoire MCP avec des termes pertinents
- Vérifier si l'information existe déjà dans GitHub ou Linear avant de créer une autre note locale
- Ne pas créer de doublons. Mettre à jour les entrées existantes à la place.
3. Stocker
Écrire dans la ou les couches appropriées :
- Toujours mettre à jour la mémoire de Claude Code pour un accès rapide
- Utiliser la mémoire MCP pour la recherche sémantique et la cartographie des relations
- Mettre à jour GitHub / Linear en premier lorsque l'information modifie la vérité vivante du projet
- Commiter dans le dépôt de base de connaissances pour les ajouts durables de longue forme
4. Indexer
Mettre à jour tous les index ou fichiers de résumé pertinents.
Opérations de Synchronisation
Synchronisation des Conversations
Synchroniser périodiquement l'historique des conversations dans la base de connaissances :
- Sources : fichiers de session Claude, sessions Codex, autres sessions d'agents
- Destination : dépôt de base de connaissances
- Générer un index de session pour une navigation rapide
- Commiter et pousser
Synchronisation de l'État de l'Espace de Travail
Miroiter la configuration importante de l'espace de travail et les scripts vers la base de connaissances :
- Générer des cartes de répertoire
- Rédiger les configurations sensibles avant de commiter
- Suivre les changements dans le temps
- Ne pas traiter la base de connaissances ou le dossier d'archives comme l'espace de travail de code vivant
Synchronisation GitHub / Linear
Lorsque l'information affecte l'exécution active :
- mettre à jour l'issue GitHub, la PR, la discussion, les notes de version ou le fil de feuille de route concerné
- attacher des documents de support à Linear lorsque le travail nécessite un contexte de planification durable
- ne miroiter une note locale qu'ensuite, si elle apporte encore une valeur ajoutée
Synchronisation de Connaissances Multi-Sources
Rassembler des connaissances de plusieurs sources en un seul endroit :
- Exportations de conversations Claude/ChatGPT/Grok
- Marque-pages du navigateur
- Événements d'activité GitHub
- Écrire un résumé d'état, commiter et pousser
Modèles de Mémoire
# Court terme : contexte de session courante
Utiliser TodoWrite pour le suivi des tâches en session
# Moyen terme : fichiers mémoire de projet
Écrire dans ~/.claude/projects/*/memory/ pour le rappel inter-session
# Long terme : GitHub / Linear / KB
Placer la vérité d'exécution active dans GitHub + Linear
Placer le contexte durable synthétisé dans le dépôt de base de connaissances
# Couche sémantique : graphe de connaissances MCP
Utiliser mcp__memory__create_entities pour les données structurées permanentes
Utiliser mcp__memory__create_relations pour la cartographie des relations
Utiliser mcp__memory__add_observations pour de nouveaux faits sur des entités connues
Utiliser mcp__memory__search_nodes pour trouver des connaissances existantes
Bonnes Pratiques
- Gardez les fichiers mémoire concis. Archivez les anciennes données plutôt que de laisser les fichiers grossir indéfiniment.
- Utilisez le frontmatter (YAML) pour les métadonnées sur tous les fichiers de connaissances.
- Dédupliquez avant de stocker. Cherchez d'abord, puis créez ou mettez à jour.
- Privilégiez un seul emplacement canonique par ensemble de faits. Évitez les copies parallèles du même plan entre notes locales, fichiers de dépôt et documents de suivi.
- Rédigez les informations sensibles (clés API, mots de passe) avant de les commiter dans Git.
- Utilisez des conventions de nommage cohérentes pour les fichiers de connaissances (minuscules-avec-tirets).
- Étiquetez les entrées avec des sujets/catégories pour une récupération plus facile.
Porte de Qualité
Avant de terminer toute opération de connaissances :
- aucune entrée en double créée
- données sensibles rédigées dans tous les fichiers suivis par Git
- index et résumés mis à jour
- couche de stockage appropriée choisie pour le type de données
- références croisées ajoutées le cas échéant