Datarim 1.15: Research Phase — знай, прежде чем строить
Версия 1.15.0 добавляет структурированную фазу исследования. Новый агент-исследователь проверяет версии библиотек, лучшие практики и уязвимости до начала планирования — и закрывает пробелы во время реализации.
Каждый разработчик знает ситуацию: спланировал фичу, начал писать код, и на полпути обнаружил, что библиотека убрала ключевой API два месяца назад. Или что две зависимости несовместимы. Или что похожая задача уже решена в другом проекте.
Datarim 1.15.0 решает эту проблему структурированной фазой исследования, которая запускается автоматически внутри /dr-prd. Никаких новых команд. Никаких дополнительных шагов pipeline. Исследование встроено в процесс, который вы уже используете.
Как это работает
Когда вы запускаете /dr-prd для задачи Level 2 и выше, активируется новая Phase 1.3 между анализом контекста и discovery-интервью. Специализированный агент-исследователь изучает внешний контекст и создаёт документ insights.
Исследование проходит по структурированному чек-листу:
- Версии и зависимости — текущие стабильные релизы вашего стека
- Breaking changes — гайды миграции, deprecated API
- Лучшие практики — рекомендованные подходы из официальных docs и сообщества
- Документация стека — релевантные разделы через context7 или веб-поиск
- Архитектурные паттерны — референсные реализации похожих задач
- Совместимость — конфликты peer-зависимостей, runtime-совместимость
- Security advisories — известные CVE в дереве зависимостей
- Прошлый опыт — уроки из предыдущих задач (через LTM, если доступна)
- Существующий код — переиспользуемые компоненты в проекте
- Ограничения инфраструктуры — порты, ресурсы, лимиты сервера
Задачи Level 2 получают облегчённую версию (5 пунктов). Quick fix задачи Level 1 пропускают исследование полностью.
Документ Insights
Результаты исследования сохраняются в отдельный файл datarim/insights/INSIGHTS-{task-id}.md — отдельно от PRD. Это принципиально: PRD — замороженный документ требований, а insights — живой артефакт, который растёт в процессе реализации.
Discovery-интервью, следующее за Phase 1.3, читает insights — поэтому его вопросы и предлагаемые ответы основаны на реальном исследовании, а не на предположениях.
Gap Discovery при реализации
Исследование не заканчивается на стадии PRD. Когда developer agent сталкивается с неизвестным в /dr-do — ошибка импорта, неожиданный ответ API, документация не совпадает с поведением — он автоматически запускает агента-исследователя для изучения конкретного пробела.
Результаты дописываются в секцию "Gap Discoveries" документа insights. Если пробел фундаментален (неправильный стек, невозможное требование), агент останавливается и рекомендует вернуться к /dr-prd.
Это замыкает цикл: исследование происходит до начала разработки, а новые неизвестные вызывают точечное исследование без выхода из потока реализации.
Адаптивные инструменты
Агент-исследователь работает с любыми доступными инструментами:
- context7 MCP — токен-эффективная документация библиотек (приоритет)
- WebSearch — проверка версий, CVE, архитектурные паттерны
- Scrutator LTM API — опыт прошлых задач из долгосрочной памяти
- Инструменты кодовой базы — всегда доступны: grep, glob, read для локального анализа
Никаких жёстких зависимостей от конкретных MCP серверов. Если внешних инструментов нет, агент работает только с кодовой базой и помечает выводы на основе обучающих данных как непроверенные.
В цифрах
| Компонент | Было | Стало |
|---|---|---|
| Скилы | 21 | 22 |
| Агенты | 16 | 17 |
| Команды | 19 | 19 |
| Шаблоны | 12 | 13 |
Один новый скил (research-workflow), один новый агент (researcher), один новый шаблон (insights-template). Восемь существующих файлов обновлены. Ноль новых команд — исследование интегрировано, а не прикручено сбоку.
Архитектурное решение: внутри PRD, а не отдельная команда
Мы рассматривали отдельную команду /dr-research. Это потребовало бы обновления 5+ маршрутных файлов, изменения топологии pipeline и дополнительной когнитивной нагрузки (оператор решает — исследовать или продолжить). Вместо этого исследование стало внутренней фазой /dr-prd — команды, которую вы уже запускаете для требований. Pipeline остаётся прежним. Исследование просто происходит.
Полный список изменений
- Research Phase 1.3 в /dr-prd для L2+ задач (TUNE-0029)
- Gap Discovery Step 7.5 в /dr-do — авто-запуск исследователя при неизвестных (TUNE-0029)
- Новый агент researcher (модель sonnet, адаптивные инструменты)
- Новый скил research-workflow (10-точечный полный чек-лист, 5-точечный lite-режим)
- Новый шаблон insights-template (7 секций включая Gap Discoveries)
- /dr-plan автоматически загружает insights как контекст
- Discovery interview читает insights перед формулировкой предложений
- Visual maps обновлены: pipeline routing, stage flows, графы зависимостей
- path-and-storage: директория datarim/insights/
- backlog-and-routing: документированы встроенные фазы
См. changelog для полной истории версий.