Кейс под ключ: keysarium

Привет! Этот курс — про пакет @dzhechkov/keysarium: набор навыков, команд и правил для Claude Code, который превращает расплывчатую фразу «а давайте применим ИИ вот здесь» в исследовательский конвейер keysarium из семи фаз — от разбора продукта до презентации со скриптом выступления.

Знакомься: Мира. Ей выдали задание в одну строку — «посмотри, как ИИ может ускорить обработку обращений в банке» — и неделю срока. Первый порыв понятен: открыть чат с моделью и спросить «что тут можно сделать». Через час у неё десять абзацев красивого текста, из которых ни один нельзя показать заказчику: ни источника, ни прототипа, ни цифр.

Пакет решает ровно эту боль. Он задаёт порядок работы и требует артефакт после каждой фазы, поэтому в конце недели у тебя не «мнение модели», а папка с документами, диаграммами и рабочим прототипом пути клиента.

Что внутри (числа взяты из README, а сверять их надо командой npx @dzhechkov/keysarium list: она считает файлы, а README написан руками):
- 12 навыков — исследование, разбор компании, решение задач, презентация, извлечение знаний;
- 19 команд — /casarium, /discovery, /research, /cjm-prototype, /solve, /presentation и другие;
- 14 правил и 9 контекстных шардов — они держат дисциплину качества и подгружаются по фазам;
- 5 шаблонов агентов — заготовки для параллельной работы.

Компромиссы: конвейер даёт проверяемый результат и защищает от красивых пустых текстов, но он тяжёлый — для одного быстрого вопроса «а есть ли на рынке аналог» это перебор; там достаточно обычного поиска.

💬 Просто попроси.
- «Расскажи, что такое keysarium и зачем он мне» → ассистент откроет README пакета и объяснит конвейер на твоём примере.
- «У меня кейс про обработку обращений в банке — поможет ли тут keysarium?» → ассистент сопоставит твою задачу с фазами и скажет, какие из них реально нужны.

Установка — это одна команда, и в этом хорошая новость: Мира ставит пакет прямо в каталог проекта, ничего не настраивая глобально.

npx @dzhechkov/keysarium init

Всё содержимое ложится в .claude/ твоего проекта — навыки, команды, правила, шарды и шаблоны агентов. Claude Code подхватывает их сам, отдельной регистрации не нужно. Требуется немногое: установленный Claude Code CLI и Node.js версии 16 или новее.

Полезные флаги, по одному предложению на каждый:
1. --dry-run — показать план установки и не тронуть ни одного файла (Мира всегда начинает с него в чужом репозитории);
2. --minimal — поставить только .claude/, без документации и библиотеки;
3. --with-docs — наоборот, добавить 38 документов: развёртывание, администрирование, руководство пользователя;
4. --force — перезаписать то, что уже лежит на месте.

Флаги комбинируются: npx @dzhechkov/keysarium init --minimal --force --dry-run покажет план минимальной установки с перезаписью, но снова ничего не запишет.

После установки под рукой ещё несколько команд: list покажет, что стоит в проекте, doctor проверит здоровье установки, update обновит до свежей версии, а remove аккуратно уберёт всё обратно. Исходники и публичное зеркало — github.com/djd1m/dz-harness, страница пакета — npmjs.com/package/@dzhechkov/keysarium.

Компромиссы: установка через npx не требует прав администратора и не засоряет систему, но кладёт файлы прямо в твой репозиторий — в общем проекте это стоит обсудить с командой заранее.

💬 Просто попроси.
- «Поставь keysarium в этот проект, но сначала покажи, что изменится» → ассистент выполнит установку с флагом --dry-run и покажет план.
- «Проверь, всё ли на месте после установки» → ассистент запустит doctor и list и объяснит вывод.

Прежде чем что-то запускать, Мира кладёт на стол карту из семи фаз конвейера. Порядок не случайный: каждая следующая фаза питается артефактом предыдущей.

Фаза 0      Фаза 1     Фаза 2      Фаза 2.5     Фаза 3    Фаза 4         Фаза 5
DISCOVERY   EXPLORE    RESEARCH    CJM PROTO    SOLVE     ARCHITECTURE   PRESENTATION
  15%         5%         15%         10%         15%         15%            20%

По одному предложению на фазу:
1. Фаза 0 — Discovery (/discovery) — разбор продукта и компании: задача, ради которой продукт нанимают, конкуренты, оценка отдачи.
2. Фаза 1 — Explore (/explore-case) — уточнение задания: превратить одну строку от заказчика в понятные границы.
3. Фаза 2 — Research (/research) — исследование в параноидальном режиме: аналоги, технологии, регулирование, и у каждого утверждения обязан быть источник.
4. Фаза 2.5 — CJM Prototype (/cjm-prototype) — путь клиента в виде рабочего прототипа на React; эту фазу пропускать нельзя, она единственная превращает слова в то, что можно показать и потрогать.
5. Фаза 3 — Solve (/solve) — стратегия решения через ТРИЗ и теорию игр, плюс схемы процесса «как есть» и «как будет».
6. Фаза 4 — Architecture (/architecture-phase) — техническая архитектура: диаграммы C4, последовательности вызовов, план интеграции.
7. Фаза 5 — Presentation (/presentation) — презентация, скрипт выступления, подготовка к вопросам и краткая выжимка для руководства.

Проценты рядом с фазами — это доля усилий, а не расписание. Самая дорогая фаза — презентация: работу, которой никто не увидел, заказчику не продашь.

Отдельная деталь фазы 0: разбор компании теперь заканчивается не просто анализом, а мотором роста — способ выхода на рынок и петля роста выбираются как два независимых решения, а из выводов рождаются черновые обязательства вида FR-GROWTH-001. Черновик — это черновик: он не доказывает, что что-то уже построено.

Компромиссы: жёсткий порядок фаз защищает от прыжка «сразу к решению», но стоит времени; если кейс крошечный, честнее взять две-три отдельные команды, а не весь конвейер.

💬 Просто попроси.
- «Покажи карту фаз keysarium и объясни, что делает каждая» → ассистент разложит семь фаз с их командами и артефактами.
- «Мне нужна только фаза исследования по этому кейсу» → ассистент запустит /research отдельно, не втягивая тебя в весь конвейер.

Вот главный рабочий путь, ради которого всё и ставилось. Полный прогон /casarium — это одна команда, которая ведёт кейс через все семь фаз с остановками на подтверждение.

claude
/casarium Как ИИ может сократить время ответа на обращения клиентов банка с 4 часов до 15 минут?

Задание можно писать по-русски: Мира так и делает, и конвейер спокойно работает с русскоязычным кейсом, подбирая правила домена по смыслу описания.

Что происходит дальше, по шагам:
1. конвейер определяет домен и запускает фазу разбора продукта;
2. после каждой фазы он останавливается на контрольной точке и показывает результат — ты отвечаешь «продолжай», просишь доработать или откатываешь фазу;
3. каждая фаза пишет свои файлы в каталог researches/<имя-кейса>/, поэтому прогон можно прервать и вернуться позже.

Отдельные фазы вызываются и поодиночке: /discovery Тинькофф Банк, /research обработка документов в страховании, /cjm-prototype онбординг в мобильном банке, /solve снизить отток клиентов. Это спасает, когда часть работы уже сделана руками.

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

Компромиссы: остановки делают прогон предсказуемым и управляемым, но требуют твоего внимания — полностью «уйти и вернуться к готовому» не получится, и это сознательный выбор в пользу качества.

💬 Просто попроси.
- «Запусти полное исследование кейса про обращения в банке» → ассистент выполнит /casarium с твоим текстом и остановится на первой контрольной точке.
- «Сделай только фазу исследования, остальное я доделаю сам» → ассистент вызовет /research и не пойдёт дальше по конвейеру.

Теория стоит ровно столько, сколько от неё остаётся на диске. У keysarium ответ буквальный: артефакты в каталоге researches/<имя-кейса>/, по файлу на фазу.

researches/bank-support/
├── 00_product_discovery.md      # фаза 0 — разбор продукта
├── 01_case_brief.md             # фаза 1 — границы кейса
├── 02_research_findings.md      # фаза 2 — находки с источниками
├── 02.5_trend_brief.md          # фаза 2.5 — тренды
├── 03_solution_strategy.md      # фаза 3 — стратегия решения
├── 04_architecture.md           # фаза 4 — архитектура
├── 05_presentation_content.md   # фаза 5 — содержание презентации
├── 06_speaker_script.md         # фаза 5 — скрипт выступления
├── 07_qa_preparation.md         # фаза 5 — подготовка к вопросам
├── 08_executive_summary.md      # фаза 5 — выжимка для руководства
├── prototype/cjm-prototype.jsx  # фаза 2.5 — прототип пути клиента
└── diagrams/*.mermaid           # схемы C4, последовательности, процессы

Чем это важно на практике, Мира поняла в первую же неделю: каждый кейс живёт в своём каталоге и ни с чем не смешивается, поэтому три параллельных исследования не мешают друг другу. Прогон можно прервать — то, что уже написано, никуда не денется.

Диаграммы лежат отдельными файлами в формате Mermaid: architecture-c4.mermaid, sequence-main-flow.mermaid, process-as-is.mermaid, process-to-be.mermaid. Их можно вставить в любой документ или отрисовать в браузере — не надо экспортировать картинки вручную.

Отдельно стоит выжимка для руководства: она помечена как обязательная. Причина простая — решение о кейсе часто принимает человек, который прочитает одну страницу и ни одной больше.

Компромиссы: файлы на диске легко читать, сравнивать между версиями и класть в репозиторий, но их много — без привычки к нумерации 00…08 в каталоге сначала теряешься.

💬 Просто попроси.
- «Покажи, что уже готово по кейсу» → ассистент перечислит файлы в researches/<кейс>/ и скажет, какие фазы ещё не отработали.
- «Собери выжимку для руководства на одну страницу» → ассистент возьмёт готовые артефакты и соберёт 08_executive_summary.md.

Самая опасная строчка в любом кейсе — уверенная цифра без ссылки. Фаза исследования работает в параноидальном режиме: каждое утверждение обязано нести проверяемый источник, иначе оно не идёт дальше.

За этим стоит навык goap-research-ed25519 — исследование с подписью. Он ставит криптографическую подпись на найденные факты, чтобы было видно, кто и что подписал, и чтобы подмена задним числом стала заметной.

И вот честная оговорка, которую пакет проговаривает сам: подпись доказывает авторство и целостность, но не доказывает правдивость и не мешает модели выдумать факт. Подписанная выдумка остаётся выдумкой — просто теперь известно, чья она. Это ровно та граница, которую нужно уметь объяснить заказчику, если он увидит слово «криптография» в отчёте.

Что из этого Мира делает на практике:
1. цифру без ссылки она возвращает на доработку, а не правит руками;
2. хотя бы одну ссылку из трёх она открывает сама — подпись не заменяет чтение;
3. уровень уверенности она сохраняет дословно: «оценка по трём аналогам» и «данные вендора» — разные вещи.

Есть и приятная деталь: если рядом установлен @dzhechkov/harness-cli, навык вспоминает методические уроки прошлых исследований и записывает новые. Нет его — навык работает как обычно и один раз честно сообщает об этом.

Компромиссы: требование источника заметно замедляет фазу 2 и иногда оставляет пустоту там, где хотелось красивой цифры, зато отчёт переживает первый же въедливый вопрос.

💬 Просто попроси.
- «Проверь, у каждого ли утверждения в отчёте есть источник» → ассистент пройдёт по находкам и покажет те, что висят без ссылки.
- «Объясни, что именно доказывает подпись под фактом» → ассистент разложит: авторство и целостность — да, правдивость — нет.

Исследование хорошо распараллеливается: аналоги, технологии и регулирование можно искать одновременно, они не зависят друг от друга. Именно так конвейер и делает — рой агентов и параллельные кейсы встроены в фазы.

Где включается параллельность:
- фаза 0 — 2 агента: задача, ради которой продукт нанимают ‖ конкуренты и оценка отдачи;
- фаза 2 — 3 агента: аналоги ‖ технологии ‖ регулирование;
- фаза 2.5 — 3 агента: вариант пути A ‖ варианты B и C ‖ исследование трендов;
- фаза 5 — 3 агента: презентация ‖ скрипт выступления ‖ вопросы и выжимка.

Есть и второй уровень — параллельность по кейсам:

/parallel-research автоматизация в банке | персонализация в ритейле | триаж в медицине

До четырёх кейсов идут одновременно, каждый в своём каталоге researches/<имя>/, поэтому они физически не могут перемешаться. Мира так и делает, когда заказчик приносит три смежные темы разом.

Что параллельность не ускоряет: твои собственные контрольные точки. Три кейса — это три очереди на твоё внимание, и если решения принимаешь только ты, узкое место переезжает на человека, а не исчезает.

Компромиссы: рой сокращает время фазы в разы, но повышает расход и усложняет разбор ошибки — когда три агента писали параллельно, найти, кто внёс сомнительное утверждение, дороже.

💬 Просто попроси.
- «Исследуй эти три кейса параллельно» → ассистент запустит /parallel-research и заведёт отдельный каталог под каждый.
- «Сколько агентов работает на фазе исследования?» → ассистент назовёт распределение по фазам и объяснит, почему именно так.

Иногда заказчику мало ответа «это можно сделать» — ему нужно «это можно сделать вот на этих сервисах». Для такого случая есть режим AI Factory: один флаг к обычной команде.

/casarium --ai-factory Как ИИ может ускорить обработку обращений в банке

Флаг раскладывает решение на сервисы платформы Cloud.ru Evolution AI Factory и проводит этот разбор через все фазы:
1. на фазе 0 в разбор продукта добавляется оценка применимости платформы;
2. на фазе 2 появляется отдельный артефакт с сопоставлением «шаг → сервис» и пометками ✅ / ⚠️ / ❌;
3. на фазе 2.5 каждый шаг пути клиента подписан сервисом, который его закрывает;
4. на фазе 3 считается покрытие в процентах и разбираются пробелы — что из коробки не делается;
5. на фазах 4 и 5 сервисы попадают в диаграмму и в отдельный слайд «покрытие AI Factory».

Главное свойство режима — он ничего не ломает; в README это названо гарантией отсутствия деградации. Без флага конвейер работает ровно как раньше: ни один существующий артефакт не меняется, ни одна фаза не переписывается, ни одна контрольная точка не исчезает. Флаг только добавляет. Поэтому Мира включает его без страха сломать привычный прогон.

Новые файлы, которые появляются только с флагом: 02.6_ai_factory_mapping.md, ai_factory_analysis.md, при наличии Node.js — тот же отчёт в формате DOCX, и диаграмма diagrams/ai-factory-pipeline.mermaid.

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

💬 Просто попроси.
- «Разложи мой кейс на сервисы Cloud.ru AI Factory» → ассистент выполнит прогон с флагом --ai-factory и соберёт таблицу сопоставления.
- «Покажи, чего в этом решении нет из коробки» → ассистент вытащит раздел пробелов и оценку покрытия.

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

        текст кейса
             │
     определение домена
   ┌─────┬────┴────┬─────────┐
  банк  ритейл  enterprise  медицина
   │      │        │          │
  свои ограничения, свои приоритеты, своя палитра

Что это значит по отраслям:
- Банк и финтех — модель разворачивается в своём контуре, данные не покидают периметр, обязателен человек в цикле принятия решения, отдельно проверяется соответствие ФЗ-152 и требованиям регулятора; палитра синяя.
- Ритейл и электронная торговля — задержка рекомендаций в реальном времени — меньше 200 мс, проверка гипотез через A/B-тесты, баланс персонализации и приватности, отдельная работа с сезонностью и холодным стартом; палитра янтарная.
- Enterprise и B2B — стратегия управления изменениями, потому что люди сопротивляются ИИ, план интеграции с унаследованными системами, прописанные уровни обслуживания (SLA) и отдача, посчитанная в сэкономленных часах и штатных единицах.
- Медицина — человек в цикле обязателен для любого клинического решения, требования к объяснимости, изоляция данных пациента и медицинское регулирование.

Мира экономит на этом целый круг правок: она не вспоминает в последний момент, что банковский кейс нельзя строить на внешнем облачном сервисе — правило домена сказало это на второй фазе.

Компромиссы: готовые правила ускоряют старт и ловят типичные грубые ошибки, но они не заменяют юриста и не знают внутренних политик конкретной компании — их надо уточнять у заказчика.

💬 Просто попроси.
- «Какие ограничения у моего кейса, если это банк?» → ассистент перечислит доменные правила и покажет, что из них уже учтено в артефактах.
- «Проверь мой кейс на требования медицинского домена» → ассистент сверит решение с правилами про человека в цикле и объяснимость.

Эта секция — про честно измеренный отказ и про правило, которое из него выросло. Пакет описывает его прямо в README, и Мира считает этот раздел самым полезным во всём документе.

Что измерили. Два независимых прогона конвейера по репозиторию примерно на 130 файлов: шаги, обязанные произвести документ, не дошли до записи ни разу — 18 попыток, ноль записанных файлов. Агент умирал на чтении: приходит результат команды, агент обдумывает следующий ход, молчит дольше 180 секунд — и сторож времени выполнения его убивает. Один такой прогон стоил около 4 миллионов токенов и 1 час 54 минуты.

Отказ оказался закономерным, а не невезением. Время размышления растёт вместе с накопленной историей, поэтому на достаточно большом репозитории неограниченное чтение гарантирует смерть. И причина была в инструкции, а не в среде: шаг говорил «прочитай код, напиши документ», не задавая ни бюджета чтения, ни порядка действий. Агент выполнял буквально — и читал до конца.

Дисциплина письма и скелет документа — это лечение. Каждый шаг, который обязан произвести документ, теперь несёт четыре правила:
1. первая запись файла — в пределах примерно 12 обращений к инструментам: скелет из заголовков разделов и по строке под каждым — о чём он будет;
2. дальше заполнять по одному разделу за правку, правка не длиннее примерно 120 строк;
3. не молчать дольше двух минут без обращения к инструменту;
4. сомневаешься, читать дальше или писать — пиши.

Чего это не делает, сказано прямым текстом: смерти не прекращаются, сторож не изменился. Меняется то, что переживает смерть: раньше — ничего, теперь — скелет на диске, который продолжит следующая попытка. Контрольный эксперимент владельца — один прогон, n=1; числа «12» и «120» выбраны, а не измерены; два возможных ухудшения названы независимым рецензентом и не измерены — ранний скелет может закрепить структуру, выбранную до понимания, а запись по разделам увеличивает накладные расходы.

Компромиссы: правило дёшево и спасает работу, но его эффект подтверждён одним наблюдением — это рабочая гипотеза с честным ярлыком, а не доказанный закон.

💬 Просто попроси.
- «Начни со скелета документа, потом заполняй по разделам» → ассистент сначала запишет каркас заголовков, а уже потом станет наполнять его.
- «Почему в этом пакете шаги пишут файл так рано?» → ассистент перескажет измерение: 18 попыток, ноль записей, сторож на 180 секунд.

Кейс закончился — и всё добытое знание рискует остаться в одном каталоге. Здесь и нужен перенос знаний через brain-export и соседние с ним команды.

Сначала — сбор находок. Команда /harvest запускает извлечение переиспользуемого из готового исследования:

/harvest researches/bank-support/      # разобрать один кейс
/harvest all                           # разобрать все исследования
/harvest all only rules,templates      # только правила и шаблоны

Конвейер сбора устроен так: 5 параллельных агентов смотрят на материал разными глазами (закономерности, команды, правила, шаблоны, фрагменты) → находки раскладываются по 7 категориям с проверкой на дубли → ты проходишь контрольную точку и вручную принимаешь или отклоняешь каждый пункт → 8 блокирующих проверок качества → принятое раскладывается по каталогам .claude/. Ручная контрольная точка здесь не формальность: без неё в проект приезжает мусор, который потом читается как правило.

Потом — переезд. /brain-export упаковывает накопленное в переносимый файл с контрольной суммой SHA-256, а /brain-import разворачивает его в другом проекте. Есть режим разностного экспорта — сохранить только изменения с прошлого раза.

Своё добавляется просто: новый навык — каталог с SKILL.md в .claude/skills/, новая команда — файл в .claude/commands/, новое правило — файл в .claude/rules/. Правила подхватываются автоматически и действуют на всех фазах. Так Мира и завела собственное правило про формулировки для банковского заказчика.

Компромиссы: перенос знаний экономит недели на следующем похожем кейсе, но переносит и ошибки — плохое правило путешествует между проектами так же легко, как хорошее.

💬 Просто попроси.
- «Собери переиспользуемое из этого исследования» → ассистент запустит /harvest по каталогу кейса и покажет находки списком.
- «Упакуй накопленные знания, чтобы забрать их в другой проект» → ассистент выполнит /brain-export и объяснит, как импортировать файл.

Последняя секция — про честность. Границы применимости keysarium стоит знать до того, как ты пообещаешь заказчику лишнего.

Чего конвейер не делает:
- не отвечает за правдивость найденного — подпись фиксирует авторство и целостность, но выдумка остаётся выдумкой;
- не заменяет юриста и не знает внутренних политик компании: доменные правила задают рамку, а не заключение;
- не строит продукт — прототип пути клиента показывает опыт, а не рабочую систему;
- не спасает агента от сторожа бездействия: он лишь сохраняет скелет документа, чтобы работа не пропала;
- не гарантирует, что черновое обязательство FR-GROWTH-nnn описывает что-то уже построенное — черновик остаётся черновиком.

Когда конвейер избыточен: нужен один факт или короткая справка, а то и решение уже готово — осталось оформить слайды. Полный прогон окупается на настоящем кейсе — там, где тебя будут спрашивать «откуда цифра» и «покажи, как это выглядит для клиента».

И ещё одно: числа в README написаны руками, а npx @dzhechkov/keysarium list считает файлы. Если они расходятся — верь команде. Мира проверяет это первым делом, когда готовит слайд про состав инструмента.

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

💬 Просто попроси.
- «Нужен ли здесь полный конвейер или хватит одной фазы?» → ассистент оценит задачу и честно скажет, где keysarium избыточен.
- «Перечисли, чего этот инструмент не гарантирует» → ассистент соберёт список ограничений из README и объяснит каждое.