Память: что хранит репозиторий и для чего внешняя память
Для кого? Для того, кто подключает агенту долговременную память — 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».
Паттерн чекпойнта
Сохранять в конце куска работы, а не непрерывно, и сохранять атомарные факты, а не дневники:
- На чекпойнте — конец хода, влитый поток, вердикт гейта — спросить: узнала ли эта сессия что-то, что понадобится будущей сессии в другом репозитории?
- Если да — один факт на запись, с областью (этот владелец, этот проект, везде) и датой. Сначала поискать дубликат и обновить его, а не добавлять второй.
- Всё о собственном состоянии этого репозитория идёт в
PROGRESS.md,DECISIONS.mdили handoff — в памяти может лежать указатель на них.
Напоминание может нести Stop hook: gate запускает harnessimo check; вторая команда рядом
может печатать вопрос чекпойнта. Пусть это будет вопрос, а не автоматический сброс — память,
забитая стенограммами, это память, в которой никто ничего не найдёт.
Пример: MemPalace
MemPalace — MCP-сервер памяти: агент обращается к нему через инструменты вроде поиска, проверки на дубликат перед сохранением, «ящика» (drawer) для одной записи и графа знаний из фактов. По схеме выше:
- на старте сессии — поиск предпочтений владельца и уроков по текущей задаче — после
harnessimo brief, а не вместо него; - на чекпойнте — проверка на дубликат, затем сохранить один факт или обновить существующий;
- состояние проекта туда не класть: ящик «полоса 0007 сделана наполовину» завтра устареет, а handoff, где это написано, проверяется сегодня.
Ничто в этом пакете не зависит ни от MemPalace, ни от какого-либо сервера памяти. С любым из них — или с обычным файлом вне репозитория — паттерн тот же.
Чему там не место никогда
- Секретам — токенам, ключам, паролям, строкам подключения. Память читается обратно в промпты, логи и другие проекты.
- Непроверенным утверждениям — «тесты проходят», «это починено». У утверждения в памяти нет proof-маркера, и никакая проверка его не перезапускает; ему будут верить ещё долго после того, как оно перестало быть правдой.
- Состоянию репозитория — прогрессу, открытым задачам, решениям. Им место там, где проверки.