Система Datarim

Обзор

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

Организация файлов

Всё состояние воркфлоу хранится в datarim/ в корне явно установленного проекта и скрыто от git через локальный .git/info/exclude (общий .gitignore проекта не редактируется). Архивы завершённых задач идут в documentation/archive/ (коммитятся в git). Это разделение позволяет нескольким разработчикам работать параллельно со своим локальным состоянием, обмениваясь знаниями через архивы.

Нумерация задач

Каждая задача получает постоянный ID в формате {PREFIX}-{NNNN} (например, <TASK-ID>, <TASK-ID>). ID присваивается один раз и не меняется на протяжении всего жизненного цикла: бэклог, активные задачи, архив. Префикс выбирается из реестра проектных и тематических префиксов.

Маршрутизация по сложности

• Уровень 1 (Quick Fix) — один файл, <50 строк. Маршрут: init, do, archive.
• Уровень 2 (Enhancement) — 2-5 файлов, <200 строк. Маршрут: init, plan, do, archive.
• Уровень 3 (Feature) — 5-15 файлов, 200-1000 строк. Маршрут: init, PRD, plan, design, do, QA, compliance, archive.
• Уровень 4 (Major Feature) — 15+ файлов, >1000 строк. Маршрут: init, PRD, plan, design, phased-do, QA, compliance, archive.

На любом уровне /dr-archive выполняет рефлексию внутри себя как обязательный Step 0.5.

Маршрутизация фрагментов

Агенты загружают только нужный фрагмент: path-and-storage для расположения файлов, task-identity-and-context для нумерации, model-assignment для frontmatter модели/effort, backlog-and-routing для уровней сложности, command-and-archive-rules для /dr- пространства имён и критических инвариантов.

Ключевые правила

• Обязательное разрешение пути перед любой записью — найти ближайший родительский каталог с .datarim-runtime/installation.json, где записанный проект совпадает; сам по себе каталог datarim/ Datarim не включает, отката в домашний каталог нет
• Все отчёты должны содержать ID задачи в имени файла
• backlog.md содержит только текущую работу; постоянные записи о завершённых и отменённых задачах находятся в documentation/archive/
• Все команды Datarim используют префикс /dr-
• Используйте ${DATARIM_RUNTIME:?}/ или проект-относительные пути, не абсолютные машиноспецифичные

Связи отчётности в версии 4.2

Общий контракт Human Outcome Reporting связывает требования задачи с планом, результатом, проверками и доказательствами. /dr-explain объясняет результат без выполнения работы. Шаблоны релиза и карта связей помогают найти эти связи; подготовка проекта использует шаблон AGENTS.md.