okf-notebooks

Пресет agent-retros: ретроспективы работы агентов

Ретроспективы агентов: сессии, повторяющиеся паттерны, улучшения окружения

Готовый пресет для одного блокнота ретроспектив работы с ИИ-агентами по всем проектам. Разбор сессии становится паттерном, когда повторяется, а паттерн — конкретным изменением окружения агентов (скилл, CLAUDE.md, MCP-инструмент, хук), эффект которого потом проверяется. Файл: presets/agent-retros.yaml.

В пресете dev-project тоже есть тип Retro. Он для ретро, относящихся к одному проекту; этот пресет — когда нужно видеть поведение агентов по всем проектам сразу.

Подключение

В config.yaml укажите каталог с пресетами (в Docker он лежит рядом с конфигом, например /config/presets):

presets_dir: ./presets

Создайте блокнот:

uv run okf-notebooks notebook create agent-retros \
  --description "Ретроспективы работы с ИИ-агентами: разборы сессий, повторяющиеся паттерны, улучшения окружения" \
  --scope "Разборы сессий, паттерны из 2+ сессий, изменения скиллов, CLAUDE.md и инструментов. Не содержание задачи и не проектные решения" \
  --preset agent-retros

Типы

ТипКаталогЧто хранитОбязательные поляstale_after
Sessionsessions/одна сессия: задача, исход, что сработало, проблемы, коррекции пользователяdate, outcome—
Patternpatterns/повторяющийся антипаттерн или удачная практика: признаки, причина, сессииkind, sessions180d
Improvementimprovements/изменение окружения, выведенное из паттерна, его состояние и эффектtarget, state, pattern90d
Playbookplaybooks/как вести ретро: запись сессии, сведение в паттерны, словарь категорий—180d

Значения, которые ждут типы:

  • Session.outcome: success, partial, failed, abandoned;
  • Pattern.kind: anti-pattern или practice; Pattern.state: observed, confirmed, addressed, gone;
  • Improvement.target: skill, claude-md, preferences, mcp-tool, hook, check; Improvement.state: proposed, applied, verified, reverted.

Как это работает с агентами

  • Цикл: сессия → паттерн → улучшение → эффект. Поля Session.patterns, Pattern.sessions, Pattern.improvements и Improvement.pattern связывают шаги, так что каждый можно проследить назад.
  • Паттерн требует двух и более сессий. Одна неудачная сессия — это заметка Session, а не паттерн.
  • Improvement устаревает через 90 дней: к этому времени последующие сессии должны показать, помогло ли изменение. Запишите наблюдение в effect и переведите state в verified или reverted.
  • Процедуры оформите заметками Playbook («как писать разбор сессии», «как сводить сессии в паттерны») и сошлитесь на них из CLAUDE.md / AGENTS.md, например: «в конце длинной сессии запиши разбор в блокнот agent-retros по его плейбуку».
  • Саму задачу сюда не пишите: что сделано и решено, идёт в блокнот проекта, ретро только ссылается на него.

Свой вариант

Скопируйте presets/agent-retros.yaml, переименуйте и поправьте типы: правила, лимит в 12 типов и формат описаны в presets.md.

Этот пресет — один из примеров формата, а не обязательная схема. Если ваша задача другая, придумайте свои типы или попросите агента их предложить.