Skip to content

AI-Optimized PRD: документ требований для AI-агентов

В 2026 году PRD читают не только люди, но и AI-агенты. Cursor, Claude Code, Bolt и другие инструменты AI-кодинга используют PRD как набор инструкций: что строить, в каком порядке, с какими ограничениями. Для этого стандартный PRD нужно адаптировать — написать так, чтобы и человек, и AI-агент получили из него нужную информацию.

Чем отличается от стандартного PRD

ПараметрStandard PRDAI-Optimized PRD
АудиторияЛюди (команда)Люди + AI-агенты
Структура13 секций, свободный форматФазы с зависимостями
СкоупIN/OUT таблицаBounded scope в каждой фазе
ВыходыSuccess Metrics общиеТестируемый выход на каждую фазу
Объём5-15 страниц3-8 страниц
ТребованияПриоритеты P0/P1/P2Последовательность фаз (Phase 1 → Phase 2 → …)
Технические деталиМинимальныеСтек, версии, API-контракты

Key insight

Ключевое отличие — фазовая структура. Стандартный PRD описывает продукт целиком, оставляя команде свободу в порядке реализации. AI-Optimized PRD разбивает реализацию на последовательные фазы, каждая из которых имеет ограниченный скоуп, явные зависимости и тестируемый результат.

Структура AI-Optimized PRD

Шапка документа

Как и в стандартном PRD: Problem Statement, Target Users, Proposed Solution, Success Metrics. Эта часть написана для людей — в прозе, с контекстом и обоснованием.

Технические ограничения

Секция, которой нет в стандартном PRD. AI-агент должен знать:

  • Стек: языки, фреймворки, версии (например: «Next.js 15, TypeScript, Supabase»)
  • Существующая кодовая база: какие файлы и паттерны уже существуют
  • API-контракты: внешние сервисы, форматы данных
  • Запреты: что AI-агент не должен делать (менять схему БД, трогать auth, устанавливать новые зависимости)

Фазы реализации

Каждая фаза — самодостаточный блок работы:

## Phase 1: [Название]

**Dependencies:** None (или Phase N)
**Scope:** Что входит в эту фазу
**Out of scope:** Что явно НЕ входит

**Tasks:**
1. Создать модель данных для X
2. Реализовать API endpoint /api/x
3. Написать тест для endpoint

**Testable output:** Что можно проверить после завершения
- API endpoint возвращает 200 с корректными данными
- Тест проходит
- Миграция БД применяется без ошибок

Что НЕ делать (AI Instructions)

Явные запреты для AI-агента:

  • Не менять существующие файлы, которые не упомянуты в задаче
  • Не устанавливать зависимости без явного указания
  • Не создавать файлы за пределами указанных директорий
  • Не менять конфигурацию деплоя

Зачем нужен отдельный формат

Стандартный PRD описывает «что», оставляя «как» инженерам. Когда инженер — человек, это работает: он понимает контекст, задаёт уточняющие вопросы, принимает решения на основе опыта.

AI-агент работает иначе. Он выполняет инструкции буквально и нуждается в:

  • Чётких границах: что делать и что не делать в каждой фазе
  • Последовательности: какие фазы зависят от каких
  • Тестируемых результатах: как проверить, что фаза выполнена корректно
  • Техническом контексте: стек, версии, существующие паттерны

Key insight

Без этих элементов AI-агент либо сгенерирует код, несовместимый с кодовой базой, либо выйдет за рамки скоупа, либо пропустит критически важные ограничения.

Пример фрагмента

# Task Manager MVP — AI-Optimized PRD

## Problem
Команде нужен инструмент для отслеживания задач.
Текущее решение — Google Sheets — не масштабируется.

## Technical Constraints
- Stack: Next.js 15, TypeScript, Supabase
- Auth: уже настроен через Supabase Auth (не трогать)
- Styling: Tailwind CSS, существующий design system в /components/ui/
- DB: Supabase PostgreSQL, миграции через supabase migration

## Phase 1: Data model + API

**Dependencies:** None
**Scope:** Создать таблицу tasks и CRUD API

**Tasks:**
1. Создать миграцию: таблица tasks (id, title, status, assignee, created_at)
2. Реализовать API routes: GET /api/tasks, POST /api/tasks, PATCH /api/tasks/[id]
3. Добавить RLS policies для tasks

**Testable output:**
- Миграция применяется: `supabase db push` без ошибок
- GET /api/tasks возвращает пустой массив (200)
- POST /api/tasks создаёт задачу и возвращает её (201)

**Out of scope:** UI, фильтрация, поиск

## Phase 2: Basic UI
**Dependencies:** Phase 1
...

Когда использовать

AI-Optimized PRD уместен, когда:

  • Вы работаете с AI-агентом (Cursor, Claude Code, Bolt, Copilot Workspace)
  • Проект имеет чёткий стек и существующую кодовую базу
  • Задачу можно разбить на три — семь последовательных фаз
  • Каждая фаза имеет проверяемый результат

Если проект находится на стадии идеи и стек не определён, начните со стандартного PRD или MVP PRD, а AI-Optimized PRD напишите, когда архитектурные решения приняты.

Dual-audience подход

На практике AI-Optimized PRD часто содержит два слоя:

  1. Для людей — верхняя часть документа: Problem Statement, Target Users, Success Metrics. Написана в прозе, объясняет «зачем».
  2. Для AI-агента — нижняя часть: Technical Constraints, Phases, AI Instructions. Структурирована, конкретна, без риторики.

Key insight

Такой формат позволяет использовать один документ и для alignment команды, и как прямой вход для AI-кодинга.

Ресурсы