Research Workflow
Структурированное исследование внешнего контекста — 10-точечный полный чек-лист (L3-L4), 5-точечный лайт-режим (L2), протокол gap discovery для неизвестных при реализации.
Обзор
Research Workflow определяет, как агент-исследователь изучает внешний контекст до начала планирования и при обнаружении неизвестных в процессе реализации. Предоставляет структурированный чек-лист, приоритеты выбора инструментов и протокол gap discovery — обеспечивая систематическое, а не ad hoc исследование.
Режимы исследования
| Режим | Сложность | Пунктов |
|---|---|---|
| Полный | L3-L4 | 10 |
| Лайт | L2 | 5 |
| Пропуск | L1 | 0 |
Чек-лист из 10 пунктов
- Версии и зависимости — текущие стабильные релизы вашего стека
- Breaking changes — гайды миграции, deprecated API
- Лучшие практики — рекомендованные подходы из официальных docs и сообщества
- Документация стека — релевантные разделы через context7 или веб-поиск
- Архитектурные паттерны — референсные реализации похожих задач
- Совместимость — конфликты peer-зависимостей, runtime-совместимость
- Security advisories — известные CVE в дереве зависимостей
- Прошлый опыт — уроки из предыдущих задач (через LTM, если доступна)
- Существующий код — переиспользуемые компоненты в проекте
- Ограничения инфраструктуры — порты, ресурсы, лимиты сервера
Лайт-режим использует пункты 1, 3, 4, 6, 9 — фокус на том, что наиболее вероятно вызовет проблемы в задачах средней сложности.
Приоритет выбора инструментов
Агент-исследователь адаптируется к доступным инструментам в следующем порядке:
- context7 MCP — токен-эффективная документация библиотек (приоритет для docs стека)
- WebSearch — проверка версий, CVE, best practices сообщества
- WebFetch — конкретные страницы документации, release notes
- Scrutator LTM API — опыт прошлых задач из долгосрочной памяти
- Инструменты кодовой базы — всегда доступны: grep, glob, read для локального анализа
Никаких жёстких зависимостей. Отсутствующие инструменты деградируют плавно — выводы из обучающих данных помечаются как [unverified].
Протокол Gap Discovery
Когда developer agent сталкивается с неизвестным в /dr-do:
- Триггер — ошибка импорта, неожиданный ответ API, несоответствие документации, отсутствующая зависимость
- Запуск — subagent-исследователь с фокусным запросом о конкретном пробеле
- Исследование — целевое исследование доступными инструментами
- Запись — результаты дописываются в секцию "Gap Discoveries" документа insights
- Оценка — пробел решаем или фундаментален?
- Продолжение или эскалация — решаемые пробелы возвращают к реализации; фундаментальные (неправильный стек, невозможное требование) → STOP и рекомендация вернуться к
/dr-prd
Формат результата
Результаты сохраняются в datarim/insights/INSIGHTS-{task-id}.md с 7 секциями:
- Stack & Versions
- Best Practices
- Documentation References
- Existing Codebase
- Risks & Compatibility
- LTM Context
- Gap Discoveries (растёт в процессе реализации)
Заполняются только релевантные секции. Каждый вывод включает источник. Выводы из обучающих данных помечены [unverified].