guide

Гайд: накопительная память Website Tech agent

обновлено: 2026-06-03 · guide, case, memory, qdrant, website-tech

Гайд: накопительная память 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 в конце сессии.