Forge: Un Sistema de Memoria para Código Claude Construido con Código Claude

Qué hace Forge

Un desarrollador utilizó Claude Code para construir Forge, una herramienta que resuelve el problema de memoria basada en sesiones de Claude Code. Forge es un monorepositorio TypeScript de 6 paquetes que funciona como servidor MCP. Procesa cada turno conversacional a través de una canalización estructurada para capturar y persistir el contexto del proyecto.

Cómo funciona

El sistema utiliza una canalización de seis etapas:

• Clasificar — Determina si una declaración es una decisión, restricción, rechazo, exploración, objetivo, corrección o ruido.
• Extraer — Extrae datos estructurados incluyendo la declaración, racional, categoría y nivel de certeza.
• Modelar — Escribe en un modelo de proyecto basado en eventos (SQLite de solo anexar que nunca pierde historial).
• Propagar — Verifica conflictos entre decisiones y restricciones.
• Superficiar — Notifica sobre tensiones con detección de estado de flujo para evitar interrupciones constantes.
• Ejecutar — Se conecta a GitHub para crear issues, repositorios y especificaciones de commit basadas en decisiones.

Una regla de diseño clave impuesta por Claude Code: una decisión que pasa de "inclinándose" a "decidida" nunca es automática. Debes comprometerte explícitamente. Las pruebas hacen cumplir esta invariante.

Detalles de desarrollo

La construcción involucró varios desafíos técnicos interesantes:

• Canalización de LLM en dos etapas — Forge mismo llama a LLMs para clasificar y extraer decisiones de la conversación, creando un escenario tipo inception donde Claude Code escribe código que llama a Claude. Conseguir prompts correctos para clasificación confiable requirió iteración significativa.
• Implementación de abastecimiento de eventos — Cada decisión, restricción y rechazo es un evento de solo anexar en SQLite. Nada se elimina o sobrescribe, permitiendo reproducir toda la historia de decisiones.
• Sistema de calibración de confianza — Forge rastrea cuán frecuentemente sus clasificaciones son correctas y ajusta su umbral de interrupción. Si ha estado equivocado frecuentemente, se vuelve más silencioso. Claude Code construyó el seguimiento de confianza, presupuestos de interrupción y detección de estado de flujo.
• Pruebas — El proyecto incluye 170 pruebas en 14 archivos de prueba que detectaron errores reales durante el desarrollo, particularmente alrededor de la lógica de propagación de restricciones.

Integración con Cortex

Forge se empareja con otra herramienta llamada Cortex (también construida con Claude Code), un grafo de conocimiento que indexa tu base de código. Cuando ambos están instalados como servidores MCP, Forge consulta automáticamente a Cortex durante la extracción. Por ejemplo, si dices "cambiemos a PostgreSQL", Forge verifica en Cortex referencias de base de datos existentes, servicios relacionados y patrones de migración antes de registrar la decisión.

Las herramientas son complementarias: Forge sabe por qué (decisiones, restricciones, intención, rechazos) mientras Cortex sabe qué (entidades de código, patrones, dependencias, arquitectura).

Uso práctico

Instalas Forge como servidor MCP en tu proyecto, luego hablas con Claude Code normalmente. Entre bastidores, Forge clasifica cada turno, extrae decisiones y construye un modelo persistente. En sesiones posteriores, Claude Code puede verificar forge://brief para ver instantáneamente qué se ha decidido, qué sigue abierto, qué fue explícitamente rechazado y dónde hay tensiones activas.