Reverse prompting: как восстановить PRD и архитектуру по существующему фронтенду
Когда это нужно
Вам достался фронтенд без документации: legacy-проект, который нужно переписать, MVP подрядчика или собственный код двухлетней давности. Прежде чем что-то менять, нужно понять, что продукт делает: какие экраны, какие сценарии, какие правила валидации, какие API он вызывает. Reverse prompting — это сбор фактов из кода и передача их модели с задачей восстановить требования.
Речь о коде, к которому у вас есть законный доступ. Восстанавливать требования чужого продукта по его минифицированному бандлу ради копирования — путь к юридическим проблемам и к плохому результату: из бандла не видно, почему продукт устроен именно так.
Почему «прочитай репозиторий и напиши ТЗ» не работает
На проекте в сотни файлов агент либо не дочитает его до конца, либо заполнит контекст исходниками и начнёт обобщать по первым попавшимся файлам. В итоге PRD описывает три экрана из двадцати и уверенно придумывает остальное. Нужен промежуточный слой: сжатая инвентаризация, которую вы соберёте скриптами и проверите.
Шаг 1. Инвентаризация маршрутов
Для Next.js App Router:
find app -name 'page.tsx' -o -name 'page.jsx' | sed 's#/page\.[jt]sx$##; s#^app##' | sort > docs/re/routes.txt find app -name 'route.ts' | sort > docs/re/api-routes.txt
Для React Router найдите объявления маршрутов:
grep -rn --include='*.tsx' -E 'path:\s*"|<Route ' src | sort > docs/re/routes.txt
Шаг 2. Сетевые вызовы
grep -rnE --include='*.ts' --include='*.tsx' \ 'fetch\(|axios\.(get|post|put|patch|delete)|useQuery|useMutation' src app \ > docs/re/network-calls.txt
Статический поиск не видит URL, собранные динамически. Дополните его реальным трафиком: пройдите основные сценарии в браузере с открытой вкладкой Network и сохраните HAR. Перед передачей модели вычистите из HAR cookies, токены авторизации и персональные данные.
Шаг 3. Формы и правила валидации
grep -rnE --include='*.ts' --include='*.tsx' \ 'z\.object|yup\.object|useForm\(|required:|pattern:' src app > docs/re/validation.txt
Схемы валидации — самый плотный источник бизнес-правил: минимальные длины, форматы телефонов, обязательные поля, зависимости между полями.
Шаг 4. Передача модели по частям
Не отправляйте всё сразу. Сначала карта продукта:
Ниже список маршрутов приложения и список сетевых вызовов с путями к файлам. Составь карту продукта: 1. Группы экранов по пользовательским задачам. 2. Для каждого экрана: назначение, откуда на него попадают, какие API вызывает. 3. Роли пользователей, если их можно вывести из маршрутов (admin, dashboard и т.п.). Правила: - Каждое утверждение помечай [код: путь/к/файлу] или [гипотеза]. - Если назначение экрана неочевидно из названия и вызовов, напиши "не определено" и укажи, какой файл нужно прочитать, чтобы это выяснить. - Не придумывай функциональность, которой нет во входных данных.
Затем по каждой группе экранов — отдельный запрос с исходниками только этих файлов и задачей описать сценарии, состояния (пусто, загрузка, ошибка, нет прав) и правила валидации.
Шаг 5. Сборка PRD
Итоговый документ полезно держать в фиксированной структуре, чтобы его можно было сравнивать между итерациями:
# PRD: <продукт> (восстановлен по коду, дата) ## Пользователи и роли ## Сценарии ### <Сценарий>: шаги, экраны, API, правила, ошибки ## Модель данных (по ответам API и типам) ## Внешние интеграции ## Нефункциональные наблюдения (авторизация, кеширование, i18n) ## Открытые вопросы ## Расхождения и подозрительные места
Раздел с расхождениями часто оказывается самым ценным: валидация на клиенте, которой нет на сервере; экраны без ссылок на них; API-вызовы, ответ которых нигде не используется.
Шаг 6. Проверка
Модель уверенно пишет правдоподобные вещи. Проверка обязательна:
- Возьмите случайные пять утверждений с пометкой
[код: ...]и откройте указанные файлы. - Все пункты
[гипотеза]либо подтвердите у владельца продукта, либо перенесите в открытые вопросы. - Пройдите руками один сценарий по PRD — от входа до результата. Если шаги не совпадают с реальностью, вернитесь к соответствующей группе экранов.
Архитектура отдельно от требований
Описание архитектуры (слои, управление состоянием, работа с данными) — другая задача с другим входом: дерево каталогов, package.json, конфиги сборки, несколько характерных файлов каждого типа. Не смешивайте её с PRD в одном запросе: модель начнёт описывать технические детали вместо поведения продукта.
Ограничения подхода
Код показывает, что продукт делает, но не почему. Бизнес-причины, юридические требования, договорённости с партнёрами из фронтенда не восстановить. Логика на бэкенде, к которому у вас нет доступа, видна только по форме запросов и ответов. Если владелец продукта доступен, час разговора с ним по готовому черновику PRD даст больше, чем ещё несколько итераций промптов.
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.