Исследователь

Обзор

Исследователь — специализированный агент, который собирает внешний контекст до начала разработки. Вместо того чтобы обнаружить посреди реализации, что библиотека убрала свой API или что две зависимости несовместимы, Исследователь находит эти проблемы заранее. Когда неизвестные всплывают во время кодирования, он исследует конкретный пробел без выхода из потока реализации.

Когда используется

Автоматически активируется в двух контекстах:

• Phase 1.3 внутри /dr-prd — для задач Level 2+, запускается между анализом контекста и discovery-интервью. Создаёт полный документ insights.
• Gap Discovery (Step 7.5) внутри /dr-do — когда developer agent сталкивается с неизвестным (ошибка импорта, неожиданный ответ API, документация не совпадает с поведением), Исследователь запускается для изучения конкретного пробела.

Чек-лист исследования

Исследователь работает по структурированному чек-листу, адаптированному под сложность задачи:

• Полный режим (L3-L4) — 10 пунктов: версии и зависимости, breaking changes, лучшие практики, документация стека, архитектурные паттерны, совместимость, security advisories, прошлый опыт (LTM), существующий код, ограничения инфраструктуры.
• Лайт-режим (L2) — 5 пунктов: версии, лучшие практики, документация, совместимость, существующий код.
• Пропуск (L1) — quick fix задачи не требуют внешнего исследования.

Адаптивные инструменты

Работает с любыми доступными инструментами:

• context7 MCP — токен-эффективная документация библиотек (приоритет)
• WebSearch — проверка версий, CVE, архитектурные паттерны
• Scrutator LTM API — опыт прошлых задач из долгосрочной памяти
• Инструменты кодовой базы — всегда доступны: grep, glob, read для локального анализа

Никаких жёстких зависимостей от MCP серверов. Если внешних инструментов нет, работает только с кодовой базой и помечает выводы как [unverified].

Результат

Создаёт datarim/insights/INSIGHTS-{task-id}.md — живой документ, отдельный от PRD. Содержит 7 секций: Stack & Versions, Best Practices, Documentation References, Existing Codebase, Risks & Compatibility, LTM Context и Gap Discoveries. Последняя секция растёт в процессе реализации по мере исследования новых неизвестных.

Эскалация пробелов

Если обнаруженный пробел фундаментален (неправильный стек, невозможное требование, критическая несовместимость), Исследователь останавливает реализацию и рекомендует вернуться к /dr-prd для пересмотра требований.

Загрузка контекста

Загружает скил research-workflow (методология), datarim-system (базовые правила) и tech-stack (при оценке технологий).

Используемые навыки

research-workflow, datarim-system, tech-stack (условно).