Команда /dr-archive — закрытие задачи с постоянной записью
Как /dr-archive превращает завершённую задачу в архивный документ, валидирует состояние рабочего дерева, маршрутизирует по префиксу и закрывает пайплайн Datarim.
Каждая завершённая задача заслуживает записи, которая переживёт сессию. /dr-archive — финальная команда в пайплайне Datarim: она превращает выполненную задачу в постоянный архивный документ, обновляет индексные файлы и удаляет задачу из активного списка.
Поскольку операции архивирования необратимы — задача перемещается из активных в архивированные, индексные файлы меняются, git-состояние сдвигается — команда запускает несколько защитных проверок до любых мутаций.
Гейт чистоты git
До начала записи /dr-archive проверяет git-состояние каждого репозитория, затронутого задачей. При грязном рабочем дереве оператор выбирает один из трёх путей: сделать коммит прямо сейчас, зафиксировать незавершённое состояние в секции Known Outstanding State архивного документа, или прервать операцию и вернуться в /dr-do. Архивирование без фиксации незакоммиченных изменений недопустимо.
Для разделяемых воркспейс-репозиториев — где несколько параллельных сессий могут иметь незасейдженные несвязанные изменения — проверка использует скрипт, классифицирующий хунки каждого изменённого файла по идентификатору задачи. Хунки, принадлежащие другим задачам, не блокируют операцию; только незакоммиченные изменения текущей задачи помечаются. Это исключает ложные остановки при параллельной работе.
Что содержит архивный документ
Архивный документ записывается по пути, определённому префиксом задачи. Каждый проектный префикс отображается в поддиректорию под documentation/archive/, поэтому история каждого проекта хранится вместе. Документ имеет фиксированную структуру: начальная задача (одно предложение из брифа оператора), как её решили (по одному пункту на каждый пункт брифа), произведённые артефакты и секция Operator Handoff с описанием того, что нужно знать будущей сессии для продолжения с этой точки.
Проход рефлексии запускается внутри как Шаг 0.5 команды /dr-archive. Он рассматривает выполненную работу, выявляет извлечённые уроки и генерирует предложения по развитию — элементы класса A (представляются оператору для одобрения в том же цикле архивирования) или класса B (удерживаются до обновления PRD). Предложения класса A требуют явного одобрения оператора и не применяются автоматически.
Обновление индексов
После записи документа /dr-archive обновляет индексные файлы Datarim. Задача перемещается из активного списка в tasks.md в статус завершённой, а activeContext.md обновляется, отражая новое количество активных задач. Оба файла используют тонкую однострочную схему — никаких полных тел задач в индексе, только метаданные для маршрутизации следующей команды.
Почему важно использовать слэш-форму
Архивный документ и все сопутствующие защиты гарантированно запускаются только при использовании канонической слэш-команды. Ручное добавление архивных файлов или перемещение записей индекса вручную обходит валидаторы pre-archive-check.sh и datarim-doctor.sh. Слэш-форма — это контракт; ad-hoc пути его нарушают.
Общая картина пайплайна — в посте что такое Datarim. О гейте качества, запускаемом непосредственно перед архивированием, рассказывает пост о команде /dr-compliance.