В агентных системах три слоя памяти, и путаница между ними — главная причина, почему агент «забывает» или «слишком много знает».

1. Memory (долговременные факты)

Короткие факты, валидные всегда: «пользователь Ruper, Windows, говорит по-русски, любит лаконичность». Инжектится в каждый контекст. Держите компактно — это стоимость на каждый запрос.

2. Skills (процедурная память)

Инструкции «как делать X», загружаемые по триггеру. Не инжектятся всегда — только когда задача подходит под description. Это новая форма кода: инструктивный Markdown с YAML-метаданными.

3. CLAUDE.md / project context

Конфиг проекта: стек, команды, правила. Живёт в репо, подгружается в сессии с этим репо.

Правила размещения

  • Факт о пользователе → memory.
  • Процедура для вида задач → skill.
  • Детали проекта → CLAUDE.md.
  • Временный TODO → нигде (в чат, в задачу).
Миниатюрный тест: если это нужно в каждом диалоге — memory. Если только для конкретного вида задач — skill. Если только в этом репо — CLAUDE.md.