# Общая память для ИИ-агентов кода: мозг проекта

URL: https://agentvera.dev/ru/blog/shared-memory-for-ai-coding-agents/ · Опубликовано: 2026-10-24

Общая память для ИИ-агентов кода: как Brain хранит решения, правки и заметки о передаче, чтобы каждая новая сессия Claude Code или Codex начиналась с контекстом.

**Коротко:**

- Каждая новая сессия агента начинается с чистого листа. Общая память проекта хранит решения, правки и заметки о передаче, чтобы следующий агент не повторял старых ошибок и не пересматривал решённое.
- Brain в AgentVera строит память из ваших документов, коммитов, PR, issue и прошлых диалогов агентов и помечает каждое решение как current, stale или superseded.
- Агенты читают и пишут её через MCP: brain_recall ищет по памяти, brain_remember сохраняет правку или решение, а короткие заметки о передаче остаются после ходов и при сжатии.

**Общая память для ИИ-агентов кода — это хранилище решений, правок и заметок о передаче на уровне проекта: каждый агент читает его в начале и дополняет по ходу работы, поэтому новая сессия не начинается с нуля.** Без неё каждая сессия Claude Code или Codex знает только то, что есть в репозитории и файлах инструкций. С ней следующий агент знает, почему вы выбрали JWT, что пользователь уже сказал «никаких новых зависимостей» и что прошлый агент оставил поток возвратов недоделанным.

В статье объясняется, почему агенты забывают, что должно жить в общей памяти и как Brain в AgentVera строит её из истории проекта и позволяет агентам читать и писать её через MCP.

## Почему кодинг-агенты забывают

Память кодинг-агента — его контекстное окно. Когда сессия заканчивается или диалог сжимается, большая часть произошедшего пропадает. Следующая сессия получает:

- Системный промпт и описания инструментов
- Ваши файлы инструкций, такие как `CLAUDE.md` или `AGENTS.md`
- Всё, что она прочтёт в репозитории во время задачи

Для кода этого достаточно, потому что код лежит в репозитории. Для причин не хватает. Коммит говорит, *что* изменилось; причина часто живёт в комментарии к PR, в issue или в диалоге с агентом, которого уже нет. Поэтому агенты задают одни и те же вопросы, предлагают подход, который вы отвергли на прошлой неделе, и переделывают работу, которую другой агент уже закончил. Когда вы [запускаете несколько агентов параллельно](/ru/blog/run-multiple-claude-code-agents/ "Несколько агентов Claude Code"), становится хуже: каждый узнаёт то, чего остальные никогда не увидят.

## Что должно быть в общей памяти

У файлов инструкций и общей памяти разные задачи.

| | Файл инструкций (CLAUDE.md, AGENTS.md) | Общая память |
| --- | --- | --- |
| Кто пишет | Вы, вручную | Строится из истории, плюс агенты по ходу работы |
| Содержание | Правила, команды, соглашения | Решения с причинами, правки, заметки о передаче |
| Как меняется | Редко | Каждый день |
| Как загружается | Весь файл, каждую сессию | Ищется по необходимости, короткая сводка в начале |
| Знает, что устарело | Нет | Может помечать решения как stale или superseded |

Держите файл инструкций коротким и стабильным ([как его написать](/ru/blog/claude-md-agents-md/ "CLAUDE.md и AGENTS.md")). Подвижные части отдайте памяти. Полезная общая память хранит четыре вида вещей:

1. **Решения.** «Для API используем JWT, потому что сессии ломали мобильное приложение», с датой и источником.
2. **Правки.** То, что пользователь сказал агенту как ошибочное. Их дороже всего потерять.
3. **Заметки о передаче.** Что сделал агент и что оставил открытым.
4. **Факты.** Небольшие истины о проекте, неочевидные из кода.

## Как Brain в AgentVera строит память

В AgentVera у каждого проекта на странице Details есть вкладка **Brain**. Нажмите **Build memory** (позже **Refresh memory**), и он прочитает историю проекта:

- Документы и записи о решениях в git: README, ARCHITECTURE, CONTRIBUTING, CLAUDE, AGENTS, CHANGELOG, `docs/`, `adr/` и `decisions/` (до 250 файлов)
- Новейшие 1500 коммитов без слияний
- До 200 pull request и 200 issue, если проект на GitHub и вы вошли в аккаунт
- До 120 прошлых диалогов агентов

Claude Haiku извлекает решения из этого материала. У каждого есть заголовок, причина, дата, источники и термины кода, к которым оно относится. Дубликаты объединяются.

Решения не вечны, поэтому у каждого есть статус: **current**, **stale** или **superseded**. **Compare with code** сверяет термины кода решения с репозиторием через `git grep`. **Verify with Claude** запускает read-only проверку Sonnet для более пристального взгляда. Так память может сказать агенту: «мы решили это, но код ушёл дальше».

На вкладке Brain четыре вида: **Decisions**, **Knowledge graph**, **Context pack** и **Memory**. Есть и поле **Ask**. Спросите «Почему мы используем JWT?», и Sonnet ответит из памяти, только на чтение, со ссылками на источники.

## Как агенты читают и пишут память

Построить память — половина дела. Вторая половина — заставить агентов ею пользоваться. AgentVera добавляет MCP-сервер `agentvera-brain` каждому агенту, чей CLI принимает MCP-серверы. Если MCP вам в новинку, начните со статьи [что такое MCP-сервер](/ru/blog/what-is-mcp-server/ "Что такое MCP-сервер?").

У сервера два инструмента:

| Инструмент | Что делает |
| --- | --- |
| `brain_recall` | Ищет по решениям (с их статусом), документам, коммитам, PR, issue, прошлым диалогам, заметкам о передаче и запомненным фактам. Возвращает до 8 результатов, у каждого есть `[id]` для цитирования. Без запроса возвращает сохранённые воспоминания и открытые нити. |
| `brain_remember` | Сохраняет одно самодостаточное предложение как `fact`, `correction` или `decision`. Не предназначен для сообщений о ходе работы. Одинаковый текст не сохраняется дважды. |

Сервер также подсказывает агенту, когда их использовать: вызывать `brain_recall` перед задачей, затрагивающей прежнюю работу, вызывать `brain_remember`, когда пользователь поправляет его, формулирует правило или предпочтение либо принято решение, и цитировать элементы по `[id]`.

Типичный обмен в сессии Claude Code выглядит так:

```text
You: Add refresh tokens to the API.
Agent: (calls brain_recall "auth tokens JWT")
       Found [d12] "Use JWT for the API, sessions broke the mobile app" (current)
       and a correction [m4] "Never store tokens in localStorage".
       I will keep JWT and put the refresh token in an httpOnly cookie.
You: Good. And refresh tokens expire after 30 days.
Agent: (calls brain_remember, kind: decision)
```

Следующий агент, который коснётся авторизации, найдёт и то и другое, и вам не придётся повторяться.

## Заметки о передаче: память между сессиями

Переключатель **Agents write the memory** на вкладке Brain включён, пока вы его не выключите. Когда он включён:

- После ходов (не чаще раза в 15 минут на агента) и всегда, когда агент сжимает диалог, он оставляет короткую заметку о передаче. Её пишет Haiku: сводка из одного-четырёх предложений и до шести открытых нитей, показанных как **Left open**.
- Правки и решения, которые агент сохраняет через `brain_remember`, попадают в ту же память.
- Новые агенты проекта получают недавние из них.
- Между 03:00 и 06:00 brain компилируется заново, но только если он уже строился раньше, с тех пор появились новые заметки и не чаще одного раза в 12 часов.

Заметки и воспоминания перечислены в виде **Memory** с метками Fact, Correction, Decision или Session note. **Forget** удаляет одно из них.

Когда стартует новый агент, в его инструкции попадает короткое вступление до 2500 символов: сохранённые воспоминания (правки сначала, до 15), плюс новейшая заметка от каждого из шести других агентов за последние семь дней, у которых остались открытые нити. Это и смягчает боль сжатия: сводка, написанная Claude Code, исчезает после сессии, а заметка о передаче остаётся. Подробнее о том, что сжатие сохраняет и что теряет, см. [контекстное окно Claude Code](/ru/blog/claude-code-context-window/ "Контекстное окно Claude Code").

## Context pack

Отдельно в виде **Context pack** хранится сводка проекта до 2500 символов. Включите **Give new agents a context pack**, и новые агенты получат пакет и список устаревших решений в своих инструкциях. По умолчанию выключено, потому что это добавляет объём к стартовому контексту каждого нового агента. Включите, если ваши агенты постоянно упускают один и тот же фон.

## Настройка за пять шагов

1. Откройте проект в AgentVera и перейдите в **Details → Brain**.
2. Нажмите **Build memory**. Если хотите включить PR и issue, сначала войдите в GitHub.
3. Просмотрите **Decisions**. Запустите **Compare with code** для тех, в которых сомневаетесь.
4. Оставьте **Agents write the memory** включённым и решите, нужен ли вам context pack.
5. Запустите нового агента Claude Code или Codex и дайте ему задачу, затрагивающую прежнюю работу. Посмотрите, как он вызывает `brain_recall`.

## Общая память и координация

Память отвечает на вопрос «что мы знаем?». Координация отвечает на вопрос «кто что делает прямо сейчас?». Для живой работы AgentVera также даёт агентам доску объявлений через MCP (`agentvera-board`), где они публикуют заметки, решения, todo и находки, и предупреждает, когда два агента правят один файл. Они дополняют друг друга: доска для сегодняшнего дня, Brain для следующего месяца.

Память хорошо сочетается и с [картой проекта](/ru/features/project-map/ "Карта проекта"). Карта говорит агенту, *где* лежит код; Brain говорит, *почему* код такой.

## Ограничения

- Brain добавляется агентам, принимающим MCP-серверы. Обычные терминалы и агенты на удалённом SSH-хосте его не получают.
- Заметки сессий и воспоминания хранят по 200 записей каждые.
- Всё хранится локально, по одному файлу на проект в папке данных приложения. Извлечение решений, заметки о передаче и ответы используют Claude через ваш вход в Claude Code, так что эти запросы уходят в Anthropic.
- Память хороша ровно настолько, насколько хорошо то, что в ней лежит. Время от времени просматривайте Memory и удаляйте неверные заметки через Forget.

## Итоги

Общая память для ИИ-агентов кода закрывает разрыв между статичными файлами инструкций и контекстным окном, которое сбрасывается. Brain в AgentVera строит её из ваших документов, коммитов, PR, issue и диалогов, отслеживает, какие решения ещё в силе, и позволяет каждому агенту с поддержкой MCP вспоминать и запоминать через `agentvera-brain`, с заметками о передаче после ходов и при сжатии. Brain входит в бесплатный тариф. Читайте [страницу функции Brain](/ru/features/brain/ "Brain") или [скачайте AgentVera](/ru/download/) и постройте первую память проекта.

## Частые вопросы

**Что такое общая память для ИИ-агентов кода?** Хранилище знаний о проекте, которое может читать и дополнять каждый агент: почему приняты решения, что поправил пользователь, что оставил открытым предыдущий агент. Оно живёт дольше одной сессии, так что новый агент начинает с контекстом, который был у прошлого.

**Разве CLAUDE.md недостаточно?** CLAUDE.md и AGENTS.md хранят правила, которые вы пишете вручную и которые редко меняются. Общая память хранит и то, что происходит по ходу работы: решения из коммитов и PR, правки, заметки о передаче и то, каким решениям код уже не следует.

**Как агенты используют Brain в AgentVera?** Через MCP-сервер agentvera-brain. brain_recall ищет по решениям, документам, коммитам, PR, issue, прошлым диалогам и заметкам; brain_remember сохраняет одно предложение как факт, правку или решение. Агентам велено цитировать использованное по его [id].

**Какие агенты получают общую память?** Агенты, чей CLI принимает MCP-серверы, такие как Claude Code и Codex. Обычные терминалы и агенты на удалённом SSH-хосте её не получают.

**Где хранится память?** На вашем компьютере, по одному файлу на проект в папке данных приложения. Для извлечения решений и ответов на вопросы используется Claude через ваш вход в Claude Code, так что эти запросы уходят в Anthropic.

---

**Об AgentVera.** AgentVera — настольное приложение для macOS, Windows и Linux от Solviera Teknoloji. Оно запускает 18 ИИ-агентов для программирования (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) рядом, по проектам, в настоящих терминалах с собственными установками CLI и входами пользователя. В бесплатном тарифе количество агентов не ограничено. Скачать: https://agentvera.dev/ru/download/ · Цены: https://agentvera.dev/ru/pricing/