Agent Docs for Markdown – l’extension VS Code qui transforme du Markdown local en wiki LLM pour agents IA

Ces derniers temps, on voit de plus en plus apparaître une tendance à gérer, sous forme de Markdown et de fichiers, les connaissances utilisées par les agents IA, comme avec les LLM Wiki, le Knowledge as Code ou le Context Engineering.

Même si les performances des LLM s’améliorent, si l’agent ne sait pas quels documents lire en premier, lequel fait référence, ou quels documents vérifier ensemble lors d’une modification, les résultats deviennent facilement instables.

J’ai moi aussi rencontré un problème similaire en gérant en Markdown des notes de recherche, de la documentation technique, un wiki et des rapports.

Les fichiers Markdown s’accumulaient, mais quand j’ouvrais simplement le dossier à un agent IA, les problèmes suivants apparaissaient.

• Des documents liés entre eux étaient ignorés
• Il était difficile de déterminer, parmi des documents similaires, lequel faisait office de document de référence
• Les liens cassés et les documents isolés étaient utilisés tels quels
• Les artefacts de build et les fichiers de configuration des agents étaient aussi inclus dans la recherche
• Après modification d’un document, le contenu des documents liés divergeait

J’ai donc créé Agent Docs for Markdown, une extension VS Code qui organise un dossier Markdown local sous la forme d’un LLM Wiki compréhensible par les agents IA.

L’objectif n’est pas simplement de rechercher ou de prévisualiser du Markdown, mais de gérer à la fois les relations entre les documents et le flux de travail de l’agent.

Voici les principales fonctionnalités.

• Indexation des documents Markdown et de leurs liens dans un Source Graph
• Exploration Focus / Hop pour étendre les documents liés à partir d’un document donné
• Workspace Cleanup Audit pour détecter les liens cassés, les documents isolés, les artefacts dupliqués et les candidats à exclure de la recherche
• Installation de skills d’agent dédiés au Markdown pour Claude, Codex, Gemini, Cursor, etc.
• Export du Markdown en HTML autonome et en HTML pour blog
• Gestion locale de tous les index et documents dans le workspace

Les skills fournis ont été simplifiés en deux rôles.

• markdown-manager
  Recherche de documents, exploration du Source Graph, vérification des liens, identification du document de référence et contrôle du périmètre d’impact des modifications.

• markdown-writer
  Réorganisation de notes de recherche en rapport ou article de blog, puis vérification du rendu avant export HTML.

Par exemple, vous pouvez demander à l’agent ce qui suit.

« Avant de modifier ce document, indique-moi le périmètre des mises à jour à vérifier avec les documents liés. »

« Dans ce workspace Markdown, trouve les liens cassés, les documents isolés et les dossiers à exclure de la recherche. »

« Réorganise cette note de recherche sous la forme d’un rapport de direction et vérifie aussi le rendu HTML. »

Il suffit d’ouvrir un dossier Markdown existant dans VS Code, puis de générer le Source Graph depuis la barre latérale Agent Docs pour l’essayer immédiatement.

J’aimerais recueillir les retours de celles et ceux qui souhaitent faire d’un dossier Markdown non pas un simple dépôt documentaire, mais un wiki LLM local que les humains et les agents IA peuvent lire et mettre à jour ensemble.

GitHub:
https://github.com/sungreong/agent-docs-for-markdown