Toutes les ressources

Brain · 8 min

Construis ton Second Brain avec Claude Code + Obsidian

Ton IA oublie tout après chaque session. Voici comment lui donner une vraie mémoire en 3 couches qui se cumulent.

Ce qu’il y a dedans

  • 🔴 Le Problème : L'Amnésie de Contexte
  • 🏗️ L'Architecture 3 Couches
  • ⚡ Couche 1 : Session Memory
  • 🔗 Couche 2 : Knowledge Graph

Ton IA oublie tout après chaque session. Voici comment lui donner une vraie mémoire en 3 couches qui se cumulent.


🔴 Le Problème : L'Amnésie de Contexte

Les équipes brûlent 30 à 40 minutes par session Claude à re-expliquer ce qu'elles savaient déjà hier.

C'est une journée de travail entière par semaine. Chaque semaine. Juste à re-expliquer.

Quand les gens disent que l'IA ne peut pas faire du vrai travail, ce qu'ils disent vraiment, c'est qu'ils lui ont donné un mauvais contexte. Chaque session repart de zéro. Ton architecture, tes conversations, le bug que tu as débogué pendant une heure, tout disparaît quand la fenêtre se ferme.

Les symptômes sont prévisibles :

  • Il re-pose des questions auxquelles tu as déjà répondu
  • Il propose des patterns que tu as explicitement rejetés
  • Il oublie les décisions prises trois sessions auparavant
  • Il voit ton codebase comme s'il le voyait pour la première fois
  • Il perd le raisonnement derrière les décisions, pas juste les décisions elles-mêmes

Le fix n'est pas un modèle plus intelligent. C'est donner au modèle un système de mémoire pour qu'il puisse vraiment opérer.


🏗️ L'Architecture 3 Couches

code
┌─────────────────────────────────────────┐
│ Couche 3 : Pipeline d'Ingestion         │
│ vidéo/audio → connaissance structurée   │
├─────────────────────────────────────────┤
│ Couche 2 : Knowledge Graph              │
│ Vault Obsidian + pont MCP               │
├─────────────────────────────────────────┤
│ Couche 1 : Session Memory               │
│ CLAUDE.md + répertoire auto-mémoire     │
└─────────────────────────────────────────┘

La Couche 1 enseigne au modèle qui tu es. La Couche 2 lui donne un cerveau interrogeable. La Couche 3 nourrit ce cerveau depuis le monde réel.

Elles se cumulent. Skip une seule, et les autres dégradent.


⚡ Couche 1 : Session Memory

Tu ne configures pas un outil. Tu enseignes à un collègue ce que tu as déjà décidé.

CLAUDE.md

CLAUDE.md se trouve à la racine de ton projet et c'est la première chose que Claude lit à chaque session. La plupart des gens le traitent comme un fichier de config. Les builders qui obtiennent un output 10x le traitent comme l'onboarding d'une nouvelle recrue qui n'oublie jamais.

Voici le cadrage qui fonctionne :

"Ce vault est ton exosuit. Quand tu rejoins cette session, tu endosses la connaissance accumulée de toute l'opération. Tu n'es pas un assistant. Tu es une force motrice derrière un business qui transforme la connaissance en avantage compétitif."

Ce qui va dans CLAUDE.md :

  • Décisions d'architecture qui ne changent pas chaque semaine
  • Conventions de nommage et patterns de code
  • Préférences de workflow (outils, package managers, frameworks)
  • Limites absolues : ce qu'il ne faut jamais faire
  • Ta façon de penser les problèmes et structurer les solutions
  • Contexte clé sur ton business, tes clients ou ton codebase

Ce qui n'y va pas :

  • Tout ce qui change session après session (mets ça dans les fichiers mémoire)
  • Listes de tâches ou todos
  • Notes brutes ou informations non traitées

Le Répertoire Auto-Mémoire

C'est là que Claude persiste ses observations entre les sessions, les patterns qu'il a remarqués, les solutions qui ont fonctionné, les choses que tu l'as corrigé sur.

code
~/.claude/projects/<project-hash>/memory/
├── MEMORY.md        # document de routage — garde-le sous 200 lignes
├── debugging.md     # solutions aux problèmes récurrents
├── patterns.md      # conventions validées
├── architecture.md  # décisions architecturales clés
└── preferences.md   # tes préférences de workflow

Règle : Garde MEMORY.md sous 200 lignes. C'est un document de routage, pas un dump. Le détail va dans des fichiers thématiques liés depuis MEMORY.md.

Le Rythme de Session

C'est ce qui transforme chaque session en dépôt qui se cumule :

  1. Orient : Claude lit CLAUDE.md et les fichiers mémoire
  2. Work : session normale avec tout le contexte chargé
  3. Persist : Claude écrit ce qu'il a appris dans le fichier mémoire approprié

Skip l'étape persist et le système ne s'améliore jamais.


🔗 Couche 2 : Knowledge Graph

Un vault Obsidian n'est pas une appli de prise de notes. C'est une couche de persistance que ton IA peut interroger en temps réel.

La communauté tools-for-thought a passé des années à comprendre comment structurer la connaissance : notes atomiques, liens bidirectionnels, maps de contenu. Ils ont accidentellement conçu l'architecture parfaite pour les LLMs.

Le pont entre Claude et ton vault, c'est MCP (Model Context Protocol). Deux serveurs font fonctionner ça :

  • smart-connections : recherche sémantique sur tout ton vault. Claude trouve des notes pertinentes même sans connaître le titre exact ou le chemin.
  • qmd : requêtes structurées, gestion de collections, opérations sur les métadonnées. L'outil de précision quand Claude a besoin de notes par chemin ou tag.

Installation

code
# Installer smart-connections MCP
pip install smart-connections-mcp

# Installer qmd MCP
npx -y @tobilu/qmd mcp

Config MCP

Ajoute ça dans tes settings Claude (~/.claude/claude_desktop_config.json) :

code
{
  "mcpServers": {
    "smart-connections": {
      "command": "python",
      "args": ["smart-connections-mcp/server.py"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "~/obsidian/ton-vault"
      }
    },
    "qmd": {
      "command": "qmd",
      "args": ["mcp"],
      "env": { "HOME": "~" }
    },
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp"]
    }
  }
}

Structure du Vault

La structure importe énormément. Un dump de notes non structuré dégrade la récupération rapidement. Utilise quatre niveaux de filtrage pour que Claude trouve la bonne profondeur dès le premier passage :

code
obsidian-vault/
├── 00-home/          # maps of content — table des matières de ton cerveau
│   ├── index.md
│   ├── daily/
│   └── top-of-mind.md
├── atlas/            # vue structurelle de tout
│   ├── projects.md
│   ├── research.md
│   └── vault-information-arch.md
├── inbox/            # captures non traitées — tout atterrit ici d'abord
│   └── queue-generated/
├── knowledge/        # graph de connaissance curé et traité
│   ├── graph/
│   └── memory/
├── sessions/         # transcripts bruts de sessions
└── voice-notes/      # captures vocales transcrites

L'Insight Clé : Prose-as-Title

C'est le changement à plus fort levier que tu peux faire. Nomme tes notes comme des affirmations, pas des catégories.

❌ memory-systems.md

✅ les graphs de mémoire battent les fichiers géants.md

❌ retrieval-notes.md

✅ la récupération hybride surpasse la recherche sémantique pure.md

Quand Claude cherche dans ton vault, les titres des notes seuls lui disent si quelque chose est pertinent avant de lire une seule ligne de contenu.

Wiki-Links comme Prose

Les liens doivent se lire comme des phrases :

code
on a appris que [[les graphs de mémoire battent les fichiers géants]]
quand on [[benchmark la récupération comme une infrastructure de recherche]]

Le graph se documente lui-même. La récupération devient navigation.


🔄 Couche 3 : Pipeline d'Ingestion

Les deux premières couches donnent à Claude un cerveau et un moyen d'y accéder. Mais les cerveaux ont besoin d'être nourris.

La plupart des connaissances ne commencent pas sous forme de texte. Elles commencent comme une vidéo YouTube, une conférence, une note vocale, une réunion client. L'écart entre "j'ai regardé quelque chose d'utile" et "Claude peut le trouver", c'est là où la plupart des connaissances meurent.

Les connaissances les plus dures à capturer ne sont pas dans les documents, elles sont dans la tête des gens. Quand tu choisis PostgreSQL plutôt que MongoDB, peut-être que la décision est écrite. Mais le raisonnement, les compromis que tu as considérés, le contexte qui l'a rendu évident, ça, c'est perdu.

brain-ingest

Une commande ferme l'écart :

code
# Depuis une vidéo YouTube
brain-ingest "https://youtube.com/watch?v=..." --apply

# Depuis un enregistrement local
brain-ingest "/chemin/vers/enregistrement.mp4" --apply

# Depuis un transcript brut
brain-ingest --transcript "/chemin/vers/notes.txt" --title "Call Client — 18 Mars" --apply

Ce qui se passe sous le capot :

  1. Télécharge et transcrit localement, aucune donnée ne quitte ta machine
  2. Extrait les connaissances structurées : claims, frameworks, actions
  3. Génère une note Obsidian avec frontmatter et wiki-links
  4. La dépose dans l'inbox/ de ton vault pour review

Ce que tu obtiens d'une conférence de 90 minutes :

  • 12–18 claims distincts qui méritent d'être préservés
  • 3–5 frameworks ou modèles mentaux nommés
  • 5–8 techniques actionnables
  • 2–4 exemples concrets avec contexte

C'est le matériau qui se cumule quand Claude le récupère six semaines plus tard sur un problème complètement différent.

Pourquoi C'est Important pour les Réunions

Les réunions étaient le gouffre ultime pour la connaissance. Maintenant tu peux enregistrer chaque conversation, lancer brain-ingest sur le transcript, et la connaissance tacite enfermée dans la tête des gens devient un nœud structuré dans ton graph.

Ce n'est pas un résumé de réunion que personne ne lit. C'est une synchronisation active entre ta pensée et sa représentation externalisée.


🔁 Le Graph Auto-Améliorant

C'est la partie qui change tout.

Les agents ne s'ennuient pas de la maintenance. Ils ne sautent pas la mise à jour parce qu'ils sont en retard pour une réunion. Ce qui a tué tous les wikis, c'est exactement pour quoi les agents sont construits.

Avec le temps, le système :

  • Remarque quand deux notes se contredisent et signale la tension
  • Remarque quand la spec est désynchronisée avec le codebase
  • Accumule les signaux de friction automatiquement
  • Propose des changements structurels au système lui-même quand l'architecture crée de la résistance

Il refactorise ses propres instructions. Il fait évoluer sa propre architecture.


⚠️ Erreurs Courantes

Traiter CLAUDE.md comme un fichier de settings. C'est un document d'enseignement. Écris-le comme si tu onboardais quelqu'un qui se souviendra de tout ce que tu lui dis, pour toujours.

Tout mettre dans MEMORY.md. Garde-le sous 200 lignes. C'est un document de routage. Le détail va dans des fichiers thématiques.

Nommer les notes comme des catégories. productivity.md est un cimetière. le travail async bat les réunions synchrones pour le travail profond.md est un claim récupérable.

Skipper l'étape persist. C'est là que la valeur se cumule. Sans ça, la Couche 1 ne s'améliore jamais.

Ne pas nourrir la Couche 3. Le vault ne connaît que ce que tu y mets. Si tu n'ingères pas de nouvelles connaissances, le graph stagne.


✅ Checklist de Setup

Fais ça dans l'ordre. Ne skip pas d'étapes.

  • Créer CLAUDE.md à la racine de ton projet : décisions archi, conventions, limites absolues
  • Activer l'auto-mémoire dans les settings Claude Code
  • Créer ton vault Obsidian avec la structure de dossiers ci-dessus
  • Installer Smart-Connections MCP : pip install smart-connections-mcp
  • Installer qmd MCP : npx -y @tobilu/qmd mcp
  • Ajouter le JSON de config MCP dans tes settings Claude
  • Lancer brain-ingest sur tes 3 sources vidéo/audio les plus précieuses
  • Renommer les notes existantes au format prose-as-title (commence frais, migre progressivement)
  • Établir le rythme de session : orient → work → persist
  • Bloquer une review hebdo de 20 min : traiter l'inbox, revoir les fichiers mémoire, élaguer ce qui est périmé

La première session après le setup se sent différente. Pas parce que Claude est devenu plus intelligent. Parce qu'il a arrêté d'oublier.


Ton IA est déjà un traverseur de graph. La question est de savoir si tu lui as donné un graph qui vaut la peine d'être traversé.

S’inscrire à la newsletter

Pas le temps de tout monter toi-même ?

Je structure ta boîte : systèmes, process et un OS qui fait tourner l’opérationnel sans que tout repasse par toi. On commence par un diagnostic de 45 minutes : on regarde comment ta boîte tourne, ce qui te coûte le plus, et tu repars avec un récap écrit.

ou écris-moi :@capitain.aimaxence@corelabs.studio