/forge-memory — FORGE Vector Memory

French Language Rule

Prérequis

bash ~/.claude/scripts/forge-memory/setup.sh

Commandes

Synchroniser l'index

~/.claude/scripts/forge-memory/forge-memory sync [--force] [--verbose]

• Sans

  --force

  : réindexe uniquement les fichiers modifiés (basé sur le hash SHA-256)
• Avec

  --force

  : réindexe tous les fichiers
• Avec

  --verbose

  : affiche le détail de chaque fichier traité

Rechercher

~/.claude/scripts/forge-memory/forge-memory search "query" [--namespace all|project|session|agent] [--agent NAME] [--limit 5] [--threshold 0.3] [--pretty]

• --namespace

  : filtrer par type (project = MEMORY.md, session = logs, agent = mémoires d'agent)

• --agent

  : filtrer par nom d'agent (pm, architect, dev, qa)

• --limit

  : nombre max de résultats (défaut: 5)

• --threshold

  : score minimum (défaut: 0.3)

• --pretty

  : affichage formaté (sinon JSON)

Statut

~/.claude/scripts/forge-memory/forge-memory status [--json]

Réinitialiser

~/.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