Dernière mise à jour :

Mettre en place un LLM Wiki avec Obsidian et un agent de code

Résultat visé

Un coffre Obsidian fonctionnel dans lequel un agent de code IA lit des sources brutes, construit et met à jour un wiki de pages markdown reliées entre elles, en suivant un fichier de règles — une mise en œuvre concrète du pattern LLM Wiki.

Prérequis

Obsidian, une application gratuite de prise de notes en fichiers markdown, disponible sur obsidian.md. Un agent de code IA capable de lire et d'écrire des fichiers sur l'ordinateur — Claude Code, Codex ou un outil équivalent. Obsidian sert de visualisateur (notamment sa vue en graphe, qui rend les connexions visibles) mais n'exécute lui-même aucune opération de lecture, d'extraction ou de rédaction : c'est l'agent de code qui construit le wiki.

Étapes

  1. Créer le coffre et sa structure. Dans Obsidian, créer un nouveau coffre — un dossier. À l'intérieur, créer trois dossiers : raw (sources brutes, lues par l'IA mais jamais modifiées), wiki (les pages construites et maintenues par l'IA), et templates (optionnel, utile seulement pour un usage manuel puisque l'IA génère les pages elle-même).
  2. Écrire le fichier de règles. Déposer un fichier CLAUDE.md à la racine du coffre — lu automatiquement par Claude Code à l'ouverture du projet — structuré en cinq sections : l'objet du wiki (une phrase décrivant son sujet, à personnaliser en premier) ; la structure des dossiers (où sont les sources, où va le wiki) ; le flux d'intégration (lire le document, extraire les concepts clés, créer ou mettre à jour les pages concernées, mettre à jour l'index, journaliser le changement) ; les règles de formatage (résumé en tête de page, chaque affirmation référence sa source, liens vers les concepts liés) ; le comportement de réponse aux questions (consulter le wiki en premier, citer les pages utilisées, signaler l'incertitude).
  3. Déposer une première source. Glisser un document dans raw — un PDF, un article capturé au format markdown via une extension de capture web, une note. Les formats mixtes sont acceptés : un agent de code capable de lire les PDF nativement traite indifféremment PDF, texte et markdown.
  4. Demander l'intégration. Ouvrir l'agent de code dans le dossier du coffre et formuler une consigne du type : « j'ai ajouté une nouvelle source dans le dossier raw, lis-la et mets à jour le wiki. » L'agent lit la source, propose les pages à créer ou à modifier ; une fois le périmètre validé, il les écrit dans wiki.
  5. Ajouter une deuxième source et vérifier la mise à jour croisée. Un nouvel ajout ne se contente pas de créer des pages supplémentaires : les pages déjà créées par la première source sont mises à jour si la nouvelle source les concerne. Une question qui mobilise les deux sources à la fois obtient une réponse construite depuis les pages du wiki, avec citation des pages consultées — pas une nouvelle recherche dans les documents bruts.
  6. Lancer un lint périodique. Demander à l'agent d'auditer l'ensemble du wiki (« lint the wiki »). Le rapport produit signale les contradictions entre pages, les affirmations potentiellement obsolètes, les pages orphelines sans lien entrant, et les concepts mentionnés dans le wiki sans y avoir leur propre page.

Contrôles

La vue en graphe d'Obsidian permet de vérifier visuellement que les nouvelles pages se relient bien aux pages existantes plutôt que de rester isolées. Le rapport de lint sert de contrôle formel : un wiki structurellement sain n'y remonte ni page orpheline, ni lien rompu, ni contradiction non résolue.

Erreurs et récupération

Le wiki n'est fiable que si les sources déposées le sont : un contenu de mauvaise qualité en entrée produit un wiki de mauvaise qualité, quelle que soit la rigueur du fichier de règles. Le pattern est décrit comme fonctionnant surtout à l'échelle personnelle, de l'ordre d'une centaine d'articles ; au-delà, une infrastructure plus lourde qu'un ensemble de fichiers markdown devient nécessaire — voir Recherche vectorielle vs grep+lecture dans un wiki markdown personnel pour le détail de ce seuil. L'IA peut mal catégoriser une information ou établir une relation erronée entre deux pages : c'est précisément ce que le lint périodique est censé détecter, en particulier tôt dans la vie d'un wiki, quand le volume de pages reste encore possible à relire.