Главная боль работы с ИИ-агентом: он каждый день приходит как новый человек.
Снова льёт воду, лезет не в те файлы, приносит уже отклонённые идеи. Лечится это
проектной памятью — короткой папкой из 7 живых документов, которые агент читает
перед работой и обновляет после.
Три типа памяти
Прежде чем строить, разложим по полочкам:
- рабочая — текущий чат, живёт до конца сессии;
- проектная — правила и карта проекта, живёт между сессиями;
- долгая — решения, ошибки, примеры, накапливается со временем.
Проблема «нового человека» — это отсутствие проектной и долгой памяти.
Семь файлов памяти
AGENTS.md— постоянные правила: что за проект, где важные файлы, как
проверять, стиль, запреты.project_map.md— карта проекта.decision_log.md— принятые решения.task_log.md— журнал задач.examples.md— примеры «как надо».processes.md— процессы и регламенты.do_not_do.md— чего делать нельзя.
AGENTS.md отвечает на 5 вопросов: что за проект, где файлы, как проверять,
какой стиль, что нельзя.
Важно: больше памяти ≠ лучше результат
Здесь легко перегнуть. Исследование ETH Zurich / SRI (2026) по оценке
AGENTS.md не нашло общего роста успешности, зато стоимость вывода выросла
более чем на 20%. Вывод: цель — не больше текста, а меньше, но точнее.
Память может быть как сигналом, так и шумом. Рекомендация — файл правил держать
до 50 строк.
У каждого инструмента своё имя файла
AGENTS.md— Codex;CLAUDE.md— Claude Code;- правила проекта — Cursor;
- repository instructions — Copilot.
Внешние опции (Obsidian, MCP, Mem0, Letta) — по необходимости, без рекламы
непроверенных плагинов.
Ритуал
Агент читает память перед задачей и обновляет после. Без этого ритуала
даже идеальные файлы бесполезны.
Итог
Проектная память из 7 файлов превращает агента из «нового стажёра каждый день» в
коллегу, который помнит контекст. Но помните про исследование ETH: короче и точнее
лучше, чем длиннее и дороже.
Источники
- Исследование: https://sri.inf.ethz.ch/publications/gloaguen2026agentsmd
- Форматы: AGENTS.md (Codex), CLAUDE.md (Claude Code), правила проекта (Cursor), repo instructions (Copilot).