Forge : Un système de mémoire pour Claude Code construit avec Claude Code

Ce que fait Forge

Un développeur a utilisé Claude Code pour créer Forge, un outil qui résout le problème de mémoire basée sur les sessions de Claude Code. Forge est un monorepo TypeScript composé de 6 packages qui fonctionne comme un serveur MCP. Il traite chaque tour de conversation à travers un pipeline structuré pour capturer et persister le contexte du projet.

Comment cela fonctionne

Le système utilise un pipeline en six étapes :

• Classer — Détermine si une déclaration est une décision, une contrainte, un rejet, une exploration, un objectif, une correction ou du bruit.
• Extraire — Extrait des données structurées incluant la déclaration, la justification, la catégorie et le niveau de certitude.
• Modéliser — Écrit dans un modèle de projet basé sur les événements (SQLite en ajout uniquement qui ne perd jamais l'historique).
• Propager — Vérifie les conflits entre les décisions et les contraintes.
• Surfacer — Notifie des tensions avec détection de l'état de flux pour éviter les interruptions constantes.
• Exécuter — S'intègre à GitHub pour créer des issues, des dépôts et des spécifications de commit basées sur les décisions.

Une règle de conception clé imposée par Claude Code : une décision passant de "en réflexion" à "décidée" n'est jamais automatique. Vous devez explicitement la valider. Des tests font respecter cette invariante.

Détails de développement

La construction a impliqué plusieurs défis techniques intéressants :

• Pipeline LLM en deux étapes — Forge lui-même appelle des LLM pour classer et extraire les décisions de la conversation, créant un scénario d'inception où Claude Code écrit du code qui appelle Claude. Obtenir les prompts corrects pour une classification fiable a nécessité une itération significative.
• Implémentation de l'approche événementielle — Chaque décision, contrainte et rejet est un événement en ajout uniquement dans SQLite. Rien n'est supprimé ou écrasé, permettant de rejouer l'historique complet des décisions.
• Système de calibration de confiance — Forge suit la fréquence à laquelle ses classifications sont correctes et ajuste son seuil d'interruption. S'il s'est trompé fréquemment, il devient plus silencieux. Claude Code a construit le suivi de confiance, les budgets d'interruption et la détection de l'état de flux.
• Tests — Le projet inclut 170 tests répartis dans 14 fichiers de test qui ont détecté de vrais bugs pendant le développement, particulièrement autour de la logique de propagation des contraintes.

Intégration avec Cortex

Forge s'associe à un autre outil appelé Cortex (également construit avec Claude Code), un graphe de connaissances qui indexe votre base de code. Lorsque les deux sont installés comme serveurs MCP, Forge interroge automatiquement Cortex pendant l'extraction. Par exemple, si vous dites "passons à PostgreSQL", Forge vérifie dans Cortex les références de base de données existantes, les services associés et les modèles de migration avant d'enregistrer la décision.

Les outils sont complémentaires : Forge sait pourquoi (décisions, contraintes, intentions, rejets) tandis que Cortex sait quoi (entités de code, modèles, dépendances, architecture).

Utilisation pratique

Vous installez Forge comme serveur MCP dans votre projet, puis parlez normalement à Claude Code. En arrière-plan, Forge classe chaque tour, extrait les décisions et construit un modèle persistant. Dans les sessions suivantes, Claude Code peut vérifier forge://brief pour voir instantanément ce qui a été décidé, ce qui est encore ouvert, ce qui a été explicitement rejeté et où se trouvent les tensions actives.