From yamem
Manages file-based project memory in .agents/memory/ with MEMORY.md index, backlog.md, diary entries, topics, tasks, and shared bases. Always active for state persistence.
How this skill is triggered — by the user, by Claude, or both
Slash command
/yamem:yamemThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
> [!IMPORTANT]
[!IMPORTANT] Раздел «При старте» выполняется один раз при первом сообщении в чате. Раздел «Перед ответом» выполняется перед каждым ответом, если в ходе работы появился полезный результат для памяти.
Конфиг: .agents/memory/yamem.config.yaml.
Если файла нет, используй значения по умолчанию:
local.path=locallocal.type=directorylocal.pull_on_start=truelocal.commit_on_update=falseoptimization.auto=trueoptimization.interval_days=7notify_no_shared=truediary_read_days=7Если не указано иное, все пути ниже относительны к .agents/memory/.
.agents/memory/
├── yamem.config.yaml
├── <local.path>/
│ ├── MEMORY.md
│ ├── diary/
│ │ └── YYYY-MM-DD.md
│ ├── backlog.md
│ ├── archive.md
│ ├── topics/
│ │ └── <topic>.md
│ └── tasks/
│ └── YYYY-MM-DD-topic/
│ ├── plan.md
│ ├── report.md
│ └── ...
└── shared/
└── <base>/
├── README.md
└── topics/
Используй эти шаблоны как основной формат. Если файлы уже существуют в похожем виде, сохраняй совместимость и не переписывай их без необходимости.
MEMORY.mdРекомендуемая структура:
# Memory Index
Последняя оптимизация: YYYY-MM-DD
## Проект
- Краткое описание проекта
- Основные каталоги и точки входа
## Инфраструктура
- Среды, хосты, сервисы без секретов
- Где искать доступы и переменные
## Ограничения
- Что нельзя ломать
- Важные технические и организационные ограничения
## Факты
- Устойчивые факты о проекте
## Грабли и уроки
- ⚠️ Проблема и проверенное решение
## Ссылки
- Относительные ссылки на важные topics, tasks и документы
Правила:
MEMORY.md храни только устойчивые факты, ограничения и уроки;backlog.mdРекомендуемая структура:
# Бэклог
## Активные
- [ ] Краткое название задачи
created: YYYY-MM-DD
updated: YYYY-MM-DD
notes: краткий контекст
- [/] Задача в работе
created: YYYY-MM-DD
updated: YYYY-MM-DD
notes: что уже делается
## Ожидает
- [ ] Задача, зависящая от внешнего действия
created: YYYY-MM-DD
updated: YYYY-MM-DD
notes: чего именно ждём
## Идеи
- [ ] Кандидат в работу без обязательства
created: YYYY-MM-DD
updated: YYYY-MM-DD
notes: почему это может пригодиться
Завершённые задачи: см. `archive.md`
Правила:
created ставь при создании записи;updated обновляй при любом заметном движении по задаче;[ ] для новых задач и ожидания, [/] для задач в работе;archive.md, а не оставляй дубликат в backlog;notes, чем молча удалять.archive.mdРекомендуемая структура:
# Архив
## YYYY-MM
- [x] Завершённая задача
created: YYYY-MM-DD
completed: YYYY-MM-DD
result: краткий итог
- [x] Ещё одна завершённая задача
created: YYYY-MM-DD
completed: YYYY-MM-DD
result: что получилось или где смотреть артефакт
Правила:
completed и краткий result;result;.agents/memory/yamem.config.yaml, если он существует.<local.path>;directory или submodule;MEMORY.md по каноническому шаблонуdiary/backlog.md по каноническому шаблонуarchive.md по каноническому шаблонуtopics/tasks/local.type=submodule и local.pull_on_start=true, попытайся выполнить синхронизацию локальной памяти.
local memory syncedlocal memory NOT synced (<причина>)type=submodule и pull_on_start=true, попытайся синхронизировать её;notify_no_shared=true, сообщи об этом один раз в первом ответе.<local.path>/MEMORY.md<local.path>/backlog.mddiary_read_days дней, если они существуют<local.path>/topics/ и <local.path>/tasks/. Содержимое не читай — нужны только имена, чтобы знать, какие темы и активные задачи существуют, и иметь к ним быстрый доступ позже.optimization.auto=true и в MEMORY.md есть отметка Последняя оптимизация: YYYY-MM-DD, которая старше optimization.interval_days, выполни только фазу анализа и кратко предложи оптимизацию. Не меняй файлы без подтверждения пользователя.Для содержательной задачи, которая требует нескольких шагов, артефактов или накопления опыта:
<local.path>/tasks/YYYY-MM-DD-topic/topics/ и tasks/, полученными при старте;MEMORY.md, backlog и недавний diary на упоминания темы;rg, grep или эквивалент) по содержимому topics/, tasks/, MEMORY.md и shared/*/topics/.Если в ходе работы появился устойчивый полезный результат, обнови память.
Под устойчивым полезным результатом понимаются:
Если работа была короткой, ознакомительной или не оставила полезного следа, память не обновляй.
При обновлении памяти:
<local.path>/diary/YYYY-MM-DD.mdbacklog.md;archive.md;MEMORY.mdtopics/<topic>.mdshared добавляй только если они:
Если local.commit_on_update=true, коммить изменения памяти только при наличии реальных изменений.
Правила:
Для shared-баз действуют те же правила.
rg, grep или эквивалент) по локальной памяти и нужным shared-базам.| Фраза пользователя | Действие агента |
|---|---|
| «что в отложках», «что в бэклоге», «покажи бэклог», «какие задачи» | Прочитай backlog.md |
| «что делали сегодня / вчера / на прошлой неделе» | Прочитай нужные файлы из diary/ |
| «запомни это» | Сохрани факт, урок или заметку в подходящее место |
| «добавь в бэклог» | Добавь задачу в backlog.md |
| «что ты знаешь про ...» | Ищи в MEMORY.md, topics/, backlog, diary, tasks |
| «оптимизируй память» | Запусти анализ оптимизации и предложи изменения |
Оптимизация запускается:
Ничего не меняй в файлах.
Проверь:
MEMORY.md;Консервативные правила:
waiting или snoozed, а не удалять;Покажи пользователю краткую сводку:
topics/ или shared/;Жди подтверждения. До подтверждения не меняй файлы.
После подтверждения пользователя:
Последняя оптимизация: YYYY-MM-DD в MEMORY.md;# 2026-03-21
## Краткое название задачи
- Сделано: ...
- Грабля: ...
- Артефакт: [../tasks/2026-03-21-topic/](../tasks/2026-03-21-topic/)
# Бэклог
## Активные
- [ ] Подготовить ...
created: 2026-03-21
updated: 2026-03-21
notes: краткий контекст
- [/] В работе: ...
created: 2026-03-21
updated: 2026-03-21
notes: что уже делается
## Ожидает
- [ ] Ждём внешнего доступа для ...
created: 2026-03-21
updated: 2026-03-21
notes: чего именно ждём
Завершённые задачи: см. `archive.md`
# Архив
## 2026-03
- [x] Подготовить ...
created: 2026-03-20
completed: 2026-03-21
result: задача завершена, артефакт в `tasks/2026-03-21-topic/`
Файл local/topics/topic-name.md:
# Название темы
## Факты
- ...
## Грабли
- ⚠️ ...
Если local/ нужно превратить в субмодуль, сначала сохрани текущее содержимое и перенеси его в отдельный репозиторий памяти. Только после этого подключай submodule.
git submodule add <url> .agents/memory/local
git submodule add <url> .agents/memory/shared/<имя>
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub rsyuzyov/yamem --plugin yamem