Prompts
Prompts — заготовленные workflow для AI-агентов. В отличие от tools (атомарные операции), prompts управляют последовательностью действий и задают сценарий взаимодействия с пользователем.
В клиентах AI (Claude Code, Claude Desktop) prompts появляются как slash-команды: /site-pipeline, /block-builder и т.п. После выбора prompt'а AI следует заложенному в нём сценарию.
Список встроенных prompts
В текущей версии MCP-сервера зарегистрировано 7 prompts. Полный исходный текст каждого живёт в mcp-server/src/prompts/*.md.
| Prompt | Параметры | Назначение |
|---|---|---|
site-pipeline | { brief } — описание сайта | Полный пайплайн создания сайта от требований до тестирования |
block-builder | { task } — что за блок создать | Пошаговый workflow для создания блока и размещения его на странице |
backend-decompose | — | Декомпозиция готовых HTML-прототипов в CMS-сущности через MCP |
project-sync | — | Опрос всех сущностей CMS и генерация полной документации PROJECT.md |
conventions | — | Quick-reference по конвенциям Templite: типы полей, naming, Blade-синтаксис, SCSS-паттерны |
designer | { niche } — ниша сайта | Создание визуального дизайн-брифа DESIGN_BRIEF.md (цвета, типографика, UI) |
frontend-proto | — | Создание self-contained HTML-прототипов с разметкой под последующую декомпозицию |
site-pipeline
Параметры: brief — короткое описание сайта (например, «сайт стоматологической клиники Dental+ в Москве»).
Что делает: запускает полный цикл создания сайта:
- Запрашивает уточнения по требованиям (через диалог).
- Создаёт структуру: настройки → шаблоны → блоки → страницы.
- Наполняет страницы контентом.
- Применяет дизайн (если есть бриф) или предлагает дизайнерский prompt.
- Прогоняет финальную проверку.
Когда использовать: новый проект с нуля или MVP за час.
block-builder
Параметры: task — что за блок нужен (например, «блок преимуществ с 4 карточками»).
Что делает: создание одного блока шаг за шагом:
- Уточняет тип блока (
block_type_id) и назначение. - Предлагает структуру полей — пользователь корректирует.
- Создаёт блок через
create_blockс полями. - Генерирует Blade-шаблон и SCSS-стили.
- Регистрирует библиотеки, если нужны.
- Размещает блок на демо-странице для проверки.
Когда использовать: нужен один новый блок, не хочется самому продумывать структуру.
backend-decompose
Без параметров.
Что делает: строгий порядок декомпозиции готовых HTML-прототипов в CMS-сущности:
- Libraries —
create_library(CDN-шрифты, скрипты). - Global Fields — структура и значения настроек.
- Components — header, footer и т.п. через
create_component. - Templates —
create_template+update_template_code(полный HTML с<x-cms::meta-tags>, assets-loop,@yield('blocks')). - Blocks —
create_block→add_block_field→update_block_code. - Pages —
create_page→add_block_to_pageс реальными данными. - Cities (если мультигород) —
create_city→update_city_page/materialize_city_page. - Languages (если мультиязычность) —
create_language→save_*_translation. - User types (если регистрация) —
create_user_type+create_user_field. - Cache & assets —
clear_cache→compile_all_assets.
Когда использовать: есть готовые HTML-макеты, нужно перенести их в Templite.
project-sync
Без параметров.
Что делает:
- Опрашивает все сущности через MCP-tools (
list_blocks,list_pages,get_settings, и т.п.). - Генерирует комплексный
PROJECT.mdс текущим состоянием CMS: структура контента, использованные шаблоны, типы блоков, языки/города.
Когда использовать: документация устарела или нужна актуальная картина перед демо клиенту.
conventions
Без параметров.
Что делает: выводит quick-reference со всеми конвенциями Templite:
- Naming: slug блока (kebab-case), key поля (snake_case), slug компонента.
block_type_id(1-4): Content / Media / Navigation / Forms.- 18 типов полей (точный список).
- Blade-синтаксис:
{{ $fields['key'] }},<x-cms::image>, repeater через@foreach. - SCSS-паттерны: BEM, namespace
.cms-block--{slug}.
Когда использовать: AI забыл какую-то конвенцию и не следует ей; вы хотите дать агенту чек-лист стандартов перед сложной задачей.
designer
Параметры: niche — ниша сайта (например, «стоматология», «IT-компания», «ресторан»).
Что делает:
- На основе ниши предлагает дизайн-направление: цветовая палитра, типографика, тон.
- Описывает UI-компоненты (header-варианты, hero-блоки, секции).
- Сохраняет результат в
DESIGN_BRIEF.md— этот файл потом подаётся вblock-builderдля генерации стилей блоков.
Когда использовать: нужен дизайн-бриф перед началом разработки сайта (часто запускается из site-pipeline).
frontend-proto
Без параметров.
Что делает:
- Принимает описание блока или страницы.
- Генерирует self-contained HTML-прототип с inline-стилями (без зависимостей от CMS).
- Прототип содержит разметку для последующей декомпозиции на блоки CMS — комментарии
<!-- block:slug -->,data-block-slug,data-field-key.
Когда использовать: нужно превью макета до создания CMS-сущностей.
Использование
В Claude Code, Claude Desktop
Slash-команда в чате:
/site-pipelineЕсли у prompt есть параметры — AI запросит их прямо в диалоге.
Источник prompts
Все 7 prompts хранятся в mcp-server/src/prompts/*.md. Каждый файл — Markdown-инструкция, которая загружается с подстановкой плейсхолдеров (, , и т.п.) и отправляется AI-агенту как первое сообщение.
Добавление кастомных prompts
В текущей версии MCP-сервер регистрирует только встроенные prompts. Чтобы добавить свой — нужно форкнуть пакет, дописать markdown в src/prompts/, зарегистрировать в src/prompts.js через server.prompt(...), опубликовать как собственный npm-пакет либо собрать локально.
Подводные камни
Подводные камни
- Workflow prompt'ов потребляет много токенов AI.
site-pipelineдля полноценного сайта легко вызывает 100+ tool-вызовов. Следите за rate-limits AI-провайдера. - Имена prompts могут конфликтовать со встроенными slash-командами клиента. У Claude Code, например, есть
/help,/clear— наши prompts используют другие имена и не конфликтуют. - Prompt — это просто заранее заготовленный первый message. После запуска агент действует по своему обычному режиму. Если он сильно отклонился — корректируйте обычными сообщениями в чате.
conventionsстоит запускать перед сложными задачами — помогает AI не забывать про snake_case, kebab-case, реальные имена компонентов и пр.testerиanalystprompts — НЕ существуют. Они упоминались в старой версии документации (моя ошибка). Используйтеsite-pipelineилиconventionsдля тех же задач.