Проект "Реестр": Система памяти с участием человека для AI-агентов в программировании

Проект GitHub под названием project-ledger предоставляет систему с участием человека для управления тем, что ИИ-агенты по программированию запоминают о вашей кодовой базе. Основная проблема, которую он решает: агенты не могут судить о том, что важно — они относятся к ошибкам реализации так же, как к архитектурным недостаткам, и записывают то, что они изменили, а не то, что важно.

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

Система состоит из трех основных компонентов:

• Учетная запись YAML со структурированными записями, содержащими сводки, уровни уверенности, теги и перекрестные ссылки
• Навык /ledger, который публикует записи и автоматически запускает аудитора Haiku для их независимой проверки
• Хук UserPromptSubmit, который выполняет поиск TF-IDF по каждому запросу и автоматически внедряет соответствующие записи перед тем, как агент начнет думать

Хук критически важен — без него вы просто пишете YAML в пустоту. Как отмечено в источнике: «Агенты никогда не читают справочную документацию без запроса — хук запускается при каждом запросе, ищет в учетной записи и внедряет соответствующие записи перед тем, как агент начнет думать.»

Практический пример

Создатель описывает реальный случай использования: через несколько недель после исправления проблемы с отображением цвета во встроенном проекте они спросили агента: «помнишь, что мы делали, когда исправляли это раньше?» Хук вывел точную запись о 8-битной квантизации, искажающей цветопередачу при низких значениях, включая первопричину, пороговые значения и затронутые компоненты.

Сравнение и подход

По сравнению с OpenViking, эта система требует ручной работы, но имеет более простую архитектуру: просто файл YAML плюс хук оболочки без бэкенда. Философия заключается в том, что для проектов, где идеи добываются с трудом, люди должны решать, что передается дальше.

Система предназначена для предотвращения накопления технического долга, когда ИИ-агенты работают в кодовых базах — каждое изменение становится сложнее выполнить правильно без надлежащего контекста о том, что важно.