QMD : Bibliothèque personnelle de concepts et recherche
QMD (Quick Markdown Search) est un moteur de recherche sémantique local conçu pour vos notes personnelles en Markdown, vos jardins conceptuels et vos archives de recherche. Alors que la recherche de code cible des lignes précises, QMD retrouve les principes architecturaux réutilisables, les théories et les leçons tirées du passé.
La métaphore de l'archiviste de recherche : Pourquoi QMD existe ?
Pour comprendre l'utilité de QMD, observez la répartition des rôles :
Basic Memoryest le post-it sur l'écran : il fixe les consignes immédiates du projet en cours (« Ne pas toucher à la production, garder ce script minimal »).zvec-grepest le pointeur de code : il donne les numéros de ligne exacts (« Où se trouve la fonction de calcul des frais ? »).QMDest votre archiviste personnel : face à un défi d'architecture complexe — comme « Comment isoler la recherche quantitative de la production ? » ou « Quels sont les patrons éprouvés de synchronisation hors-ligne ? » —, vous ne souhaitez ni que l'IA improvise, ni réinventer la roue.
Le problème : Tomber deux fois dans le même piège
Sans bibliothèque conceptuelle :
- Vous passez des mois à résoudre un problème complexe sur le Projet A ;
- Six mois plus tard, vous démarrez le Projet B et rencontrez un cas similaire ;
- L'assistant IA n'ayant aucun souvenir du Projet A, il vous propose une solution naïve et vouée à l'échec, vous forçant à refaire les mêmes erreurs.
QMD élimine ce gaspillage. En posant une question en langage naturel, vous retrouvez en une seconde vos notes conceptuelles validées pour ancrer l'IA dans vos méthodes éprouvées.
Le fonctionnement de QMD
| Dimension | QMD (Archives conceptuelles) | zvec-grep (Radar de code) | Basic Memory (Règles fondamentales) |
|---|---|---|---|
| Contenu stocké | Principes d'architecture, théories, notes de recherche | Fonctions, classes et sections de code source | Objectifs actifs du projet, lignes rouges, limites |
| Cible explorée | Archives Markdown transversales (knowledge/) | Fichiers sources du projet actif (.py, .ts, docs) | Note unique d'alignement par tâche |
| Taille lue | Section conceptuelle complète (~1 000 mots) | Coordonnées et signatures de lignes (~80 mots) | Contraintes résumées (~1 500 mots) |
| Bénéfice majeur | Évite la répétition des erreurs passées | Évite la saturation de mémoire lors des correctifs | Empêche l'IA de dériver et de sur-abstraire |
Commandes essentielles
1. Requête conceptuelle intelligente (Recommandé)
qmd query "quantitative research production isolation" -c pkls-concepts
2. Recherche rapide par mot-clé
qmd search "FIFO execution" -c pkls-concepts
3. Consultation ciblée d'une note
qmd get qmd://pkls-concepts/quant/portfolio-lifecycle.md
Écosystème associé
- Vue d'ensemble : Mémoire des agents et récupération hiérarchique — La place de QMD au niveau 1 (Jardin de concepts du domaine).
- Consignes de projet : Basic Memory — Le gardien des décisions immédiates qui encadre le projet.
- Localisateur de code : zvec-grep (zg) — Le radar qui pointe les lignes de code une fois l'architecture comprise.
Ressources officielles et références
- Dépôt GitHub : tobi/qmd
- Paquet officiel NPM : @tobilu/qmd