22 июля 2026

Скил datarim-system — базовые правила, которые загружает каждый агент

Обзор скила datarim-system — всегда загружаемого свода правил, определяющего, где живёт состояние Datarim, как устроены файлы задач и как агенты разрешают пути и порядок загрузки.

Прежде чем любая команда /dr-* что-либо сделает, она читает datarim-system. Этот скил — фундаментальный уровень: он определяет, где живёт состояние рабочего процесса, как должны выглядеть операционные файлы и как фреймворк разрешает пути и порядок загрузки скилов. Каждый другой скил и каждый агент считают его предварительным условием.

Операционные файлы — индексы, не контент

Центральное правило скила состоит в том, что tasks.md, backlog.md и activeContext.md — это индексы. Каждая строка-пункт отвечает на четыре вопроса — какая задача, какой статус, какой уровень сложности и где файл описания — и ничего более. Файл описания задачи по адресу datarim/tasks/{TASK-ID}-task-description.md содержит всё фактическое содержимое: обзор, критерии приёмки, ограничения, явные не-цели и связанные ссылки.

Два файла официально упразднены. progress.md не существует начиная с v1.19.0 — заметки о ходе задачи принадлежат секции Implementation Notes файла описания. backlog-archive.md упразднён в v1.19.1 — записи о завершённых и отменённых задачах живут в documentation/archive/, а не в скользящем файле, который агенты читают при каждом вызове.

Разрешение путей

Скил определяет строгое правило разрешения пути. Агент определяет физическую рабочую директорию и поднимается к ближайшему предку, в котором есть .datarim-runtime/installation.json; записанный там проект должен совпадать с этой директорией, а каждый вложенный git-репозиторий на пути должен быть явно перечислен в контекстах установки. Состояние задач — <проект>/datarim/. Директория, которая просто называется datarim/, Datarim не включает, и правило никогда не откатывается к домашнему каталогу, родительскому рабочему пространству или чекауту фреймворка. Так агенты не пишут состояние задач не туда.

Начиная с 3.0 установка проектная: каждый проект получает закреплённую копию фреймворка в .datarim-runtime/, и команды читают её через ${DATARIM_RUNTIME}. Установки, скопированные из другого места, и рантайм-директории-симлинки отклоняются правилом разрешения пути. Изменения фреймворка вносятся в репозиторий исходников и попадают в проект при его обновлении.

Порядок загрузки скилов и список блокировок

Скилы загружаются из двух слоёв. Слой фреймворка — рантайм проекта в .datarim-runtime/. Локальный оверлей в .datarim-runtime/local/ (вне git) позволяет частные дополнения проекта; при коллизии имён выигрывает локальный оверлей. Шесть критических скилов нельзя затенить через локальный оверлей: security, security-baseline, compliance, datarim-system, ai-quality и evolution. Попытка переопределить любой из них через local/skills/ приводит к завершению validate.sh с кодом 1.

Стратегия чтения объёмных планов

Когда план, PRD и вспомогательные исследования задачи уровня L3+ вместе превышают примерно 600 строк, скил рекомендует одну делегацию во внешний контекст вместо последовательного чтения каждого артефакта. Структурированное резюме из этой делегации затем управляет порядком реализации, путями файлов и критериями проверки на протяжении /dr-do, /dr-qa и /dr-compliance — повторное чтение сырых артефактов на каждом этапе вносило бы расхождение между резюме реализации и резюме верификации.

Скил также разбивает себя на субфайлы — path-and-storage.md, task-identity-and-context.md, backlog-and-routing.md и другие — чтобы команды загружали только тот фрагмент, который нужен для текущей подзадачи, а не весь документ системных правил.

Полный контекст пайплайна — в посте что такое Datarim; алгоритм миграции, который следит за выполнением этой схемы, описан в посте о скиле datarim-doctor.