v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T09:16:00.000Z▲ 0 upvotes

Reverse Prompting: So stellen Sie PRD und Architektur mithilfe eines vorhandenen Frontends wieder her

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Когда это нужно

Вам достался фронтенд без документации: 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 даст больше, чем ещё несколько итераций промптов.

Обсуждение (0)

Ещё на vbcd4u.com