@dzhechkov/keysarium 1.0.0

package/templates/docs/keysarium/03-user-guide.md

@@ -0,0 +1,884 @@
+# Руководство пользователя Product Keysarium 2026
+
+Это руководство описывает, как использовать Product Keysarium 2026 для проведения AI-исследований на Кейсариумах и хакатонах. Предназначено для конечных пользователей -- участников команд.
+
+---
+
+## Содержание
+
+1. [Быстрый старт (5 минут)](#1-быстрый-старт-5-минут)
+2. [Основные команды](#2-основные-команды)
+3. [Работа с checkpoint-ами](#3-работа-с-checkpoint-ами)
+4. [Работа с CJM прототипом (Phase 2.5)](#4-работа-с-cjm-прототипом-phase-25)
+5. [Quick Mode (менее 2 часов)](#5-quick-mode-менее-2-часов)
+6. [Параллельные исследования](#6-параллельные-исследования)
+7. [Типичные сценарии](#7-типичные-сценарии)
+8. [FAQ и troubleshooting](#8-faq-и-troubleshooting)
+
+---
+
+## 1. Быстрый старт (5 минут)
+
+### Шаг 1: Запустите полный пайплайн
+
+Откройте Claude Code в директории проекта и введите:
+
+```
+/casarium Автоматизация контакт-центра Альфа-Банка с использованием AI:
+снизить нагрузку на операторов на 40%, сократить время обработки типовых
+обращений с 8 минут до 2 минут. Ограничения: on-premise, ФЗ-152, бюджет 50 млн руб.
+```
+
+Вот и всё. Система запустит последовательный пайплайн из 7 фаз и будет создавать артефакты автоматически.
+
+### Шаг 2: Отвечайте на checkpoint-ы
+
+После каждой фазы вы увидите checkpoint:
+
+```
+═══════════════════════════════════════════════════════
+CHECKPOINT 0: Product Discovery Complete
+Проведён анализ JTBD, конкурентов, ROI. Определены 4 сегмента
+пользователей, 5 конкурентных решений, предварительный ROI 280%.
+Файл: 00_product_discovery.md
+• "ок" — следующая фаза
+• "углуби [раздел]" — доработать
+═══════════════════════════════════════════════════════
+```
+
+Введите `ок`, чтобы перейти к следующей фазе. Подробнее о вариантах ответа -- в разделе [Работа с checkpoint-ами](#3-работа-с-checkpoint-ами).
+
+### Шаг 3: Получите результат
+
+По завершении всех фаз в директории `researches/<название-кейса>/` появится полный набор артефактов:
+
+```
+researches/bank_kc_automation/
+├── 00_product_discovery.md         ← Анализ продукта и рынка
+├── 01_case_brief.md                ← Структурированный бриф кейса
+├── 02_research_findings.md         ← Бенчмарки, аналоги, технологии
+├── 02.5_trend_brief.md             ← Анализ трендов для CJM
+├── 03_solution_strategy.md         ← Стратегия решения
+├── 04_architecture.md              ← Техническая архитектура
+├── 05_presentation_content.md      ← Контент презентации (10-12 слайдов)
+├── 06_speaker_script.md            ← Скрипт для спикера
+├── 07_qa_preparation.md            ← Подготовка к Q&A (7+ вопросов)
+├── 08_executive_summary.md         ← Executive Summary (1 страница)
+├── prototype/
+│   └── cjm-prototype.jsx          ← Кликабельный прототип CJM
+├── diagrams/
+│   ├── architecture-c4.mermaid    ← C4 архитектура
+│   ├── sequence-main-flow.mermaid ← Sequence diagram
+│   ├── process-as-is.mermaid      ← Процесс "как есть"
+│   └── process-to-be.mermaid      ← Процесс "как будет"
+└── README.md                       ← Сводка исследования
+```
+
+### Что происходит на каждой фазе
+
+| Фаза | Название | Время | Что делает | Артефакт |
+|------|---------|-------|-----------|----------|
+| Phase 0 | Discovery | 15% | Анализ продукта: JTBD, конкуренты, ROI, Why AI | `00_product_discovery.md` |
+| Phase 1 | Explore | 5% | Глубокое понимание: 5 Whys, ограничения, критерии успеха | `01_case_brief.md` |
+| Phase 2 | Research | 15% | Бенчмарки, аналоги, технологии, регуляторика | `02_research_findings.md` |
+| Phase 2.5 | CJM Prototype | 10% | 4 варианта CJM + кликабельный прототип + тренды | `02.5_trend_brief.md`, `prototype/cjm-prototype.jsx` |
+| Phase 3 | Solve | 15% | Стратегия решения: SCQA, Process Design, HITL, метрики | `03_solution_strategy.md`, diagrams |
+| Phase 4 | Architecture | 15% | Техническая архитектура: C4, компоненты, data, security | `04_architecture.md`, diagrams |
+| Phase 5 | Presentation | 20% | Презентация, скрипт, Q&A, Executive Summary | `05-08_*.md` |
+| Phase 6 | Packaging | 5% | Финальная сборка, README | `README.md` |
+
+---
+
+## 2. Основные команды
+
+### 2.1. /casarium -- полный пайплайн
+
+Запускает полный цикл из 7 фаз для одного кейса.
+
+```
+/casarium [текст кейса]
+```
+
+**Примеры:**
+
+```
+/casarium Автоматизация КЦ Альфа-Банка: снизить нагрузку на операторов
+на 40% с помощью AI. On-premise, ФЗ-152.
+
+/casarium Персонализация рекомендаций для маркетплейса Ozon:
+увеличить конверсию на 15%. Real-time latency < 200ms.
+
+/casarium Оптимизация HR-процессов для Сбера: автоматизация
+скрининга резюме и первичного интервью. 1000+ вакансий/месяц.
+```
+
+Если вызвать без аргументов, система спросит текст кейса, тайминг и домен:
+
+```
+/casarium
+```
+
+### 2.2. /new-research -- создать исследование
+
+Создаёт изолированную директорию для нового исследования без запуска пайплайна.
+
+```
+/new-research [название кейса]
+```
+
+**Пример:**
+
+```
+/new-research Автоматизация КЦ банка
+```
+
+Результат:
+
+```
+═══════════════════════════════════════════════════════
+Исследование создано: researches/bank_kc_automation/
+
+Для запуска полного пайплайна:
+  /casarium [текст кейса]
+
+Для запуска отдельных фаз:
+  /discovery, /explore-case, /research, /cjm-prototype,
+  /solve, /architecture-phase, /presentation
+═══════════════════════════════════════════════════════
+```
+
+### 2.3. /parallel-research -- несколько кейсов
+
+Запускает Phase 0 (Product Discovery) для нескольких кейсов параллельно.
+
+```
+/parallel-research кейс1: [описание] | кейс2: [описание] | кейс3: [описание]
+```
+
+**Пример:**
+
+```
+/parallel-research банк: Автоматизация КЦ с AI | ритейл: Персонализация рекомендаций | hr: Скрининг резюме с LLM
+```
+
+Результат -- таблица со статусами и инструкциями для продолжения каждого исследования.
+
+### 2.4. Команды отдельных фаз
+
+Каждую фазу можно запустить отдельно, передав путь к директории исследования:
+
+| Команда | Фаза | Пример |
+|---------|------|--------|
+| `/discovery` | Phase 0 | `/discovery researches/bank_kc_automation/` |
+| `/explore-case` | Phase 1 | `/explore-case researches/bank_kc_automation/` |
+| `/research` | Phase 2 | `/research researches/bank_kc_automation/` |
+| `/cjm-prototype` | Phase 2.5 | `/cjm-prototype researches/bank_kc_automation/` |
+| `/solve` | Phase 3 | `/solve researches/bank_kc_automation/` |
+| `/architecture-phase` | Phase 4 | `/architecture-phase researches/bank_kc_automation/` |
+| `/presentation` | Phase 5 | `/presentation researches/bank_kc_automation/` |
+
+Это полезно, когда:
+- Нужно перезапустить конкретную фазу
+- Работаете над фазами по одной (с перерывами)
+- Хотите повторить фазу с другими параметрами
+
+### 2.5. /harvest -- извлечение знаний
+
+Запускает ритуал извлечения знаний после завершения исследования.
+
+```
+/harvest researches/bank_kc_automation/
+```
+
+Для обработки всех исследований:
+
+```
+/harvest all
+```
+
+Harvest находит универсальные паттерны, шаблоны и уроки, которые можно переиспользовать в будущих исследованиях.
+
+---
+
+## 3. Работа с checkpoint-ами
+
+После каждой фазы система показывает checkpoint и ожидает вашей реакции. Вы управляете процессом через простые текстовые команды.
+
+### 3.1. Доступные команды на checkpoint-е
+
+| Команда | Действие | Когда использовать |
+|---------|----------|-------------------|
+| `ок` | Перейти к следующей фазе | Результат устраивает |
+| `углуби [раздел]` | Доработать конкретный раздел | Нужно больше деталей |
+| `ускорь` | Включить Quick Mode | Мало времени |
+| `wow` | Добавить нестандартный элемент | Хотите удивить жюри |
+| `превью [X]` | Посмотреть документ | Проверить артефакт |
+| `время [N]` | Установить тайминг (часов) | Уточнить тайминг |
+| `выбираю A/B/C/D` | Зафиксировать CJM | Только на Phase 2.5 |
+| `объедини A+D` | Создать гибрид CJM | Только на Phase 2.5 |
+
+### 3.2. Примеры использования
+
+**Простое продвижение:**
+
+```
+CHECKPOINT 0: Product Discovery Complete
+...
+> ок
+```
+
+**Углубление конкретного раздела:**
+
+```
+CHECKPOINT 2: Research Complete
+...
+> углуби конкурентный анализ
+```
+
+Система доработает раздел конкурентного анализа и покажет обновлённый checkpoint.
+
+**Переключение в быстрый режим:**
+
+```
+CHECKPOINT 1: Explore Complete
+...
+> ускорь
+```
+
+Оставшиеся фазы будут выполнены в сокращённом формате (Quick Mode).
+
+**Добавление вау-эффекта:**
+
+```
+CHECKPOINT 4: Architecture Complete
+...
+> wow
+```
+
+Система добавит нестандартный элемент в текущую или следующую фазу -- например, неожиданный аналог, провокационный инсайт или нестандартную визуализацию.
+
+**Просмотр артефакта:**
+
+```
+> превью 03_solution_strategy.md
+```
+
+**Установка тайминга:**
+
+```
+> время 2
+```
+
+Устанавливает 2 часа на весь кейс. Система пересчитает бюджет времени по фазам.
+
+### 3.3. Что нельзя делать
+
+- Не пропускайте checkpoint-ы молча -- система ждёт вашего ответа
+- Не пытайтесь перескочить фазы -- они зависят друг от друга
+- Не удаляйте артефакты вручную посреди пайплайна -- это нарушит зависимости
+
+---
+
+## 4. Работа с CJM прототипом (Phase 2.5)
+
+Phase 2.5 -- ключевая фаза, которая никогда не пропускается. Здесь создаётся Customer Journey Map (CJM) в 4 вариантах и кликабельный React-прототип.
+
+### 4.1. Что вы получите
+
+После Phase 2.5 у вас будет:
+
+1. **4 варианта CJM:**
+   - **Variant A** -- первый подход к точке входа пользователя
+   - **Variant B** -- альтернативный подход
+   - **Variant C** -- третий вариант
+   - **Variant D** -- Future-Ready CJM, основанный на анализе трендов
+
+2. **Trend Brief** (`02.5_trend_brief.md`) -- исследование 5 категорий трендов
+
+3. **React-прототип** (`prototype/cjm-prototype.jsx`) -- кликабельный интерфейс с вкладками для каждого варианта
+
+### 4.2. Выбор варианта
+
+На checkpoint-е Phase 2.5 вам будут представлены 4 варианта CJM. Ваши опции:
+
+**Выбрать один вариант:**
+
+```
+> выбираю A
+```
+
+или
+
+```
+> выбираю D
+```
+
+Выбранный вариант станет `{CHOSEN_CJM}` и будет использоваться во всех последующих фазах (Phase 3-5).
+
+**Создать гибрид:**
+
+```
+> объедини A+D
+```
+
+Система создаст гибрид из выбранных вариантов. Полезно, когда хотите взять основу одного варианта и дополнить элементами другого.
+
+Можно комбинировать любые варианты:
+
+```
+> объедини B+C
+> объедини A+B+D
+```
+
+**Запросить объяснение трендов:**
+
+```
+> объясни тренды D
+```
+
+Система подробно расскажет, какие тренды легли в основу Variant D и почему они релевантны вашему кейсу.
+
+### 4.3. Рекомендации по выбору
+
+| Ситуация | Рекомендация |
+|----------|-------------|
+| Кейсариум на 4 часа (стандарт) | Выберите один сильный вариант (часто A или D) |
+| Хакатон на 8 часов | Создайте гибрид A+D для максимального эффекта |
+| Банковский домен | Обратите внимание на Variant A/B (консервативнее) |
+| Ритейл | Variant D часто сильнее (тренды в e-commerce быстро меняются) |
+| Хотите удивить жюри | Variant D или гибрид с D (Future-Ready) |
+
+### 4.4. Что происходит после выбора
+
+1. `{CHOSEN_CJM}` фиксируется и передаётся в Phase 3-5
+2. Phase 3 (Solve) проектирует решение на основе выбранного CJM
+3. Phase 4 (Architecture) строит архитектуру под выбранный user flow
+4. Phase 5 (Presentation) включает CJM в контент презентации (слайд 5)
+
+---
+
+## 5. Quick Mode (менее 2 часов)
+
+Quick Mode -- сокращённый пайплайн для ситуаций с жёстким таймингом.
+
+### 5.1. Как активировать
+
+**Способ 1:** Указать тайминг менее 2 часов при запуске:
+
+```
+/casarium Автоматизация КЦ банка. Тайминг: 1.5 часа.
+```
+
+**Способ 2:** Ввести команду `ускорь` на любом checkpoint-е:
+
+```
+CHECKPOINT 1: Explore Complete
+> ускорь
+```
+
+**Способ 3:** Установить тайминг командой:
+
+```
+> время 1.5
+```
+
+### 5.2. Что изменяется в Quick Mode
+
+| Аспект | Полный режим | Quick Mode |
+|--------|-------------|------------|
+| Phase 0 + Phase 1 | Отдельные фазы | Объединены в одну |
+| Phase 2.5 (CJM) | 4 варианта | 2 варианта (A + D) |
+| Phase 4 (Architecture) | Полная архитектура | Минимальная (C4 + ключевые компоненты) |
+| Phase 5 (Presentation) | 10-12 слайдов | 7-8 слайдов |
+| Диаграммы | 4+ mermaid | 2 mermaid (C4 + sequence) |
+| Q&A Preparation | 7+ вопросов | 5 вопросов |
+
+### 5.3. Что НЕ сокращается
+
+Даже в Quick Mode:
+- Phase 2.5 (CJM Prototype) **не пропускается** (только упрощается)
+- `08_executive_summary.md` **обязателен**
+- Research в PARANOID mode -- **все утверждения с источниками**
+- Checkpoint-ы **сохраняются** (но можно отвечать `ок` быстрее)
+
+### 5.4. Распределение времени в Quick Mode (1.5 часа)
+
+| Фаза | Время (мин) | Что делается |
+|------|-------------|-------------|
+| Phase 0+1 (Discovery + Explore) | 15 | Объединённый discovery + brief |
+| Phase 2 (Research) | 12 | Сокращённый research |
+| Phase 2.5 (CJM Prototype) | 10 | 2 варианта CJM |
+| Phase 3 (Solve) | 12 | Стратегия решения |
+| Phase 4 (Architecture) | 12 | Минимальная архитектура |
+| Phase 5 (Presentation) | 24 | Сокращённая презентация + Executive Summary |
+| Buffer | 5 | Резерв |
+
+---
+
+## 6. Параллельные исследования
+
+### 6.1. Как запустить несколько кейсов
+
+Используйте `/parallel-research`, разделяя кейсы символом `|`:
+
+```
+/parallel-research банк: Автоматизация КЦ с AI, снизить нагрузку на 40% | ритейл: Персонализация рекомендаций, увеличить конверсию на 15% | hr: Скрининг резюме, обработка 1000 вакансий/мес
+```
+
+Система:
+1. Создаст директории для каждого кейса
+2. Запустит Phase 0 (Product Discovery) для всех кейсов параллельно
+3. Покажет сводную таблицу результатов
+
+### 6.2. Продолжение работы с кейсами
+
+После параллельного запуска Phase 0, продолжайте каждый кейс по очереди:
+
+```
+/casarium researches/bank_kc_automation/
+```
+
+Или запускайте отдельные фазы:
+
+```
+/explore-case researches/bank_kc_automation/
+/research researches/bank_kc_automation/
+```
+
+### 6.3. Как переключаться между исследованиями
+
+Каждое исследование изолировано в своей директории. Для переключения просто указывайте путь к нужному исследованию:
+
+```
+# Работаем с банковским кейсом
+/solve researches/bank_kc_automation/
+
+# Переключаемся на ритейл
+/solve researches/retail_recommendations/
+
+# Возвращаемся к банковскому
+/architecture-phase researches/bank_kc_automation/
+```
+
+**Проверить статус всех исследований:**
+
+```
+Покажи статус всех исследований в researches/
+```
+
+### 6.4. Ограничения
+
+- Рекомендуется не более 3-4 параллельных исследований
+- Phase 0 выполняется параллельно, последующие фазы -- по одному или парами
+- Каждое исследование полностью изолировано (файлы не пересекаются)
+
+---
+
+## 7. Типичные сценарии
+
+### 7.1. Кейсариум на 4 часа (банковский домен)
+
+**Сценарий:** Ваша команда получила кейс "Автоматизация контакт-центра банка с AI". У вас 4 часа на проработку и подготовку презентации.
+
+**Пошаговый план:**
+
+```
+# Шаг 1: Запуск пайплайна (время: 0:00)
+/casarium Автоматизация контакт-центра крупного банка с использованием AI.
+Цель: снизить нагрузку на операторов на 40%, сократить время обработки
+типовых обращений с 8 минут до 2 минут. Ограничения: on-premise
+(данные не покидают контур), ФЗ-152, бюджет 50 млн руб. Домен: банк.
+Тайминг: 4 часа.
+```
+
+**Фаза 0 (0:00 - 0:36):** Product Discovery.
+Система автоматически определит банковский домен и применит правила:
+- On-premise LLM (GigaChat, YandexGPT, open-source)
+- ФЗ-152, ЦБ, ФСТЭК
+- HITL обязателен
+- Палитра: Blue/Navy/Silver
+
+```
+> ок
+```
+
+**Фаза 1 (0:36 - 0:48):** Explore.
+
+```
+> ок
+```
+
+**Фаза 2 (0:48 - 1:24):** Research.
+Проверьте, что все утверждения имеют источники. Если видите `[UNVERIFIED]`:
+
+```
+> углуби research -- есть непроверенные утверждения
+```
+
+Иначе:
+
+```
+> ок
+```
+
+**Фаза 2.5 (1:24 - 1:48):** CJM Prototype.
+Выберите вариант CJM:
+
+```
+> выбираю A
+```
+
+Или создайте гибрид:
+
+```
+> объедини A+D
+```
+
+**Фаза 3 (1:48 - 2:24):** Solve.
+
+```
+> ок
+```
+
+**Фаза 4 (2:24 - 3:00):** Architecture.
+Убедитесь, что архитектура содержит on-premise компоненты.
+
+```
+> ок
+```
+
+**Фаза 5 (3:00 - 3:48):** Presentation.
+Проверьте Executive Summary.
+
+```
+> ок
+```
+
+**Фаза 6 (3:48 - 4:00):** Финальная сборка.
+
+**Результат:** Полный набор артефактов, включая презентацию на 10-12 слайдов, скрипт спикера и подготовку к Q&A.
+
+---
+
+### 7.2. Хакатон на 8 часов (ритейл)
+
+**Сценарий:** Хакатон по AI в ритейле. Кейс: "Персонализация товарных рекомендаций для маркетплейса". 8 часов на всё.
+
+```
+# Шаг 1: Запуск
+/casarium Персонализация товарных рекомендаций для маркетплейса.
+Цель: увеличить конверсию на 15%, средний чек на 10%.
+Каталог 5 млн SKU, 10 млн пользователей, latency < 200ms.
+Домен: ритейл. Тайминг: 8 часов.
+```
+
+**Стратегия на 8 часов:**
+
+Поскольку времени в два раза больше, чем на стандартном кейсариуме:
+
+- На каждом checkpoint-е **углубляйте** слабые разделы:
+  ```
+  > углуби конкурентный анализ
+  > углуби метрики cold-start
+  ```
+
+- На Phase 2.5 тщательно сравните все 4 варианта CJM, запросите подробности:
+  ```
+  > объясни тренды D
+  > объедини A+D
+  ```
+
+- На Phase 5 попросите добавить вау-эффект:
+  ```
+  > wow
+  ```
+
+- После завершения запустите harvest:
+  ```
+  /harvest researches/retail_recommendations/
+  ```
+
+**Распределение времени (8 часов):**
+
+| Фаза | Время | Комментарий |
+|------|-------|-------------|
+| Phase 0 | 1:12 | Углублённый discovery |
+| Phase 1 | 0:24 | С детальной кларификацией |
+| Phase 2 | 1:12 | Глубокий research с дополнительными источниками |
+| Phase 2.5 | 0:48 | Полные 4 варианта CJM + детальный выбор |
+| Phase 3 | 1:12 | Подробная стратегия |
+| Phase 4 | 1:12 | Полная архитектура с масштабированием |
+| Phase 5 | 1:36 | Полная презентация + wow-элементы |
+| Buffer | 0:24 | Резерв на доработки |
+
+---
+
+### 7.3. Быстрый питч на 2 часа
+
+**Сценарий:** Нужно подготовить питч за 2 часа. Кейс: "AI-ассистент для HR-отдела".
+
+```
+# Шаг 1: Запуск в Quick Mode
+/casarium AI-ассистент для HR: автоматизация скрининга резюме
+и первичного интервью. 1000+ вакансий/месяц, enterprise.
+Тайминг: 2 часа.
+```
+
+Система автоматически активирует Quick Mode (тайминг < 2 часов).
+
+**На checkpoint-ах:**
+
+```
+> ок     ← быстро продвигайтесь
+> ок
+> выбираю A     ← на Phase 2.5 выберите вариант не раздумывая
+> ок
+> ок
+> ок
+```
+
+**Результат за 2 часа:**
+- Сокращённый набор артефактов
+- Презентация на 7-8 слайдов
+- Executive Summary
+- 2 варианта CJM (вместо 4)
+- Минимальная архитектура
+
+---
+
+### 7.4. Перезапуск отдельной фазы
+
+**Сценарий:** Вы завершили Phase 3, но решили изменить CJM.
+
+```
+# Перезапустите Phase 2.5
+/cjm-prototype researches/bank_kc_automation/
+
+# Выберите новый вариант
+> выбираю D
+
+# Затем перезапустите Phase 3 с новым CJM
+/solve researches/bank_kc_automation/
+```
+
+---
+
+### 7.5. Продолжение после перерыва
+
+**Сценарий:** Вы прошли Phase 0-2 вчера, сегодня продолжаете.
+
+```
+# Проверьте, что создано
+Покажи содержимое researches/bank_kc_automation/
+
+# Продолжите с Phase 2.5
+/cjm-prototype researches/bank_kc_automation/
+```
+
+Команда автоматически прочитает артефакты Phase 0-2 и продолжит с того места, где вы остановились.
+
+---
+
+## 8. FAQ и troubleshooting
+
+### Общие вопросы
+
+**Q: Можно ли пропустить Phase 2.5 (CJM Prototype)?**
+
+A: Нет. Phase 2.5 является обязательной. При нехватке времени она упрощается (2 варианта вместо 4), но не пропускается. CJM прототип -- критически важный артефакт, который определяет direction для Phase 3-5.
+
+---
+
+**Q: Что делать, если не понимаю, какой вариант CJM выбрать?**
+
+A: Используйте следующие подсказки:
+- `объясни тренды D` -- узнайте, что стоит за Variant D
+- Спросите: "Сравни варианты A и D по критериям [ваши критерии]"
+- Если сомневаетесь -- `объедини A+D` (гибрид обычно сильный выбор)
+
+---
+
+**Q: Можно ли запустить отдельную фазу без предыдущих?**
+
+A: Технически можно, но не рекомендуется. Каждая фаза читает артефакты предыдущих фаз для контекста. Если артефактов нет, результат будет неполным. Исключение -- Phase 0 (`/discovery`), которая может работать с текстом кейса напрямую.
+
+---
+
+**Q: Как указать домен (банк, ритейл, enterprise)?**
+
+A: Домен определяется автоматически по ключевым словам в тексте кейса. Для явного указания добавьте в текст:
+
+```
+/casarium [текст кейса]. Домен: банк.
+```
+
+Доступные домены: банк/fintech, ритейл/e-commerce, enterprise/B2B, healthcare.
+
+---
+
+**Q: Что такое PARANOID mode в research?**
+
+A: Это режим повышенной верификации данных. Каждое фактическое утверждение должно иметь проверяемый источник. Утверждения без источников помечаются как `[UNVERIFIED]`. Это защищает от галлюцинаций AI и обеспечивает доверие жюри.
+
+---
+
+**Q: Можно ли редактировать артефакты вручную?**
+
+A: Да. Файлы -- это обычные markdown/jsx файлы. Вы можете редактировать их в любом текстовом редакторе. Но учтите, что последующие фазы читают эти файлы, поэтому сохраняйте структуру.
+
+---
+
+**Q: Как получить презентацию в PowerPoint/Google Slides?**
+
+A: Файл `05_presentation_content.md` содержит контент для каждого слайда с указанием визуальных элементов. Перенесите контент в PowerPoint/Google Slides вручную, используя описания слайдов как руководство. Mermaid-диаграммы экспортируйте через mermaid.live.
+
+---
+
+### Troubleshooting
+
+**Проблема: Система не создала файл артефакта.**
+
+Решение:
+1. Проверьте, существует ли директория исследования:
+   ```bash
+   ls researches/
+   ```
+2. Перезапустите фазу:
+   ```
+   /discovery researches/<slug>/
+   ```
+
+---
+
+**Проблема: Checkpoint не появляется.**
+
+Решение: Checkpoint показывается после завершения фазы. Если фаза длится долго -- подождите. Если зависла -- прервите (Ctrl+C) и перезапустите фазу.
+
+---
+
+**Проблема: Получил ошибку "директория не найдена".**
+
+Решение: Создайте исследование перед запуском фаз:
+```
+/new-research Название моего кейса
+```
+
+---
+
+**Проблема: Research содержит [UNVERIFIED] утверждения.**
+
+Решение: На checkpoint-е Phase 2 попросите углубить:
+```
+> углуби research -- замени [UNVERIFIED] утверждения на проверенные
+```
+
+---
+
+**Проблема: CJM прототип (.jsx) не отображается.**
+
+Решение: Файл `prototype/cjm-prototype.jsx` -- это React-компонент. Для просмотра:
+1. Откройте в React-среде (Vite, Create React App, и т.д.)
+2. Или попросите Claude Code: `Покажи превью cjm-prototype.jsx`
+3. Или вставьте код в онлайн-песочницу (CodeSandbox, StackBlitz)
+
+---
+
+**Проблема: Хочу перезапустить всё с нуля.**
+
+Решение:
+```bash
+# Удалите директорию исследования
+rm -rf researches/<slug>/
+
+# Создайте заново
+/new-research Название кейса
+
+# Запустите пайплайн
+/casarium [текст кейса]
+```
+
+---
+
+**Проблема: Слишком много текста в презентации.**
+
+Решение: На checkpoint-е Phase 5 попросите:
+```
+> углуби презентацию -- слишком много текста на слайдах, сделай визуальнее
+```
+
+Или добавьте вау-эффект:
+```
+> wow
+```
+
+---
+
+**Проблема: Архитектура не учитывает доменные требования.**
+
+Решение: Убедитесь, что домен указан в тексте кейса. Если не указан -- на checkpoint-е Phase 4:
+```
+> углуби архитектуру -- это банковский домен, нужен on-premise и ФЗ-152
+```
+
+---
+
+### Горячие подсказки
+
+| Ситуация | Что написать |
+|----------|-------------|
+| Всё устраивает | `ок` |
+| Мало деталей | `углуби [название раздела]` |
+| Нет времени | `ускорь` |
+| Хочу удивить жюри | `wow` |
+| Нужно сравнить CJM | `объясни тренды D` |
+| Хочу гибрид CJM | `объедини A+D` |
+| Сменить тайминг | `время 3` |
+| Посмотреть файл | `превью 05_presentation_content.md` |
+| Проверить прогресс | `Покажи статус исследования` |
+
+---
+
+## Приложение: Памятка по артефактам
+
+### Минимальный обязательный набор (Quick Mode)
+
+```
+researches/<slug>/
+├── 00_product_discovery.md
+├── 01_case_brief.md
+├── 02_research_findings.md
+├── 02.5_trend_brief.md
+├── 03_solution_strategy.md
+├── 04_architecture.md
+├── 05_presentation_content.md
+├── 08_executive_summary.md       ← ВСЕГДА обязателен
+├── prototype/
+│   └── cjm-prototype.jsx
+└── diagrams/
+    ├── architecture-c4.mermaid
+    └── sequence-main-flow.mermaid
+```
+
+### Полный набор (стандартный режим)
+
+```
+researches/<slug>/
+├── 00_product_discovery.md
+├── 01_case_brief.md
+├── 02_research_findings.md
+├── 02.5_trend_brief.md
+├── 03_solution_strategy.md
+├── 04_architecture.md
+├── 05_presentation_content.md
+├── 06_speaker_script.md
+├── 07_qa_preparation.md
+├── 08_executive_summary.md       ← ВСЕГДА обязателен
+├── prototype/
+│   └── cjm-prototype.jsx
+├── diagrams/
+│   ├── architecture-c4.mermaid
+│   ├── sequence-main-flow.mermaid
+│   ├── process-as-is.mermaid
+│   └── process-to-be.mermaid
+└── README.md
+```