Гайд: накопительная память Website Tech agent
Гайд: накопительная память Website Tech agent
Что это и зачем
Website Tech agent (Claude Code) умеет запоминать проблемы, с которыми
сталкивался при работе над сайтами. Эти знания лежат в Qdrant и используются
в следующих задачах — агент сам находит похожие кейсы и учитывает их.
Пример: при деплое через UpdraftPlus трижды возникала проблема с вложенными
папками. Если кейс записан — в следующий раз агент предупредит об этом сразу,
до того как проблема возникнет.
Как записать кейс (в конце сессии)
Когда: в конце любой сессии, где велась работа над сайтом.
Шаг 1. Скажи Claude:
«Закрываем сессию. Проверь — есть ли кейсы для записи в память.»
Шаг 2. Claude предложит кейсы — по одному на каждую нестандартную ситуацию.
Для каждого отвечай:
- «Да» — записать
- «Поправь: ...» — уточнить и записать
- «Нет» — пропустить
Шаг 3. Claude создаёт файлы в 70-Incidents/cases/ и запускает индексер.
Ничего делать не нужно — агент делает всё сам после твоего подтверждения.
Когда пропустить: если в сессии не было работы над сайтами (только vault,
ADR, инфраструктура) — кейсов не будет, шаг пропускается.
Как агент использует кейсы
Перед началом задачи по сайту Claude автоматически ищет похожие кейсы в Qdrant.
Ничего делать не нужно — это встроено в рабочий процесс.
Если хочешь проверить что найдётся:
~/sdlab/indexer/run-retrieval.sh "описание задачи"
Где хранятся кейсы
sdlab-vault/
70-Incidents/
cases/
case-YYYY-MM-DD-краткое-описание.md
Кейсы — обычные markdown-файлы в vault. Их можно открыть в Obsidian,
отредактировать или удалить как любой другой файл.
Структура файла кейса
Файл создаётся по шаблону 90-Templates/template-site-case.md.
| Поле | Что писать |
|---|---|
| Контекст | Сайт, клиент, что делали |
| Проблема | Что пошло не так, симптомы, текст ошибки |
| Причина | Почему произошло |
| Решение | Шаги которые помогли |
| Выводы | Что проверять заранее, что добавить в процедуру |
Частые вопросы
Что если забыл записать кейс в конце сессии?
Можно записать в следующей сессии — попроси Claude прочитать нужный session log
и создать кейс на его основе. Потом запусти индексер вручную:
~/sdlab/indexer/run-indexer.sh --mode changed
Можно ли записать кейс вручную?
Да. Создай файл по шаблону 90-Templates/template-site-case.md в папке
70-Incidents/cases/ и запусти индексер.
Как удалить кейс из памяти?
Удали файл из 70-Incidents/cases/ и запусти индексер с --mode full.
Индексер удалит устаревшие записи из Qdrant автоматически.
Нужно ли делать git commit после записи кейсов?
Да — кейсы это файлы в vault, они должны быть в git. Обычно коммитятся
вместе с session log в конце сессии.