Blueprints — готовые решения типовых модулей

Агентно-ориентированные спецификации: что и как создавать при реализации типовой фичи. Не готовый код (код генерируется под проект), а точный рецепт: схема данных, правила, шаги, чеклист приёмки. Следование blueprint = результат по стандартам студии с первого раза.

Как пользоваться (инструкция для Claude Code)

1. Перед реализацией типовой фичи — проверить таблицу ниже. Совпадение по смыслу (не только по названию) → читать blueprint целиком и следовать ему.
2. Blueprint дополняет specs/*.md, не заменяет: конфликт решается в пользу CLAUDE.md → specs/*.md → blueprint.
3. Отклонения от blueprint допустимы по требованиям ТЗ — но осознанные: назвать их пользователю при сдаче.
4. Схемы данных — минимальный обязательный состав; поля из ТЗ добавляются сверху.
5. Чеклист приёмки в конце каждого blueprint — прогнать перед «готово».

Каталог

Blueprint	Модуль	Сигналы в ТЗ
leads.md	Заявки с форм	«форма обратной связи», «заказать звонок», «оставить заявку», «квиз»
pages.md	Контентные страницы	«страницы редактируются в админке», «о компании», «текстовые страницы»
settings.md	Настройки сайта	«телефон/адрес меняются в админке», «реквизиты», «соцсети в футере»
reviews.md	Отзывы	«отзывы клиентов», «рейтинг», «оценки с модерацией»
blog.md	Блог / новости	«новости», «статьи», «блог», «полезные материалы»
catalog.md	Каталог с категориями	«каталог услуг/товаров», «категории и карточки», «фильтры»
multicity.md	Мультигород	«сайт для нескольких городов», «поддомены городов», «цены по городам»

Формат blueprint

Каждый файл строится одинаково — агент может полагаться на структуру:

1. Когда применять — сигналы из ТЗ и границы применимости.
2. Состав решения — какие файлы создаются (модели, миграции, ресурсы, компоненты, тесты).
3. Схема данных — таблицы: столбец, тип, индекс, cast. Обязательный минимум.
4. Правила реализации — ключевые решения и нюансы со ссылками на specs.
5. Пакеты — что подключить (и чего не подключать).
6. Шаги — порядок работы для агента.
7. Чеклист приёмки — проверки перед сдачей.

Связь с остальной документацией

• Обязательные правила: CLAUDE.md и specs/ — всегда приоритетнее.
• Комбинации пакетов под задачи шире модулей: docs-site/docs/guide/recipes.md (на сайте — «Готовые связки под задачи»).
• Выбор больших платформ (CMS, магазины): opensource/.

Как добавлять новый blueprint

Модуль повторился во 2-м проекте и ожидается в 3-м → он типовой → оформить blueprint: взять фактическую реализацию лучшего из двух проектов, описать по формату выше, проверить на следующем проекте, поправить по итогам. Blueprint без обкатки на реальном проекте не добавлять.