В агентных системах три слоя памяти, и путаница между ними — главная причина, почему агент «забывает» или «слишком много знает».
1. Memory (долговременные факты)
Короткие факты, валидные всегда: «пользователь Ruper, Windows, говорит по-русски, любит лаконичность». Инжектится в каждый контекст. Держите компактно — это стоимость на каждый запрос.
2. Skills (процедурная память)
Инструкции «как делать X», загружаемые по триггеру. Не инжектятся всегда — только когда задача подходит под description. Это новая форма кода: инструктивный Markdown с YAML-метаданными.
3. CLAUDE.md / project context
Конфиг проекта: стек, команды, правила. Живёт в репо, подгружается в сессии с этим репо.
Правила размещения
- Факт о пользователе → memory.
- Процедура для вида задач → skill.
- Детали проекта → CLAUDE.md.
- Временный TODO → нигде (в чат, в задачу).
Миниатюрный тест: если это нужно в каждом диалоге — memory. Если только для конкретного вида задач — skill. Если только в этом репо — CLAUDE.md.
Skill patterns: how agents remember procedures
Memory vs skills vs CLAUDE.md: what's the difference, where to put what, and why “a file with instructions” is a new form of code.
Agent systems have three memory layers, and confusing them is the main reason an agent “forgets” or “knows too much.”
1. Memory (long-term facts)
Short facts, always valid: “user Ruper, Windows, speaks Russian, likes brevity.” Injected into every context. Keep it compact — it's a cost on every request.
2. Skills (procedural memory)
Instructions “how to do X”, loaded on trigger. Not always injected — only when the task matches the description. This is a new form of code: instructive Markdown with YAML metadata.
3. CLAUDE.md / project context
Project config: stack, commands, rules. Lives in the repo, loaded in sessions with that repo.
Placement rules
- A fact about the user → memory.
- A procedure for a kind of task → skill.
- Project details → CLAUDE.md.
- A temporary TODO → nowhere (in the chat, in a task).
A tiny test: if it's needed in every dialogue — memory. If only for a specific kind of task — skill. If only in this repo — CLAUDE.md.