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

Reverse prompting: як відновити PRD та архітектуру за існуючим фронтендом

@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