Перейти к содержанию

Память: что хранит репозиторий и для чего внешняя память

Для кого? Для того, кто подключает агенту долговременную память — MCP-сервер памяти, векторное хранилище, файл заметок вне репозитория. Когда читать? До того, как сохранён первый факт, чтобы память не стала второй, непроверяемой копией состояния репозитория. Как работа делится между агентами — «Маршрутизация работы».


Источник истины — репозиторий

Что за работа, докуда она дошла и что решено — живёт в репозитории, там, где это видят проверки:

Вопрос Где живёт Что проверяет
Что в работе и что дальше? specs/TRACKS.md, handoff.md каждой полосы harnessimo tracks
Докуда дошла прошлая сессия? .harness/4-state/PROGRESS.md harnessimo clean-exit
Что решено и почему? .harness/4-state/DECISIONS.md ревью
Задача правда сделана? очередь, proof-маркеры harnessimo queue, harnessimo tasks

harnessimo brief отдаёт всё это новой сессии на старте. Внешняя память, отвечающая на те же вопросы, — второй источник истины, и они разойдутся в тот день, когда обновят одно без другого.

Для чего внешняя память

Для того, что переходит границу одного репозитория или одного checkout:

  • Предпочтения владельца — «светлая тема по умолчанию», «отчёты на русском», «спрашивать перед force-push».
  • Обобщаемые уроки — «свежему worktree нужна установка до первого коммита», «gate через tail прячет код выхода».
  • Указатели, а не копии — «инварианты резервирования — в docs/PRD.md §6 проекта X».

Паттерн чекпойнта

Сохранять в конце куска работы, а не непрерывно, и сохранять атомарные факты, а не дневники:

  1. На чекпойнте — конец хода, влитый поток, вердикт гейта — спросить: узнала ли эта сессия что-то, что понадобится будущей сессии в другом репозитории?
  2. Если да — один факт на запись, с областью (этот владелец, этот проект, везде) и датой. Сначала поискать дубликат и обновить его, а не добавлять второй.
  3. Всё о собственном состоянии этого репозитория идёт в PROGRESS.md, DECISIONS.md или handoff — в памяти может лежать указатель на них.

Напоминание может нести Stop hook: gate запускает harnessimo check; вторая команда рядом может печатать вопрос чекпойнта. Пусть это будет вопрос, а не автоматический сброс — память, забитая стенограммами, это память, в которой никто ничего не найдёт.

Пример: MemPalace

MemPalace — MCP-сервер памяти: агент обращается к нему через инструменты вроде поиска, проверки на дубликат перед сохранением, «ящика» (drawer) для одной записи и графа знаний из фактов. По схеме выше:

  • на старте сессии — поиск предпочтений владельца и уроков по текущей задаче — после harnessimo brief, а не вместо него;
  • на чекпойнте — проверка на дубликат, затем сохранить один факт или обновить существующий;
  • состояние проекта туда не класть: ящик «полоса 0007 сделана наполовину» завтра устареет, а handoff, где это написано, проверяется сегодня.

Ничто в этом пакете не зависит ни от MemPalace, ни от какого-либо сервера памяти. С любым из них — или с обычным файлом вне репозитория — паттерн тот же.

Чему там не место никогда

  • Секретам — токенам, ключам, паролям, строкам подключения. Память читается обратно в промпты, логи и другие проекты.
  • Непроверенным утверждениям — «тесты проходят», «это починено». У утверждения в памяти нет proof-маркера, и никакая проверка его не перезапускает; ему будут верить ещё долго после того, как оно перестало быть правдой.
  • Состоянию репозитория — прогрессу, открытым задачам, решениям. Им место там, где проверки.