---
title: "PRODUCT.md: описание продукта для AI-агентов"
description: Как описать аудиторию, задачу, предложение и границы продукта в PRODUCT.md и связать файл с дизайн- и маркетинговыми контрактами.
---

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

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

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

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

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

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

Тон бренда и дизайн-принципы можно описать на уровне, нужном для понимания продукта. Подробные правила визуальной реализации храните в [DESIGN.md](https://wpcraft.ru/kb/design/ai/design-md.md), а каналы, кампании и автономность маркетинга — в [MARKETING.md](https://wpcraft.ru/kb/marketing/ai/marketing-md.md).

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

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

## 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` | Как агенту работать с репозиторием и выполнять задачи? |

Связанные материалы: [Контекст для агентов](https://wpcraft.ru/kb/ai/context.md), [ИИ-дизайн](https://wpcraft.ru/kb/design/ai.md), [ИИ-агенты в маркетинге](https://wpcraft.ru/kb/marketing/ai.md), [процесс разработки с ИИ](https://wpcraft.ru/kb/ai/coding.md).

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

- [PRODUCT.md — открытая спецификация и описание формата](https://product.md/)