PRODUCT.md: описание продукта для AI-агентов

Зачем нужен PRODUCT.md

PRODUCT.md — предлагаемое авторами product.md описание продукта в Markdown для команды и AI-агентов. Оно помогает дать ассистенту контекст о том, для кого создан продукт, какую задачу он решает, как устроено предложение и где проходят его границы. Авторы также предлагают публиковать тот же файл по адресу /product.md, чтобы его могли прочитать внешние агенты.

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

Что описывать

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

• Продукт и режим — название; авторы предлагают различать продукт и бренд.
• Пользователи — кто узнает себя в описании и в каком контексте использует продукт.
• Проблема и назначение — какая задача решается и по каким признакам оценивается результат.
• Предложение — что получает клиент и сколько это стоит; структурированные данные о цене можно добавить отдельным JSON-блоком.
• Границы — чего продукт не делает и какие варианты исключены.
• Ссылки на соседние документы — AGENTS.md для инструкций агенту, DESIGN.md для визуальной системы, MARKETING.md для маркетинговых правил.

Тон бренда и дизайн-принципы можно описать на уровне, нужном для понимания продукта. Подробные правила визуальной реализации храните в DESIGN.md, а каналы, кампании и автономность маркетинга — в MARKETING.md.

Минимальный шаблон

# Название продукта
Краткое описание результата для пользователя.

## Register
product

## Users
Кто использует продукт и в какой ситуации.

## Problem
Какую конкретную проблему решает продукт.

## Product Purpose
Что делает продукт и как выглядит успешный результат.

## Offer
Что входит в предложение и сколько оно стоит.

## Boundaries
- Чего продукт не делает.

## Stack
- AGENTS.md
- DESIGN.md
- MARKETING.md

Названия секций в шаблоне — отправная точка, а не гарантия совместимости со всеми инструментами. Если цена или лимиты должны обрабатываться автоматически, храните структурированные значения в валидном машиночитаемом блоке и проверяйте их отдельным инструментом.

Где хранить и публиковать

Для разработки файл можно хранить в корне репозитория рядом с контекстными документами проекта. Публичную копию по адресу /product.md стоит публиковать только если эти сведения предназначены для внешней аудитории. Проверьте, что опубликованные цены, ограничения и описание пользователей актуальны и не раскрывают внутреннюю информацию.

Рабочий цикл:

1. Зафиксируйте продуктовые факты и границы, согласованные с владельцем продукта.
2. Добавьте ссылки на отдельные документы с правилами для агентов.
3. Используйте файл в задачах, где ассистенту нужен продуктовый контекст.
4. Обновляйте его вместе с изменением аудитории, предложения и позиционирования.
5. Сверяйте публичную и репозиторную копии, если поддерживаете обе.

Как соотносятся контракты

Документ	Отвечает на вопрос
PRODUCT.md	Для кого продукт, какую задачу решает и что предлагает?
DESIGN.md	Как должны выглядеть и вести себя интерфейсы?
MARKETING.md	Как продвигать продукт и какие правила ограничивают маркетинговые действия?
AGENTS.md	Как агенту работать с репозиторием и выполнять задачи?

Связанные материалы: Контекст для агентов, ИИ-дизайн, ИИ-агенты в маркетинге, процесс разработки с ИИ.

Материалы и источники

• PRODUCT.md — открытая спецификация и описание формата