В агентных системах три слоя памяти, и путаница между ними — главная причина, почему агент «забывает» или «слишком много знает».
1. Memory (долговременные факты)
Короткие факты, валидные всегда: «пользователь Ruper, Windows, говорит по-русски, любит лаконичность». Инжектится в каждый контекст. Держите компактно — это стоимость на каждый запрос.
2. Skills (процедурная память)
Инструкции «как делать X», загружаемые по триггеру. Не инжектятся всегда — только когда задача подходит под description. Это новая форма кода: инструктивный Markdown с YAML-метаданными.
3. CLAUDE.md / project context
Конфиг проекта: стек, команды, правила. Живёт в репо, подгружается в сессии с этим репо.
Правила размещения
- Факт о пользователе → memory.
- Процедура для вида задач → skill.
- Детали проекта → CLAUDE.md.
- Временный TODO → нигде (в чат, в задачу).
Миниатюрный тест: если это нужно в каждом диалоге — memory. Если только для конкретного вида задач — skill. Если только в этом репо — CLAUDE.md.
