Скил reflecting — уроки, встроенные в каждый архив
Как скил reflecting в Datarim превращает завершение задачи в структурированный обзор, предложения по развитию и проверку здоровья фреймворка — автоматически, каждый раз.
Большинство процессов разработки заканчиваются с последним коммитом. Datarim добавляет обязательный шаг перед закрытием любой задачи: рефлексию. Скил reflecting запускается как шаг 0.5 команды /dr-archive — не по желанию, не по запросу, а каждый раз при архивировании задачи.
До версии Datarim v1.10.0 рефлексия существовала как отдельная команда /dr-reflect. Она была необязательной. Схема не работала: рефлексия ожидалась при каждой задаче, но её легко пропускали. Команда была упразднена, а логика перенесена внутрь /dr-archive как жёсткий шаг. Архив не может продолжиться, пока рефлексия не завершена.
Что создаёт скил
Скил создаёт документ рефлексии по пути datarim/reflection/reflection-{task-id}.md. Документ фиксирует, что сработало, что оказалось неэффективным и какие паттерны задача показала как недостающие. В него также входит проверка здоровья: подсчёт общего числа скилов, агентов и команд в активной области, сверяемый с определёнными порогами. Если порог превышен, скил предлагает запустить /dr-optimize — но не запускает его автоматически.
Детектор отклонений от области задачи — одна из самых практичных частей. В процессе реализации иногда появляются заметки о вещах, которые были замечены, но не исправлены: устаревшие конфиги, параллельное расхождение, отложенная очистка. Скил сканирует эти сигналы в заметках реализации и автоматически предлагает записи для отставания. Это заменяет неформальную привычку мысленно отмечать «надо бы завести задачу на это» — и не заводить.
Предложения по развитию
После проверки задачи скил генерирует предложения по развитию: изменения в скилах, агентах, определениях команд или шаблонах, которые сделают будущую работу быстрее или надёжнее. Каждое предложение классифицируется как Class A или Class B.
Class A охватывает изменения содержимого — обновление текста правил, новые примеры, улучшение формулировок — и может быть представлено оператору для одобрения в том же цикле архивирования. Class B охватывает изменения операционной модели: маршрутизацию конвейера, базовые контракты, семантику команд. Для их применения требуется обновление PRD. Предложение Class B, обнаруженное при архивировании, удерживается до тех пор, пока PRD не будет обновлён; применить его в тот же день нельзя.
Прежде чем одобренное предложение Class A записывается в среду выполнения фреймворка, оно проходит проверку на независимость от стека. Проверка выясняет, называет ли предложение конкретный технологический стек. Если да — предложение отклоняется из фреймворка и перенаправляется в CLAUDE.md проекта. Скилы фреймворка остаются нейтральными к стеку. После любой одобренной записи запускается полный набор тестов; упавший тест возвращает предложение в статус отклонённого.
Место в процессе
Скил запускается как обязательный шаг 0.5 внутри /dr-archive. Он вызывается внутренне: операторы взаимодействуют с ним через команду архивирования, а не напрямую. Документ рефлексии передаётся в шаг 4 /dr-archive, где задачи для отслеживания записываются в отставание.
Общую картину конвейера даёт пост что такое Datarim. О скиле, работающем на другом конце цикла, можно прочитать в статье о research-workflow.