Шаблон PRD: как описать задачу, чтобы агент собрал нужное с первого раза

Почему агент собирает не то

Типичная просьба выглядит так: «сделай лендинг для магазина». Агент получает четыре слова и достраивает остальное сам — из усреднённого интернета. Стек выбирается наугад, аудитория придумывается, появляются три страницы, которых никто не просил. Формально задача закрыта. По факту переделывать всё.

Разрыв тут в контексте. У вас в голове лежит: кто клиент, какие позиции в поиске нельзя потерять, почему выбран именно этот стек, что уже готово и что отложено сознательно. Агент видит одну строку промпта.

PRD закрывает этот разрыв. Это файл в корне проекта, который агент читает до того, как начнёт писать код.

Шаблон

Копируется в корень проекта как PRD.md и заполняется руками.

# [Название] — PRD

## Что это
[2-3 предложения: что делает продукт и для кого]

## Статус
[В разработке / MVP / Работает / Заброшен]

## Фичи
- [x] Фича которая есть
- [x] Ещё одна готовая
- [ ] Планируется
- [ ] Когда-нибудь

## Аудитория
[Кто пользуется или будет пользоваться]

## Монетизация
[Как зарабатывает или планирует. "Нет" тоже ответ]

## Ключевые решения
[Почему выбран этот стек/подход/архитектура — то что не очевидно из кода]

## Обновлено
[Дата последнего обновления]

Восемь блоков, пятнадцать минут на заполнение. Дальше файл окупается на каждой задаче.

Что даёт каждый блок

Что это. Два-три предложения. Агент получает рамку: интернет-магазин, внутренняя утилита или блог. От этого зависит всё дальнейшее — от структуры папок до того, нужна ли вообще авторизация.

Статус. Слово «MVP» экономит десятки правок. Агент перестаёт добавлять мониторинг, тесты на каждую функцию и обработку краевых случаев в прототип, который проживёт неделю. Слово «Работает» включает обратное поведение: осторожность и совместимость с тем, что уже крутится в проде.

Фичи чекбоксами. Главный блок. [x] читается агентом как «есть, не трогай». [ ] — как «в планах, сейчас не делай». Без этого списка агент регулярно переписывает работающий код, потому что ему показалось красивее.

Аудитория. Определяет язык интерфейса, сложность формулировок, приоритет мобильной вёрстки. «Продавцы неоновых вывесок» и «разработчики» — это два разных продукта с одинаковой логикой внутри.

Монетизация. Влияет на архитектуру сильнее, чем кажется. Подписка означает биллинг и личный кабинет. Разовая оплата — платёжный шлюз и статусы заказа. «Нет» освобождает от целого слоя кода.

Ключевые решения. Самый ценный раздел и самый пропускаемый. Сюда пишется то, чего в коде не видно. Пример из моей миграции neon.boutique с Тильды на Astro: сайт держит топовые позиции в Google по коммерческим запросам, терять их нельзя ни при каком раскладе. Одна эта строчка меняет поведение агента радикально — он сохраняет структуру URL, переносит заголовки дословно, перестаёт выкидывать страницы «за ненадобностью». Без неё получается технически красивый сайт с обнулённым трафиком.

Туда же идут ответы на «почему так»: почему выбран этот фреймворк, почему бэкенд headless, почему платёжка именно такая. Агент, который видит причину, перестаёт спорить с решением и предлагать «более современный» вариант в каждом втором ответе.

Обновлено. Дата. Устаревший PRD врёт агенту с той же уверенностью, с какой актуальный говорит правду. Поле с датой даёт повод перечитать файл перед большой задачей.

Как проверить, что PRD рабочий

Тест первый: дайте агенту прочитать файл и попросите пересказать своими словами, что за продукт и что делать дальше. Пересказ покажет дыры быстрее любого чек-листа. Там, где агент начинает домысливать детали, блок заполнен слишком общо.

Тест второй — на объём. PRD длиннее полутора экранов читается хуже. Всё, что не влияет на решения агента, из файла вычищается.

Границы жанра

PRD описывает продукт. План реализации живёт отдельным документом, с задачами, порядком и техническими деталями. У меня на проекте это два файла: PRD.md отвечает на «что и зачем», implementation plan — на «как и в какой последовательности». Смешивать их вредно: продуктовая часть меняется редко, план переписывается постоянно.

И последнее. PRD пишется человеком. Соблазн попросить агента сгенерировать документ по коду велик, результат предсказуем — красивый пересказ того, что агент и так видит в файлах. Ценность PRD ровно в том, чего в коде нет.