/forge-memory — FORGE Vector Memory
Outil de diagnostic pour l'index vectoriel de la mémoire FORGE.
Les commandes FORGE utilisent automatiquement la recherche vectorielle ; ce skill est pour le diagnostic et la maintenance.
French Language Rule
All content generated in French MUST use proper accents (é, è, ê, à, ù, ç, ô, î, etc.), follow French grammar rules (agreements, conjugations), and use correct spelling.
Prérequis
Le système doit être installé :
bash
bash ~/.claude/scripts/forge-memory/setup.sh
Commandes
Synchroniser l'index
Synchronise les fichiers Markdown vers la base SQLite :
bash
~/.claude/scripts/forge-memory/forge-memory sync [--force] [--verbose]
- Sans : réindexe uniquement les fichiers modifiés (basé sur le hash SHA-256)
- Avec : réindexe tous les fichiers
- Avec : affiche le détail de chaque fichier traité
Rechercher
Recherche hybride (vectorielle + texte) dans la mémoire :
bash
~/.claude/scripts/forge-memory/forge-memory search "query" [--namespace all|project|session|agent] [--agent NAME] [--limit 5] [--threshold 0.3] [--pretty]
- : filtrer par type (project = MEMORY.md, session = logs, agent = mémoires d'agent)
- : filtrer par nom d'agent (pm, architect, dev, qa)
- : nombre max de résultats (défaut: 5)
- : score minimum (défaut: 0.3)
- : affichage formaté (sinon JSON)
Statut
Affiche les statistiques de l'index :
bash
~/.claude/scripts/forge-memory/forge-memory status [--json]
Réinitialiser
Supprime et recrée la base de données :
bash
~/.claude/scripts/forge-memory/forge-memory reset --confirm
Architecture
.forge/memory/
MEMORY.md <- source de vérité (écrit par les agents)
sessions/YYYY-MM-DD.md <- source de vérité (écrit par les agents)
agents/{agent}.md <- source de vérité (écrit par les agents)
index.sqlite <- index dérivé (synchronisé depuis les .md)
- Synchronisation unidirectionnelle : Markdown -> SQLite
- Auto-sync avant chaque recherche (vérifie les changements)
- Recherche hybride : similarité vectorielle (70%) + FTS5 BM25 (30%)
- Embeddings locaux : sentence-transformers all-MiniLM-L6-v2 (384 dimensions)
- Chunking markdown-aware : ~400 tokens/chunk, 80 tokens overlap