Кобра каталог сценариев
Выпуск #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Одна боль. Не одна функция — одна живая жалоба. У Завода это «контент перестал быть отдельной работой». Проверка прежняя: объяснение укладывается в минуту.
2Три экрана на поверхность. Предел про поверхность, а не про модуль. У Завода в Кобре — лента, завод, расписание; в доке — истории клиента и каталог; в кармане — согласование и календарь. Четвёртый экран в узкой панели уже не читается.
3Один словарь. Инструменты не считаем — считаем словарь. 52 инструмента Завода это глаголы одной области: пост, сториз, рассылка, медиа, расписание. Появился глагол из чужой области — «выстави счёт» — это вторая Чешуйка.
4Много конвейеров. Одна база кормит разных потребителей: подборки клиентам S4, квесты сотрудников T3, видеоцех P2. Новый потребитель тех же данных — не новая Чешуйка, а новый конвейер внутри старой.
Куда класть новое
1Про чаты, права, папки, агентов? Это ядро. Чешуйка здесь не нужна — и делать её не надо.
2Та же боль, новый способ показать? Новая поверхность существующей Чешуйки: док, карман, экран в рейле.
3Та же боль, новый глагол? Новый MCP-инструмент существующей. Словарь растёт — Чешуйка не делится.
4Те же данные, новый потребитель? Новый конвейер: та же база, другая витрина, своё расписание у Хроноса.
5Новая боль и свои данные? Вот теперь новая Чешуйка. Возвращайтесь к шагу 1 и начинайте с эскиза.

Пока ответ находится на первых четырёх ступенях — вы растите то, что уже есть. И чаще всего это и есть правильный ответ.

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

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

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

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

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

Мерили не той меркой

  • Считают экраны и инструменты, а резать надо по боли: одна Чешуйка — одна живая жалоба.
  • Шесть экранов в одной панели — она не читается. Пятьдесят инструментов одного словаря — норма: у Контент-Завода их 52.
  • Проверка прежняя: не уложился в минуту объяснения — модуль слишком большой.
Грабли 4

Одиночество

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