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

Обзор

Исследователь — специализированный агент, который собирает внешний контекст до начала разработки. Вместо того чтобы обнаружить посреди реализации, что библиотека убрала свой 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, архитектурные паттерны
• Long-term-memory (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 для пересмотра требований.

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

Перед любым чтением исходников или делегированием загружает навык security и применяет его границу для чувствительных источников. Читает datarim/activeContext.md и datarim/tasks.md. Загружает скил research-workflow (методология), datarim-system (базовые правила) и tech-stack (при оценке технологий).

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

security (до чтения исходников), research-workflow, datarim-system, tech-stack (условно).

Отчёт о результате

Перед сообщением человеку применяется Human Outcome Reporting. Объясняются изменение для пользователя, исходные условия, проверки и доказательства, а также открытые ограничения. Итог этапа не означает завершения всей задачи. Точные протоколы и технические записи сохраняются. Для повторного объяснения без продолжения работы — /dr-explain.