Команда Pipeline

/dr-prd

Генерация PRD со структурированной фазой исследования (Phase 1.3) для L2+ задач

Обзор

/dr-prd генерирует структурированный документ требований (PRD), следуя расширенному процессу проектирования. Определяет целевую задачу, анализирует код и контекст проекта, исследует внешний контекст (для задач L2+), проводит интервью для уточнения требований, исследует несколько технических подходов и формирует документ с чётким описанием границ, ограничений и критериев успеха.

Использование

/dr-prd "Система уведомлений пользователей"
/dr-prd "Миграция базы данных на PostgreSQL"

Что делает

  1. Анализ контекста (Фаза 1) — читает projectbrief.md, techContext.md, systemPatterns.md и исходный код для понимания ограничений.
  2. Исследование (Фаза 1.3) — для задач L2+ запускает агента-исследователя, который проверяет версии библиотек, лучшие практики, CVE, совместимость и документацию стека. Создаёт datarim/insights/INSIGHTS-{task-id}.md. L3-L4 задачи получают полный чек-лист из 10 пунктов; L2 — лайт-версию из 5. L1 quick fix пропускают исследование.
  3. Интервью (Фаза 1.5) — проводит интервью, масштабированное по сложности: быстрое для L1-2, стандартное для L2-3, глубокое для L3-4. Читает документ insights (если есть) перед формулировкой предложений. Приоритет отдаётся существующим паттернам кода.
  4. Исследование решений (Фаза 2) — генерирует 3+ технических подхода и оценивает каждый по критериям безопасности, соответствия паттернам, DRY и тестируемости.
  5. Согласование (Фаза 3) — представляет альтернативы и ждёт одобрения выбранного подхода.
  6. Генерация PRD — сохраняет документ в datarim/prd/PRD-{slug}.md с описанием проблемы, техническим подходом, альтернативами, критериями успеха и рисками. Ссылается на документ insights.
  7. Генерация бэклога — опционально извлекает задачи из PRD и предлагает новые записи в бэклоге.

Аргументы

Краткое описание фичи или задачи для документирования.

Результат

Создаёт: datarim/prd/PRD-{slug}.md. Опционально обновляет datarim/backlog.md.

Структура PRD

  • Контекст и анализ существующего кода
  • Технический подход с выбранным решением и рассмотренными альтернативами
  • Риски безопасности и технические риски со стратегиями митигации
  • Измеримые критерии успеха

Пример сессии

> /dr-prd "Система уведомлений в реальном времени"

Фаза 1: Анализ контекста...
  Прочитаны: projectbrief.md, techContext.md, systemPatterns.md
  Найдено: Express.js бэкенд, React фронтенд, нет WebSocket

Фаза 1.5: Интервью
  В: Должны ли уведомления сохраняться между сессиями?
  В: Ожидаемый объём — десятки или тысячи в минуту?

Фаза 2: Исследование решений...
  Вариант A: WebSocket через Socket.io
  Вариант B: Server-Sent Events (SSE)
  Вариант C: Polling с long-poll fallback

  Рекомендация: Вариант A

PRD сохранён: datarim/prd/PRD-notification-system.md

Связанные команды

  • /dr-init — должна быть выполнена до /dr-prd
  • /dr-plan — следующий этап: планирование реализации
  • /dr-design — углублённое проектирование для L3-4