Forge: Ein Speichersystem für Claude Code, erstellt mit Claude Code

Was Forge tut

Ein Entwickler nutzte Claude Code, um Forge zu bauen, ein Tool, das das sitzungsbasierte Gedächtnisproblem von Claude Code löst. Forge ist ein 6-Paket-TypeScript-Monorepo, das als MCP-Server fungiert. Es verarbeitet jeden Gesprächsschritt durch eine strukturierte Pipeline, um Projektkontext zu erfassen und zu speichern.

Wie es funktioniert

Das System verwendet eine sechsstufige Pipeline:

• Klassifizieren — Bestimmt, ob eine Aussage eine Entscheidung, Einschränkung, Ablehnung, Erkundung, Ziel, Korrektur oder Rauschen ist.
• Extrahieren — Zieht strukturierte Daten heraus, einschließlich Aussage, Begründung, Kategorie und Sicherheitsgrad.
• Modellieren — Schreibt in ein event-sourced-Projektmodell (append-only SQLite, das niemals Verlauf verliert).
• Verbreiten — Prüft auf Konflikte zwischen Entscheidungen und Einschränkungen.
• Anzeigen — Benachrichtigt über Spannungen mit Flow-State-Erkennung, um ständige Unterbrechungen zu vermeiden.
• Ausführen — Bindet in GitHub ein, um Issues, Repos und Commit-Spezifikationen basierend auf Entscheidungen zu erstellen.

Eine wichtige Designregel, die von Claude Code durchgesetzt wird: Eine Entscheidung, die von "geneigt" zu "entschieden" wechselt, ist niemals automatisch. Sie müssen explizit committen. Tests erzwingen diese Invariante.

Entwicklungsdetails

Der Aufbau umfasste mehrere interessante technische Herausforderungen:

• Zweistufige LLM-Pipeline — Forge selbst ruft LLMs auf, um Entscheidungen aus Konversationen zu klassifizieren und zu extrahieren, wodurch eine Inception-ähnliche Situation entsteht, in der Claude Code Code schreibt, der Claude aufruft. Das richtige Einstellen von Prompts für zuverlässige Klassifizierung erforderte erhebliche Iteration.
• Event-Sourcing-Implementierung — Jede Entscheidung, Einschränkung und Ablehnung ist ein append-only-Event in SQLite. Nichts wird gelöscht oder überschrieben, was ein Wiedergeben der gesamten Entscheidungshistorie ermöglicht.
• Vertrauenskalibrierungssystem — Forge verfolgt, wie oft seine Klassifizierungen korrekt sind, und passt seine Unterbrechungsschwelle an. Wenn es häufig falsch lag, wird es ruhiger. Claude Code baute die Konfidenzverfolgung, Unterbrechungsbudgets und Flow-State-Erkennung.
• Tests — Das Projekt enthält 170 Tests über 14 Testdateien, die während der Entwicklung echte Fehler aufdeckten, insbesondere rund um die Einschränkungsverbreitungslogik.

Integration mit Cortex

Forge wird mit einem anderen Tool namens Cortex (ebenfalls mit Claude Code gebaut) kombiniert, einem Wissensgraphen, der Ihre Codebasis indiziert. Wenn beide als MCP-Server installiert sind, fragt Forge während der Extraktion automatisch Cortex ab. Zum Beispiel, wenn Sie sagen "lass uns zu PostgreSQL wechseln", prüft Forge Cortex auf vorhandene Datenbankreferenzen, verwandte Dienste und Migrationsmuster, bevor es die Entscheidung aufzeichnet.

Die Tools ergänzen sich: Forge weiß warum (Entscheidungen, Einschränkungen, Absicht, Ablehnungen), während Cortex weiß was (Code-Entitäten, Muster, Abhängigkeiten, Architektur).

Praktische Nutzung

Sie installieren Forge als MCP-Server in Ihrem Projekt und sprechen dann normal mit Claude Code. Im Hintergrund klassifiziert Forge jeden Schritt, extrahiert Entscheidungen und baut ein persistentes Modell. In nachfolgenden Sitzungen kann Claude Code forge://brief überprüfen, um sofort zu sehen, was entschieden wurde, was noch offen ist, was explizit abgelehnt wurde und wo aktive Spannungen bestehen.