Паспорт продукта
Что такое паспорт продукта
Паспорт продукта — набор файлов в вашем репозитории: AGENTS.md и CLAUDE.md в корне и папка docs/. Агент читает их перед каждой задачей и дополняет после каждой правки — так он понимает, как себя вести с продуктом.
01
Назначение и пользователи
Кто пользуется продуктом, какую задачу он решает, где границы. Агент читает, чтобы предлагать решения в вашем контексте, а не абстрактно.
02
Карта модулей
Из каких частей состоит продукт и как они связаны: где лежит код, что с чем взаимодействует. Агент ориентируется, какую часть трогать в задаче.
03
Глоссарий
Термины предметной области, сокращения, названия ролей и сущностей. Агент говорит с командой на одном языке и не путает понятия.
04
Контракты и данные
Форматы запросов и ответов, схемы данных, внешние интеграции и их версии. Агент сверяет правку с контрактами и понимает, какие поля обязательны.
05
Правила кода
Соглашения проекта: стиль, структура, запрещённые приёмы, требования к оформлению. Агент пишет код в стиле репозитория, а не по-своему.
06
Сборка и тесты
Команды сборки, проверок и запуска, что считается зелёным результатом. Агент прогоняет их после правки и сдаёт только проверенное.
07
Окружения
Локальная, тестовая и боевая среды, адреса сервисов, какие доступы и переменные окружения нужны (сами секреты в паспорт не пишутся). Агент знает, где смотреть результат своей работы.
08
Красные зоны
Оплата, права доступа и миграции данных — только с согласования человека. Агент останавливается и спрашивает, прежде чем идти туда.
09
Критерии готовности
Признаки того, что задача сделана: список проверок, по которым принимается работа. Агент сверяется с ними до сдачи.
10
Выкладка и откат
Порядок выпуска версии и способ вернуть предыдущую, если что-то пошло не так. Агент знает, как довести правку до пользователей безопасно.
11
Журнал решений
Почему принято то или иное решение, что уже пробовали и отказались. Агент не повторяет тупиковые пути и понимает ограничения.
12
Ловушки
Известные грабли проекта: типичные ошибки и способы их обойти. Агент предупреждён заранее и не наступает на них повторно.