Кобра каталог сценариев
Выпуск #11 · Мастерская
Обложка: Артемий держит новую чешуйку, у кобры пустое гнездо
← Все выпуски
Сценарий использования №11

Дело о новой
чешуйке

Самый технический выпуск серии: Артемий выращивает новую Чешуйку — от чужой боли в рабочем чате до модуля, который щёлкает на бок Кобре. Шесть кадров и пошаговый рецепт: что делать, в каком порядке и где обычно ломается.

На выходе — «Пульс клиента»: Чешуйка, которая спрашивает клиентов, как им с нами, и превращает ответы в кейсы. ↓

Действующие лица
Артемий
Артемий
Мастер Чешуек. Ювелирная лупа на лбу, инструменты в кармане, третья Чешуйка на подходе.
Чувствует: зуд в руках — «эту дырку в процессе можно закрыть за два вечера».
Страница героя: Артемий →
Айфрейм
Айфрейм
Дверь для нового: даёт Чешуйке лицо внутри Кобры.
Чувствует: гостеприимство — «заходите, тут ваша комната».
Механизм: Айфрейм →
Гриф
Гриф
Страж доступов. Без его печати на манифесте Чешуйка не выйдет к людям.
Чувствует: принципиальность — «покажите, кто и что будет видеть».
Вселенная: все герои →
Пульс клиента
Пульс клиента
Та самая новая Чешуйка: собирает обратную связь и считает, как клиенты нас переносят.
Чувствует: любопытство — «ну как вам? честно можно».
Сцена: два вечера в мастерской
Понедельник. Планёрка, на которой рождаются Чешуйки.
Николай жалуется: закрытые проекты без обратной связи
НиколайМы закрыли восемь проектов. Кто из клиентов доволен — не знает никто.
Шаг 1 · Боль

Задача приходит из чата, а не из брифа

Проекты закрываются, а обратная связь остаётся в головах: кто-то доволен, кто-то тихо ушёл. Никто не спрашивает клиентов системно — потому что «это же неудобно, а руками некогда».

Артемий слушает и формулирует за минуту: кому больно (аккаунты и продажи), что должно случиться (после закрытия проекта клиента спрашивают, ответ сохраняется и превращается в цифру и в кейс), кто будет пользоваться (аккаунты, Олег, контент-завод).

Правило мастерской: Чешуйка растёт из боли, а не из идеи. Нет живой жалобы — нет модуля.
Вечер первый. Верстак, лупа, чистый лист.
Артемий чертит эскиз экранов и прав
Эскиз!
Шаг 2 · Эскиз

Три экрана и один список прав

Прежде чем писать код — карандаш. Артемий рисует ровно три экрана: лента отзывов, карточка клиента с историей оценок и настройки опроса (когда спрашивать, как часто, что не спрашивать никогда).

Рядом на полях — самое важное: какие данные нужны (закрытые задачи, чаты с клиентами, карточки проектов) и кто что видит (аккаунт — своих клиентов, Олег — всех, клиент — только себя).

Дисциплина: если экранов больше трёх — это не Чешуйка, а отдельный продукт. Режем.
Лицо модуля: стекло вставляется в оправу.
Артемий вставляет экран-интерфейс в чешуйку, Айфрейм придерживает
Клац!
Шаг 3 · Интерфейс

IFrame-страница — лицо Чешуйки

Интерфейс — обычное веб-приложение: три экрана из эскиза, любая ваша технология. Единственное требование — уметь жить внутри чужого окна: Айфрейм встроит страницу прямо в Кобру, подставив тему, язык и текущего пользователя.

Артемий сразу проверяет главное: как это выглядит в узкой боковой панели (Доковый ВебАпп) и в телефоне (Карманный). Модуль обязан быть красивым в обоих домах.

Проверка на зрелость: открыл в панели рядом с чатом — и всё читается. Не читается — переделывай.
Вечер второй. Самое интересное — руки.
Артемий прикручивает MCP-руки к чешуйке
Вж-ж!
Шаг 4 · MCP-руки

Свой MCP-сервер: что модуль умеет делать

Интерфейс — для людей, MCP — для агентов. Артемий описывает инструменты Чешуйки простым списком: list_feedback, request_feedback, get_client_score, export_case. Теперь Алина умеет то же, что человек в интерфейсе, — и может делать это по расписанию или по просьбе в чате.

Ключевой момент: инструменты формулируются глаголами бизнеса, а не эндпойнтами. Агент должен понимать «спроси клиента об этом проекте», а не «сделай POST в /api/v2/surveys».

Здесь Чешуйка перестаёт быть страничкой: у неё появляются руки, которыми пользуется вся вселенная.
Экзамен. Гриф не подписывает не глядя.
Гриф проверяет манифест и ставит печать
Печать!
Шаг 5 · Манифест и права

Имя, иконка, доступы

Манифест — паспорт Чешуйки: как называется, какая иконка, где показывается (папка проекта, чат, меню), какие данные читает и какие действия совершает. Гриф проверяет по списку: клиент видит только свои оценки, аккаунт — своих клиентов, персональные ответы не утекают в общий канал.

Не сошлось — печати нет. Артемий переделывает область видимости и приходит снова: у Грифа с этим строго.

Смысл шага: модуль может всё, что разрешено, и ничего сверх. Один раз описал — дальше система следит сама.
Щелчок — и у Кобры новая способность.
Чешуйка встаёт на место, соседние светятся
Готово!
Шаг 6 · Пилот и жизнь

Сначала один проект, потом все

Чешуйка включается на одном проекте: Хронос вешает расписание («через три дня после закрытия — спросить»), Артемий смотрит первые ответы и правит формулировки. Через неделю — включение для всех, и модуль занимает своё гнездо на боку Кобры.

Дальше начинается самое приятное: соседние Чешуйки замечают новенькую. Контент-Завод забирает лучшие отзывы себе в кейсы, аккаунты видят падение оценки раньше, чем клиент начнёт остывать.

Итог двух вечеров: во вселенной стало на одну способность больше — и никто не переписывал ядро.
Рецепт: как вырастить свою Чешуйку
Шаги 1–4 · мастерская
1Найдите боль. Живая жалоба в рабочем чате: что делают руками, что теряется, о чём никто не знает. Сформулируйте: кому больно, что должно случиться, кто будет пользоваться.
2Нарисуйте три экрана. Не больше. Плюс список данных, которые нужны, и список ролей: кто что видит. Больше трёх экранов — это уже отдельный продукт.
3Соберите интерфейс. Обычное веб-приложение на любом стеке; Айфрейм встроит его внутрь Кобры с темой, языком и пользователем. Проверьте в узкой панели и в телефоне.
4Прикрутите MCP-руки. Свой MCP-сервер с инструментами, названными глаголами бизнеса: «спроси клиента», «покажи оценки», «сделай кейс». Это то, чем будут пользоваться агенты.
Шаги 5–8 · выход в мир
5Напишите манифест. Имя, иконка, точки показа (папка, чат, меню), читаемые данные и совершаемые действия — и отнесите Грифу за печатью прав.
6Прогоните в песочнице. Тестовое пространство: проверьте пустые состояния, отказы прав и то, что модуль не роняет Кобру, если его сервер прилёг.
7Запустите пилот на одном проекте. Хронос вешает расписание, вы правите формулировки по первым живым ответам. Неделя — и включаете всем.
8Свяжите с соседями. Отдайте данные другим Чешуйкам и агентам: отзывы — Контент-Заводу, сигналы — аккаунтам. Чешуйка, которая живёт одна, быстро засыхает.

Два вечера у Артемия. У того, кто делает это впервые, — обычно неделя.

За кадром: где обычно ломается
Грабли 1

Модуль без MCP-рук

  • Красивый интерфейс, которым может пользоваться только человек, — это сайт, а не Чешуйка.
  • Без инструментов агенты не смогут ни спросить, ни сделать: вся автоматизация умирает.
Грабли 2

Права «потом настроим»

  • Область видимости описывается до пилота, а не после первой утечки в общий чат.
  • Гриф — не бюрократия: один неверный доступ убивает доверие ко всей вселенной.
Грабли 3

Десять экранов вместо трёх

  • Чешуйка решает одну задачу. Разрастается — распиливается на две.
  • Правило: если объяснение занимает больше минуты, модуль слишком большой.
Грабли 4

Одиночество

  • Данные модуля должны быть доступны другим агентам и Чешуйкам — иначе он остаётся вещью в себе.
  • Лучшие Чешуйки кормят соседей: квесты → контент-завод → продажи.