Forge: Система памяти для кода Claude, созданная с помощью кода Claude

Что делает Forge

Разработчик использовал Claude Code для создания Forge — инструмента, который решает проблему сессионной памяти Claude Code. Forge представляет собой TypeScript-монорепозиторий из 6 пакетов, функционирующий как MCP-сервер. Он обрабатывает каждый поворот беседы через структурированный конвейер для захвата и сохранения контекста проекта.

Как это работает

Система использует шестиэтапный конвейер:

• Классифицировать — Определяет, является ли утверждение решением, ограничением, отклонением, исследованием, целью, исправлением или шумом.
• Извлечь — Извлекает структурированные данные, включая утверждение, обоснование, категорию и уровень уверенности.
• Моделировать — Записывает в модель проекта с событийным источником (только добавление в SQLite, история никогда не теряется).
• Распространить — Проверяет наличие конфликтов между решениями и ограничениями.
• Показать — Уведомляет о противоречиях с обнаружением состояния потока, чтобы избежать постоянных прерываний.
• Выполнить — Интегрируется с GitHub для создания задач, репозиториев и коммитов на основе решений.

Ключевое правило дизайна, установленное Claude Code: переход решения из состояния «склоняюсь» в «решено» никогда не происходит автоматически. Вы должны явно подтвердить. Тесты обеспечивают соблюдение этого инварианта.

Детали разработки

Сборка включала несколько интересных технических задач:

• Двухэтапный LLM-конвейер — Forge сам вызывает LLM для классификации и извлечения решений из беседы, создавая сценарий, подобный «Началу», где Claude Code пишет код, который вызывает Claude. Подбор промптов для надежной классификации потребовал значительных итераций.
• Реализация событийного источника — Каждое решение, ограничение и отклонение являются событиями только для добавления в SQLite. Ничто не удаляется и не перезаписывается, позволяя воспроизводить всю историю решений.
• Система калибровки доверия — Forge отслеживает, как часто его классификации верны, и корректирует порог прерывания. Если он часто ошибается, он становится тише. Claude Code создал отслеживание уверенности, бюджеты прерываний и обнаружение состояния потока.
• Тестирование — Проект включает 170 тестов в 14 файлах, которые выявили реальные ошибки во время разработки, особенно в логике распространения ограничений.

Интеграция с Cortex

Forge работает в паре с другим инструментом под названием Cortex (также созданным с помощью Claude Code) — графом знаний, который индексирует вашу кодовую базу. Когда оба установлены как MCP-серверы, Forge автоматически запрашивает Cortex во время извлечения. Например, если вы скажете «давайте перейдем на PostgreSQL», Forge проверяет Cortex на наличие существующих ссылок на базы данных, связанных сервисов и шаблонов миграции перед записью решения.

Инструменты дополняют друг друга: Forge знает почему (решения, ограничения, намерения, отклонения), а Cortex знает что (сущности кода, шаблоны, зависимости, архитектура).

Практическое использование

Вы устанавливаете Forge как MCP-сервер в своем проекте, затем общаетесь с Claude Code как обычно. За кулисами Forge классифицирует каждый поворот, извлекает решения и строит постоянную модель. В последующих сессиях Claude Code может проверить forge://brief, чтобы мгновенно увидеть, что было решено, что еще открыто, что было явно отклонено и где есть активные противоречия.