code-ai-installer 3.0.0 → 4.0.0

package/domains/analytics/.agents/skills/session-prompt-generator/SKILL.md

@@ -1,378 +1,378 @@
----
-name: session-prompt-generator
-description: Генерация промпта для следующей сессии — сбор контекста, формирование промпта, сохранение прогресса
----
-# Session Prompt Generator — Генерация промпта для следующей сессии
-
-## Когда использовать
-- При **завершении сессии** в Full Pipeline (`/analyze`) — перед межсессионным `$handoff`.
-- При **необходимости передать проект** другому оператору — формирование самодостаточного промпта.
-- При **запросе пользователя** «сгенерируй промпт для продолжения» — в любой момент.
-- При **аварийном завершении** сессии — сохранение максимума контекста для восстановления.
-
-> **Ключевой принцип:** следующая сессия начинается с **НУЛЯ** контекста. Промпт должен содержать всё необходимое, чтобы новая сессия продолжила работу без потерь.
-
-## Вход
-
-| Поле | Обязательно | Описание |
-|------|:-----------:|----------|
-| Состояние `$board` | ✅ | Текущая доска задач со всеми статусами |
-| Завершённые deliverables | ✅ | Полные артефакты текущей и предыдущих сессий |
-| Текущий гейт | ✅ | Где остановились (ID гейта из `$board`) |
-| Следующий гейт | ✅ | Куда переходим (ID следующего гейта) |
-| Открытые вопросы | ⬚ | Блокеры, неразрешённые конфликты, вопросы к пользователю |
-| Номер текущей сессии | ✅ | Какая сессия завершается (1-5) |
-| Название проекта | ✅ | Название аналитического проекта |
-
-### Связь с другими скилами
-| Скил | Взаимодействие | Когда |
-|------|----------------|-------|
-| `$board` | Источник: текущее состояние доски включается в промпт (блок 5) | Шаг 0 |
-| `$handoff` | Промпт включается в межсессионный handoff файл | Шаг 5 |
-| `$gates` | Источник: требования к следующему гейту определяют задачу (блок 6) | Шаг 0 |
-| Фреймворк-скилы | Завершённые фреймворки включаются полным текстом в блок 4 | Шаг 1 |
-
-## Маппинг «Сессия → Гейты → Агенты → Скилы»
-
-### Full Pipeline (`/analyze`)
-
-| Сессия | Гейты | Агенты | Обязательные скилы | Фреймворк-скилы |
-|:------:|-------|--------|-------------------|-----------------|
-| **1** | COND-01, INT-01 | Conductor, Interviewer | `$board`, `$gates`, `$handoff` | — |
-| **2** | COND-02, RES-01, AN-01, ST-01 | Conductor, Researcher, Data Analyst, Strategist | `$board`, `$gates`, `$handoff`, `$web-research` | По выбору AN-01 (min 2) |
-| **3** | COND-03, RES-02, AN-02, ST-02 | Conductor, Researcher, Data Analyst, Strategist | `$board`, `$gates`, `$handoff`, `$web-research` | По выбору AN-02 (контр-фреймворки) |
-| **4** | COND-04, MED-01 | Conductor, Mediator | `$board`, `$gates`, `$handoff` | — |
-| **5** | COND-05, DS-01, LY-01, RG-01 | Conductor, Designer, Layouter, Conductor (RG) | `$board`, `$gates`, `$handoff`, `$report-design`, `$html-pdf-report` | — |
-
-### Quick Pipeline (`/quick-insight`)
-Одна сессия — промпт не нужен (все гейты внутри одной сессии).
-
-## Протокол
-
-### Шаг 0 — Сбор состояния
-1. Прочитать текущее состояние `$board` — все гейты, статусы, deliverables.
-2. Собрать все завершённые артефакты текущей сессии.
-3. Загрузить кумулятивный индекс из предыдущих сессий (если есть).
-4. Определить следующий гейт и его требования из `$gates`.
-5. По маппингу «Сессия → Гейты → Агенты → Скилы» определить, что загружать.
-
-### Шаг 1 — Определение критических данных
-1. Выделить данные, которые **невосстановимы** без предыдущего контекста:
-
-   | Категория | Примеры | Приоритет |
-   |-----------|---------|:---------:|
-   | Ответы пользователя | Интервью (INT-01), уточнения, решения | 🔴 Critical |
-   | Собранные данные | Данные RES-xx с URL и источниками | 🔴 Critical |
-   | Результаты анализа | Фреймворки AN-xx, scoring, выводы | 🔴 Critical |
-   | Стратегические рекомендации | Стратегия ST-xx, action plan | 🔴 Critical |
-   | Вердикт Медиатора | Заключение MED-01, обоснование | 🔴 Critical |
-   | Решения пользователя | Approved, отклонения, scope-изменения | 🟡 Important |
-   | Метрики прогресса | Время на гейты, блокеры | 🟢 Nice-to-have |
-
-2. **Правило:** все 🔴 Critical данные включаются **полным текстом**. Без исключений.
-
-### Шаг 2 — Определение агентов и скилов
-1. По маппингу определить: какие агенты и скилы нужны в следующей сессии.
-2. Сформировать список файлов для загрузки (конкретные пути).
-3. Для фреймворк-скилов: указать конкретные скилы, если уже известны (из AN-01 или research brief).
-
-### Шаг 3 — Формирование промпта
-1. Заполнить шаблон промпта (6 блоков — см. ниже).
-2. Включить ПОЛНЫЙ текст критических данных (не ссылки, не резюме).
-3. Сформулировать конкретную задачу для следующей сессии.
-4. Указать, какие агенты и скилы активировать (конкретные пути к файлам).
-
-### Шаг 4 — Валидация промпта
-Тест самодостаточности — для каждого пункта ответить «можно ли без внешнего контекста?»:
-
-| # | Проверка | Результат |
-|---|----------|:---------:|
-| 1 | Можно начать работу, имея ТОЛЬКО этот промпт? | Да / Нет |
-| 2 | Нет ссылок на «предыдущий контекст» / «как обсуждалось»? | Да / Нет |
-| 3 | Все 🔴 Critical данные включены полным текстом? | Да / Нет |
-| 4 | Задача для сессии конкретна (гейт, действие, deliverable)? | Да / Нет |
-| 5 | Агенты и скилы перечислены с путями к файлам? | Да / Нет |
-| 6 | Доска задач включена? | Да / Нет |
-| 7 | Открытые вопросы зафиксированы? | Да / Нет |
-
-**Если хотя бы один = Нет — доработать промпт.**
-
-### Шаг 5 — Сохранение
-1. Включить промпт в файл `$handoff`: `docs/analytics/session-N-handoff.md`.
-2. Показать промпт пользователю для сохранения / копирования.
-3. Предупредить: «Этот промпт — вставьте его в начале следующей сессии».
-
-### Шаг 6 — Аварийный режим
-Если сессия завершается внезапно (таймаут, ошибка, потеря контекста):
-
-1. **Немедленно** сохранить всё, что доступно: доску, последний deliverable, открытые вопросы.
-2. Сформировать **аварийный промпт** (минимальная версия):
-   - Блок 1 (идентификация) — обязателен.
-   - Блок 5 (состояние доски) — обязателен.
-   - Блок 4 (данные) — всё, что удалось собрать.
-   - Блок 6 (задача) — «Восстановить контекст из session-N-handoff.md, проверить целостность данных, продолжить с гейта [ID]».
-3. Пометить промпт как **⚠️ АВАРИЙНЫЙ — возможна потеря данных**.
-4. Указать, какие данные могли быть потеряны и как восстановить (повторный `$web-research`, запрос у пользователя).
-
-## Структура генерируемого промпта
-
-### Блок 1 — Идентификация проекта
-- Название проекта.
-- Режим пайплайна (Full / Quick).
-- Номер следующей сессии.
-- Какие сессии завершены.
-
-### Блок 2 — Инструкция по загрузке
-- Прочитать AGENTS.md домена analytics.
-- Загрузить агентов, которые нужны в этой сессии (из маппинга).
-- Загрузить скилы: `$board`, `$handoff`, `$gates` + специфичные для гейтов.
-- Конкретные пути к файлам.
-
-### Блок 3 — Выполненная работа (резюме)
-- Что было сделано в предыдущих сессиях (2-3 предложения на сессию).
-- Ключевые решения и их обоснования.
-
-### Блок 4 — Критические данные
-- ПОЛНЫЙ ТЕКСТ ключевых артефактов, необходимых для продолжения.
-- Данные исследований, выводы анализов, рекомендации.
-- Ответы пользователя на интервью (если были).
-
-### Блок 5 — Текущее состояние
-- Доска задач (`$board`) в текущем состоянии.
-- Какой гейт следующий.
-- Открытые вопросы и блокеры.
-
-### Блок 6 — Задача для сессии
-- Конкретная формулировка: что нужно сделать в этой сессии.
-- Ожидаемый результат (deliverables).
-- Ограничения и особенности.
-
-## Правила формирования промпта
-
-### Обязательные правила
-1. **Самодостаточность** — промпт должен работать без ЛЮБОГО предыдущего контекста.
-2. **Полнота данных** — включать ПОЛНЫЙ текст, не ссылки и не резюме.
-3. **Конкретность задачи** — не «продолжи анализ», а «выполни RES-02: исследуй [тема] с позиции Критиков, данные Аналитиков: [данные]».
-4. **Структурированность** — чёткие блоки, маркированные заголовками.
-5. **Загрузка скилов** — явно указать какие агенты и скилы загрузить с путями к файлам.
-
-### Запрещённые элементы
-1. Ссылки на «предыдущую сессию» без полного содержания.
-2. «Как мы обсуждали» — нет контекста, нечего обсуждать.
-3. «См. результаты выше» — нет «выше», всё должно быть в промпте.
-4. Сокращённые данные — «основные выводы: ...». Нужны ВСЕ выводы.
-5. Предположения о контексте — «вы уже знаете, что...».
-
-## Пример — Промпт для сессии 3 (Team Beta: Критики)
-
-```
----
-## Промпт для сессии 3 — Анализ рынка EdTech РФ
-
-### 1. Проект
-- **Название:** Анализ рынка EdTech РФ для корпоративного обучения
-- **Режим:** Full Pipeline (/analyze)
-- **Сессия:** 3 из 5
-- **Предыдущие сессии:** 1 (Interview + Brief), 2 (Team Alpha: Research + Analysis + Strategy)
-
-### 2. Загрузка
-Прочитай:
-- `domains/analytics/AGENTS.md`
-- `domains/analytics/.agents/skills/board/SKILL.md`
-- `domains/analytics/.agents/skills/handoff/SKILL.md`
-- `domains/analytics/.agents/skills/gates/SKILL.md`
-- `domains/analytics/.agents/skills/web-research/SKILL.md`
-- `domains/analytics/.agents/skills/competitive-analysis/SKILL.md`
-- `domains/analytics/.agents/skills/porters-five-forces/SKILL.md`
-
-Активируй агентов: Conductor (COND-03), Researcher (RES-02), Data Analyst (AN-02), Strategist (ST-02).
-Роль: **Team Beta (Критики)** — задача: критика и альтернативный анализ к результатам Team Alpha.
-
-### 3. Что выполнено
-**Сессия 1:** Проведено интервью, сформирован research brief (12 вопросов), определён scope: корпоративное обучение, B2B SaaS, РФ, горизонт 3 года. Режим оценки: scoring.
-**Сессия 2:** Team Alpha (Аналитики) провели исследование (28 источников), применили TAM/SAM/SOM + Competitive Analysis + PEST. Стратегическая рекомендация: «AI-first корпоративная обучающая платформа, фокус на компании 50-500 чел.»
-
-### 4. Данные (полный текст)
-
-#### Research Brief (из INT-01)
-1. Каков размер рынка EdTech РФ (TAM/SAM/SOM) для корпоративного обучения?
-2. Кто ключевые конкуренты и каковы их доли?
-3. Какие технологические тренды меняют рынок?
-4. Какие регуляторные факторы влияют на EdTech?
-[... все 12 вопросов ...]
-
-#### Данные исследований Team Alpha (из RES-01)
-**TAM:** $4.2B (EdTech РФ, 2026). Источник: Smart Ranking, янв 2026 ✅
-**SAM:** $1.8B (корпоративное обучение). Источник: ВШЭ, мар 2026 ✅
-**SOM:** $180M (B2B SaaS платформы). Источник: расчёт ⚠️ (2 источника вместо 3)
-
-**Конкуренты:**
-| Конкурент | Доля | Threat Score | Ключевая сила |
-|-----------|------|-------------|---------------|
-| Skillbox (B2B) | 15% | 7.2 | Бренд, контент |
-| Нетология | 12% | 6.8 | Корп. программы |
-| Яндекс Практикум | 18% | 7.6 | Экосистема Яндекса |
-[... полные данные ...]
-
-#### Результаты анализа Team Alpha (из AN-01, ST-01)
-[ПОЛНЫЙ ТЕКСТ: TAM/SAM/SOM фреймворк, Competitive Analysis, PEST, стратегические рекомендации]
-
-### 5. Текущее состояние
-
-#### Доска задач
-📊 Прогресс: 40% (6/15) | Сессия: 3/5 | Блокеры: 0
-
-| # | ID | Гейт | Сессия | Статус | Deliverable |
-|---|----|------|:------:|:------:|-------------|
-| 1 | COND-01 | Conductor | 1 | [✓] | Full Pipeline |
-| 2 | INT-01 | Interviewer | 1 | [✓] | Brief: 12 вопросов |
-| 3 | COND-02 | Conductor (с.2) | 2 | [✓] | Контекст загружен |
-| 4 | RES-01 | Researcher (Alpha) | 2 | [✓] | 28 источников |
-| 5 | AN-01 | Data Analyst (Alpha) | 2 | [✓] | 3 фреймворка |
-| 6 | ST-01 | Strategist (Alpha) | 2 | [✓] | AI-first стратегия |
-| 7 | COND-03 | Conductor (с.3) | 3 | [→] | — |
-| 8 | RES-02 | Researcher (Beta) | 3 | [ ] | — |
-| 9 | AN-02 | Data Analyst (Beta) | 3 | [ ] | — |
-| 10 | ST-02 | Strategist (Beta) | 3 | [ ] | — |
-[... остальные гейты ...]
-
-#### Открытые вопросы
-- ⚠️ SOM рассчитан на основе 2 источников (Alpha рекомендовали верифицировать)
-
-### 6. Задача для сессии 3
-**Гейты:** COND-03 → RES-02 → AN-02 → ST-02
-**Что сделать:** Team Beta (Критики) должны:
-1. **RES-02:** Исследовать рынок EdTech с альтернативных позиций. Проверить данные Alpha. Найти контр-аргументы. Верифицировать SOM (найти 3-й источник).
-2. **AN-02:** Применить альтернативные фреймворки (Porter's 5 Forces, Blue Ocean). Найти слабости в анализе Alpha.
-3. **ST-02:** Сформулировать альтернативную стратегию. Критика стратегии Alpha с обоснованием.
-**Ожидаемый результат:** Альтернативный пакет (данные + анализ + стратегия) для передачи Медиатору в сессии 4.
-
-→ Начни как Conductor (COND-03). Загрузи доску, проверь данные Alpha, передай управление Researcher (RES-02).
----
-```
-
-## Валидация (Quality Gate)
-
-Промпт считается корректным если:
-
-- [ ] Промпт самодостаточен — можно начать работу без внешнего контекста
-- [ ] Название проекта и режим указаны
-- [ ] Номер сессии и история сессий указаны
-- [ ] Агенты и скилы для загрузки перечислены с путями к файлам (из маппинга)
-- [ ] Все 🔴 Critical данные включены полным текстом
-- [ ] Доска задач (`$board`) включена в текущем состоянии с метриками
-- [ ] Следующий гейт и задача сформулированы конкретно (гейт, действие, deliverable)
-- [ ] Открытые вопросы и блокеры зафиксированы
-- [ ] Нет запрещённых элементов (ссылки без содержания, сокращения, предположения)
-- [ ] Тест валидации (7 пунктов, шаг 4) — все «Да»
-- [ ] При аварийном режиме — промпт помечен ⚠️, указаны потерянные данные
-
-## Handoff
-Результат `$session-prompt-generator` является входными данными для:
-- **Следующая сессия** — через копирование промпта пользователем.
-- **`$handoff`** — промпт включается в файл `docs/analytics/session-N-handoff.md`.
-- **`$board`** — состояние доски сохраняется в промпте.
-
-Формат передачи: промпт в markdown, готовый к вставке в начало новой сессии.
-
-## Anti-patterns
-
-| Ошибка | Почему плохо | Как правильно |
-|--------|-------------|---------------|
-| Промпт без данных исследований | Следующая сессия потеряет все собранные факты | Включить ПОЛНЫЙ текст данных (🔴 Critical) |
-| «Продолжи работу» | Нет контекста, с чего продолжать | Конкретная задача: гейт, действие, deliverable |
-| Ссылки на файлы без содержания | Файлы могут быть недоступны | Включить содержание прямо в промпт |
-| Промпт без доски задач | Непонятно, где мы в пайплайне | Всегда включать `$board` с метриками |
-| Сокращённые артефакты | Потеря критических деталей | Полный текст каждого 🔴 Critical артефакта |
-| Пропуск открытых вопросов | Проблемы всплывут снова | Зафиксировать все блокеры и вопросы |
-| Нет инструкции по загрузке | Сессия не загрузит нужных агентов | Маппинг → конкретные пути к файлам |
-| Промпт > 50% «воды» | Размытие критических данных | Структура: блоки, таблицы, конкретика |
-| Аварийное завершение без промпта | Полная потеря контекста | Аварийный режим: минимальный промпт + пометка ⚠️ |
-
-## Шаблон вывода
-
-```
----
-## Промпт для сессии [N+1] — [Название проекта]
-
-### 1. Проект
-- **Название:** [Название]
-- **Режим:** Full Pipeline (/analyze)
-- **Сессия:** [N+1] из 5
-- **Предыдущие сессии:** 1-[N] завершены
-
-### 2. Загрузка
-Прочитай:
-- `domains/analytics/AGENTS.md`
-- `domains/analytics/.agents/skills/board/SKILL.md`
-- `domains/analytics/.agents/skills/handoff/SKILL.md`
-- `domains/analytics/.agents/skills/gates/SKILL.md`
-- [Специфичные скилы: пути к файлам]
-
-Активируй агентов: [Список агентов с ID гейтов]
-
-### 3. Что выполнено
-**Сессия 1:** [Резюме 2-3 предложения]
-**Сессия [N]:** [Резюме 2-3 предложения]
-
-**Ключевые решения:**
-| # | Решение | Обоснование | Кто принял |
-|---|---------|-------------|------------|
-| 1 | [Решение] | [Почему] | [User / Conductor] |
-
-### 4. Данные (полный текст)
-
-#### Research Brief (из INT-01)
-[ПОЛНЫЙ ТЕКСТ research brief]
-
-#### Данные исследований (из RES-xx)
-[ПОЛНЫЙ ТЕКСТ данных с источниками и URL]
-
-#### Результаты анализа (из AN-xx)
-[ПОЛНЫЙ ТЕКСТ фреймворков и выводов]
-
-#### [Другие артефакты по необходимости]
-[ПОЛНЫЙ ТЕКСТ]
-
-### 5. Текущее состояние
-
-#### Доска задач
-[Полная доска из $board с метриками прогресса]
-
-#### Открытые вопросы
-| # | Вопрос / Блокер | Severity | Для какого гейта |
-|---|-----------------|:--------:|:----------------:|
-| 1 | [Описание] | 🔴/🟡/🟢 | [ID] |
-
-### 6. Задача для сессии [N+1]
-**Гейты:** [ID список]
-**Что сделать:** [Конкретное описание по каждому гейту]
-**Ожидаемый результат:** [Deliverables]
-**Ограничения:** [Если есть]
-
-→ Начни как Conductor (COND-xx). Загрузи доску, проверь данные, передай управление [следующему агенту].
----
-```
-
-### Аварийный промпт (минимальная версия)
-
-```
----
-## ⚠️ АВАРИЙНЫЙ ПРОМПТ — Сессия [N+1] — [Название проекта]
-
-**Статус:** Сессия [N] завершилась аварийно. Возможна потеря данных.
-
-### Что сохранено
-[Всё, что удалось собрать: доска, последний deliverable, вопросы]
-
-### Что могло быть потеряно
-| # | Данные | Способ восстановления |
-|---|--------|-----------------------|
-| 1 | [Что потеряно] | [Повторный web-research / запрос у пользователя / восстановление из handoff] |
-
-### Задача
-Восстановить контекст из `docs/analytics/session-[N]-handoff.md`. Проверить целостность данных. Продолжить с гейта [ID].
-
-→ Начни как Conductor (COND-xx). Приоритет: верификация целостности данных перед продолжением.
----
-```
+---
+name: session-prompt-generator
+description: Генерация промпта для следующей сессии — сбор контекста, формирование промпта, сохранение прогресса
+---
+# Session Prompt Generator — Генерация промпта для следующей сессии
+
+## Когда использовать
+- При **завершении сессии** в Full Pipeline (`/analyze`) — перед межсессионным `$handoff`.
+- При **необходимости передать проект** другому оператору — формирование самодостаточного промпта.
+- При **запросе пользователя** «сгенерируй промпт для продолжения» — в любой момент.
+- При **аварийном завершении** сессии — сохранение максимума контекста для восстановления.
+
+> **Ключевой принцип:** следующая сессия начинается с **НУЛЯ** контекста. Промпт должен содержать всё необходимое, чтобы новая сессия продолжила работу без потерь.
+
+## Вход
+
+| Поле | Обязательно | Описание |
+|------|:-----------:|----------|
+| Состояние `$board` | ✅ | Текущая доска задач со всеми статусами |
+| Завершённые deliverables | ✅ | Полные артефакты текущей и предыдущих сессий |
+| Текущий гейт | ✅ | Где остановились (ID гейта из `$board`) |
+| Следующий гейт | ✅ | Куда переходим (ID следующего гейта) |
+| Открытые вопросы | ⬚ | Блокеры, неразрешённые конфликты, вопросы к пользователю |
+| Номер текущей сессии | ✅ | Какая сессия завершается (1-5) |
+| Название проекта | ✅ | Название аналитического проекта |
+
+### Связь с другими скилами
+| Скил | Взаимодействие | Когда |
+|------|----------------|-------|
+| `$board` | Источник: текущее состояние доски включается в промпт (блок 5) | Шаг 0 |
+| `$handoff` | Промпт включается в межсессионный handoff файл | Шаг 5 |
+| `$gates` | Источник: требования к следующему гейту определяют задачу (блок 6) | Шаг 0 |
+| Фреймворк-скилы | Завершённые фреймворки включаются полным текстом в блок 4 | Шаг 1 |
+
+## Маппинг «Сессия → Гейты → Агенты → Скилы»
+
+### Full Pipeline (`/analyze`)
+
+| Сессия | Гейты | Агенты | Обязательные скилы | Фреймворк-скилы |
+|:------:|-------|--------|-------------------|-----------------|
+| **1** | COND-01, INT-01 | Conductor, Interviewer | `$board`, `$gates`, `$handoff` | — |
+| **2** | COND-02, RES-01, AN-01, ST-01 | Conductor, Researcher, Data Analyst, Strategist | `$board`, `$gates`, `$handoff`, `$web-research` | По выбору AN-01 (min 2) |
+| **3** | COND-03, RES-02, AN-02, ST-02 | Conductor, Researcher, Data Analyst, Strategist | `$board`, `$gates`, `$handoff`, `$web-research` | По выбору AN-02 (контр-фреймворки) |
+| **4** | COND-04, MED-01 | Conductor, Mediator | `$board`, `$gates`, `$handoff` | — |
+| **5** | COND-05, DS-01, LY-01, RG-01 | Conductor, Designer, Layouter, Conductor (RG) | `$board`, `$gates`, `$handoff`, `$report-design`, `$html-pdf-report` | — |
+
+### Quick Pipeline (`/quick-insight`)
+Одна сессия — промпт не нужен (все гейты внутри одной сессии).
+
+## Протокол
+
+### Шаг 0 — Сбор состояния
+1. Прочитать текущее состояние `$board` — все гейты, статусы, deliverables.
+2. Собрать все завершённые артефакты текущей сессии.
+3. Загрузить кумулятивный индекс из предыдущих сессий (если есть).
+4. Определить следующий гейт и его требования из `$gates`.
+5. По маппингу «Сессия → Гейты → Агенты → Скилы» определить, что загружать.
+
+### Шаг 1 — Определение критических данных
+1. Выделить данные, которые **невосстановимы** без предыдущего контекста:
+
+   | Категория | Примеры | Приоритет |
+   |-----------|---------|:---------:|
+   | Ответы пользователя | Интервью (INT-01), уточнения, решения | 🔴 Critical |
+   | Собранные данные | Данные RES-xx с URL и источниками | 🔴 Critical |
+   | Результаты анализа | Фреймворки AN-xx, scoring, выводы | 🔴 Critical |
+   | Стратегические рекомендации | Стратегия ST-xx, action plan | 🔴 Critical |
+   | Вердикт Медиатора | Заключение MED-01, обоснование | 🔴 Critical |
+   | Решения пользователя | Approved, отклонения, scope-изменения | 🟡 Important |
+   | Метрики прогресса | Время на гейты, блокеры | 🟢 Nice-to-have |
+
+2. **Правило:** все 🔴 Critical данные включаются **полным текстом**. Без исключений.
+
+### Шаг 2 — Определение агентов и скилов
+1. По маппингу определить: какие агенты и скилы нужны в следующей сессии.
+2. Сформировать список файлов для загрузки (конкретные пути).
+3. Для фреймворк-скилов: указать конкретные скилы, если уже известны (из AN-01 или research brief).
+
+### Шаг 3 — Формирование промпта
+1. Заполнить шаблон промпта (6 блоков — см. ниже).
+2. Включить ПОЛНЫЙ текст критических данных (не ссылки, не резюме).
+3. Сформулировать конкретную задачу для следующей сессии.
+4. Указать, какие агенты и скилы активировать (конкретные пути к файлам).
+
+### Шаг 4 — Валидация промпта
+Тест самодостаточности — для каждого пункта ответить «можно ли без внешнего контекста?»:
+
+| # | Проверка | Результат |
+|---|----------|:---------:|
+| 1 | Можно начать работу, имея ТОЛЬКО этот промпт? | Да / Нет |
+| 2 | Нет ссылок на «предыдущий контекст» / «как обсуждалось»? | Да / Нет |
+| 3 | Все 🔴 Critical данные включены полным текстом? | Да / Нет |
+| 4 | Задача для сессии конкретна (гейт, действие, deliverable)? | Да / Нет |
+| 5 | Агенты и скилы перечислены с путями к файлам? | Да / Нет |
+| 6 | Доска задач включена? | Да / Нет |
+| 7 | Открытые вопросы зафиксированы? | Да / Нет |
+
+**Если хотя бы один = Нет — доработать промпт.**
+
+### Шаг 5 — Сохранение
+1. Включить промпт в файл `$handoff`: `docs/analytics/session-N-handoff.md`.
+2. Показать промпт пользователю для сохранения / копирования.
+3. Предупредить: «Этот промпт — вставьте его в начале следующей сессии».
+
+### Шаг 6 — Аварийный режим
+Если сессия завершается внезапно (таймаут, ошибка, потеря контекста):
+
+1. **Немедленно** сохранить всё, что доступно: доску, последний deliverable, открытые вопросы.
+2. Сформировать **аварийный промпт** (минимальная версия):
+   - Блок 1 (идентификация) — обязателен.
+   - Блок 5 (состояние доски) — обязателен.
+   - Блок 4 (данные) — всё, что удалось собрать.
+   - Блок 6 (задача) — «Восстановить контекст из session-N-handoff.md, проверить целостность данных, продолжить с гейта [ID]».
+3. Пометить промпт как **⚠️ АВАРИЙНЫЙ — возможна потеря данных**.
+4. Указать, какие данные могли быть потеряны и как восстановить (повторный `$web-research`, запрос у пользователя).
+
+## Структура генерируемого промпта
+
+### Блок 1 — Идентификация проекта
+- Название проекта.
+- Режим пайплайна (Full / Quick).
+- Номер следующей сессии.
+- Какие сессии завершены.
+
+### Блок 2 — Инструкция по загрузке
+- Прочитать AGENTS.md домена analytics.
+- Загрузить агентов, которые нужны в этой сессии (из маппинга).
+- Загрузить скилы: `$board`, `$handoff`, `$gates` + специфичные для гейтов.
+- Конкретные пути к файлам.
+
+### Блок 3 — Выполненная работа (резюме)
+- Что было сделано в предыдущих сессиях (2-3 предложения на сессию).
+- Ключевые решения и их обоснования.
+
+### Блок 4 — Критические данные
+- ПОЛНЫЙ ТЕКСТ ключевых артефактов, необходимых для продолжения.
+- Данные исследований, выводы анализов, рекомендации.
+- Ответы пользователя на интервью (если были).
+
+### Блок 5 — Текущее состояние
+- Доска задач (`$board`) в текущем состоянии.
+- Какой гейт следующий.
+- Открытые вопросы и блокеры.
+
+### Блок 6 — Задача для сессии
+- Конкретная формулировка: что нужно сделать в этой сессии.
+- Ожидаемый результат (deliverables).
+- Ограничения и особенности.
+
+## Правила формирования промпта
+
+### Обязательные правила
+1. **Самодостаточность** — промпт должен работать без ЛЮБОГО предыдущего контекста.
+2. **Полнота данных** — включать ПОЛНЫЙ текст, не ссылки и не резюме.
+3. **Конкретность задачи** — не «продолжи анализ», а «выполни RES-02: исследуй [тема] с позиции Критиков, данные Аналитиков: [данные]».
+4. **Структурированность** — чёткие блоки, маркированные заголовками.
+5. **Загрузка скилов** — явно указать какие агенты и скилы загрузить с путями к файлам.
+
+### Запрещённые элементы
+1. Ссылки на «предыдущую сессию» без полного содержания.
+2. «Как мы обсуждали» — нет контекста, нечего обсуждать.
+3. «См. результаты выше» — нет «выше», всё должно быть в промпте.
+4. Сокращённые данные — «основные выводы: ...». Нужны ВСЕ выводы.
+5. Предположения о контексте — «вы уже знаете, что...».
+
+## Пример — Промпт для сессии 3 (Team Beta: Критики)
+
+```
+---
+## Промпт для сессии 3 — Анализ рынка EdTech РФ
+
+### 1. Проект
+- **Название:** Анализ рынка EdTech РФ для корпоративного обучения
+- **Режим:** Full Pipeline (/analyze)
+- **Сессия:** 3 из 5
+- **Предыдущие сессии:** 1 (Interview + Brief), 2 (Team Alpha: Research + Analysis + Strategy)
+
+### 2. Загрузка
+Прочитай:
+- `domains/analytics/AGENTS.md`
+- `domains/analytics/.agents/skills/board/SKILL.md`
+- `domains/analytics/.agents/skills/handoff/SKILL.md`
+- `domains/analytics/.agents/skills/gates/SKILL.md`
+- `domains/analytics/.agents/skills/web-research/SKILL.md`
+- `domains/analytics/.agents/skills/competitive-analysis/SKILL.md`
+- `domains/analytics/.agents/skills/porters-five-forces/SKILL.md`
+
+Активируй агентов: Conductor (COND-03), Researcher (RES-02), Data Analyst (AN-02), Strategist (ST-02).
+Роль: **Team Beta (Критики)** — задача: критика и альтернативный анализ к результатам Team Alpha.
+
+### 3. Что выполнено
+**Сессия 1:** Проведено интервью, сформирован research brief (12 вопросов), определён scope: корпоративное обучение, B2B SaaS, РФ, горизонт 3 года. Режим оценки: scoring.
+**Сессия 2:** Team Alpha (Аналитики) провели исследование (28 источников), применили TAM/SAM/SOM + Competitive Analysis + PEST. Стратегическая рекомендация: «AI-first корпоративная обучающая платформа, фокус на компании 50-500 чел.»
+
+### 4. Данные (полный текст)
+
+#### Research Brief (из INT-01)
+1. Каков размер рынка EdTech РФ (TAM/SAM/SOM) для корпоративного обучения?
+2. Кто ключевые конкуренты и каковы их доли?
+3. Какие технологические тренды меняют рынок?
+4. Какие регуляторные факторы влияют на EdTech?
+[... все 12 вопросов ...]
+
+#### Данные исследований Team Alpha (из RES-01)
+**TAM:** $4.2B (EdTech РФ, 2026). Источник: Smart Ranking, янв 2026 ✅
+**SAM:** $1.8B (корпоративное обучение). Источник: ВШЭ, мар 2026 ✅
+**SOM:** $180M (B2B SaaS платформы). Источник: расчёт ⚠️ (2 источника вместо 3)
+
+**Конкуренты:**
+| Конкурент | Доля | Threat Score | Ключевая сила |
+|-----------|------|-------------|---------------|
+| Skillbox (B2B) | 15% | 7.2 | Бренд, контент |
+| Нетология | 12% | 6.8 | Корп. программы |
+| Яндекс Практикум | 18% | 7.6 | Экосистема Яндекса |
+[... полные данные ...]
+
+#### Результаты анализа Team Alpha (из AN-01, ST-01)
+[ПОЛНЫЙ ТЕКСТ: TAM/SAM/SOM фреймворк, Competitive Analysis, PEST, стратегические рекомендации]
+
+### 5. Текущее состояние
+
+#### Доска задач
+📊 Прогресс: 40% (6/15) | Сессия: 3/5 | Блокеры: 0
+
+| # | ID | Гейт | Сессия | Статус | Deliverable |
+|---|----|------|:------:|:------:|-------------|
+| 1 | COND-01 | Conductor | 1 | [✓] | Full Pipeline |
+| 2 | INT-01 | Interviewer | 1 | [✓] | Brief: 12 вопросов |
+| 3 | COND-02 | Conductor (с.2) | 2 | [✓] | Контекст загружен |
+| 4 | RES-01 | Researcher (Alpha) | 2 | [✓] | 28 источников |
+| 5 | AN-01 | Data Analyst (Alpha) | 2 | [✓] | 3 фреймворка |
+| 6 | ST-01 | Strategist (Alpha) | 2 | [✓] | AI-first стратегия |
+| 7 | COND-03 | Conductor (с.3) | 3 | [→] | — |
+| 8 | RES-02 | Researcher (Beta) | 3 | [ ] | — |
+| 9 | AN-02 | Data Analyst (Beta) | 3 | [ ] | — |
+| 10 | ST-02 | Strategist (Beta) | 3 | [ ] | — |
+[... остальные гейты ...]
+
+#### Открытые вопросы
+- ⚠️ SOM рассчитан на основе 2 источников (Alpha рекомендовали верифицировать)
+
+### 6. Задача для сессии 3
+**Гейты:** COND-03 → RES-02 → AN-02 → ST-02
+**Что сделать:** Team Beta (Критики) должны:
+1. **RES-02:** Исследовать рынок EdTech с альтернативных позиций. Проверить данные Alpha. Найти контр-аргументы. Верифицировать SOM (найти 3-й источник).
+2. **AN-02:** Применить альтернативные фреймворки (Porter's 5 Forces, Blue Ocean). Найти слабости в анализе Alpha.
+3. **ST-02:** Сформулировать альтернативную стратегию. Критика стратегии Alpha с обоснованием.
+**Ожидаемый результат:** Альтернативный пакет (данные + анализ + стратегия) для передачи Медиатору в сессии 4.
+
+→ Начни как Conductor (COND-03). Загрузи доску, проверь данные Alpha, передай управление Researcher (RES-02).
+---
+```
+
+## Валидация (Quality Gate)
+
+Промпт считается корректным если:
+
+- [ ] Промпт самодостаточен — можно начать работу без внешнего контекста
+- [ ] Название проекта и режим указаны
+- [ ] Номер сессии и история сессий указаны
+- [ ] Агенты и скилы для загрузки перечислены с путями к файлам (из маппинга)
+- [ ] Все 🔴 Critical данные включены полным текстом
+- [ ] Доска задач (`$board`) включена в текущем состоянии с метриками
+- [ ] Следующий гейт и задача сформулированы конкретно (гейт, действие, deliverable)
+- [ ] Открытые вопросы и блокеры зафиксированы
+- [ ] Нет запрещённых элементов (ссылки без содержания, сокращения, предположения)
+- [ ] Тест валидации (7 пунктов, шаг 4) — все «Да»
+- [ ] При аварийном режиме — промпт помечен ⚠️, указаны потерянные данные
+
+## Handoff
+Результат `$session-prompt-generator` является входными данными для:
+- **Следующая сессия** — через копирование промпта пользователем.
+- **`$handoff`** — промпт включается в файл `docs/analytics/session-N-handoff.md`.
+- **`$board`** — состояние доски сохраняется в промпте.
+
+Формат передачи: промпт в markdown, готовый к вставке в начало новой сессии.
+
+## Anti-patterns
+
+| Ошибка | Почему плохо | Как правильно |
+|--------|-------------|---------------|
+| Промпт без данных исследований | Следующая сессия потеряет все собранные факты | Включить ПОЛНЫЙ текст данных (🔴 Critical) |
+| «Продолжи работу» | Нет контекста, с чего продолжать | Конкретная задача: гейт, действие, deliverable |
+| Ссылки на файлы без содержания | Файлы могут быть недоступны | Включить содержание прямо в промпт |
+| Промпт без доски задач | Непонятно, где мы в пайплайне | Всегда включать `$board` с метриками |
+| Сокращённые артефакты | Потеря критических деталей | Полный текст каждого 🔴 Critical артефакта |
+| Пропуск открытых вопросов | Проблемы всплывут снова | Зафиксировать все блокеры и вопросы |
+| Нет инструкции по загрузке | Сессия не загрузит нужных агентов | Маппинг → конкретные пути к файлам |
+| Промпт > 50% «воды» | Размытие критических данных | Структура: блоки, таблицы, конкретика |
+| Аварийное завершение без промпта | Полная потеря контекста | Аварийный режим: минимальный промпт + пометка ⚠️ |
+
+## Шаблон вывода
+
+```
+---
+## Промпт для сессии [N+1] — [Название проекта]
+
+### 1. Проект
+- **Название:** [Название]
+- **Режим:** Full Pipeline (/analyze)
+- **Сессия:** [N+1] из 5
+- **Предыдущие сессии:** 1-[N] завершены
+
+### 2. Загрузка
+Прочитай:
+- `domains/analytics/AGENTS.md`
+- `domains/analytics/.agents/skills/board/SKILL.md`
+- `domains/analytics/.agents/skills/handoff/SKILL.md`
+- `domains/analytics/.agents/skills/gates/SKILL.md`
+- [Специфичные скилы: пути к файлам]
+
+Активируй агентов: [Список агентов с ID гейтов]
+
+### 3. Что выполнено
+**Сессия 1:** [Резюме 2-3 предложения]
+**Сессия [N]:** [Резюме 2-3 предложения]
+
+**Ключевые решения:**
+| # | Решение | Обоснование | Кто принял |
+|---|---------|-------------|------------|
+| 1 | [Решение] | [Почему] | [User / Conductor] |
+
+### 4. Данные (полный текст)
+
+#### Research Brief (из INT-01)
+[ПОЛНЫЙ ТЕКСТ research brief]
+
+#### Данные исследований (из RES-xx)
+[ПОЛНЫЙ ТЕКСТ данных с источниками и URL]
+
+#### Результаты анализа (из AN-xx)
+[ПОЛНЫЙ ТЕКСТ фреймворков и выводов]
+
+#### [Другие артефакты по необходимости]
+[ПОЛНЫЙ ТЕКСТ]
+
+### 5. Текущее состояние
+
+#### Доска задач
+[Полная доска из $board с метриками прогресса]
+
+#### Открытые вопросы
+| # | Вопрос / Блокер | Severity | Для какого гейта |
+|---|-----------------|:--------:|:----------------:|
+| 1 | [Описание] | 🔴/🟡/🟢 | [ID] |
+
+### 6. Задача для сессии [N+1]
+**Гейты:** [ID список]
+**Что сделать:** [Конкретное описание по каждому гейту]
+**Ожидаемый результат:** [Deliverables]
+**Ограничения:** [Если есть]
+
+→ Начни как Conductor (COND-xx). Загрузи доску, проверь данные, передай управление [следующему агенту].
+---
+```
+
+### Аварийный промпт (минимальная версия)
+
+```
+---
+## ⚠️ АВАРИЙНЫЙ ПРОМПТ — Сессия [N+1] — [Название проекта]
+
+**Статус:** Сессия [N] завершилась аварийно. Возможна потеря данных.
+
+### Что сохранено
+[Всё, что удалось собрать: доска, последний deliverable, вопросы]
+
+### Что могло быть потеряно
+| # | Данные | Способ восстановления |
+|---|--------|-----------------------|
+| 1 | [Что потеряно] | [Повторный web-research / запрос у пользователя / восстановление из handoff] |
+
+### Задача
+Восстановить контекст из `docs/analytics/session-[N]-handoff.md`. Проверить целостность данных. Продолжить с гейта [ID].
+
+→ Начни как Conductor (COND-xx). Приоритет: верификация целостности данных перед продолжением.
+---
+```