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 дасть більше, ніж ще кілька ітерацій промптів.