code-ai-installer 4.0.0 → 4.0.1-a

package/domains/analytics/.agents/skills/handoff/SKILL.md

@@ -1,380 +1,402 @@
----
-name: handoff
-description: Передача контекста между гейтами и сессиями — Handoff Envelope, межсессионный протокол, генерация файлов
----
-# Handoff — Передача контекста между гейтами и сессиями
-
-## Когда использовать
-- При **каждом переходе** между гейтами внутри сессии — стандартная передача (intra-session handoff).
-- При **завершении сессии** — межсессионная передача (multi-session handoff), сохранение в файл.
-- При **возврате на доработку** — обратная передача (reverse handoff).
-- **Обязателен** на каждом переходе, в любом режиме пайплайна. Без исключений.
-
-> **Разграничение:** `$gates` проверяет готовность. `$handoff` передаёт работу. `$board` отслеживает статус. Порядок: `$gates` PASS → `$handoff` → обновить `$board`.
-
-## Вход
-
-| Поле | Обязательно | Описание |
-|------|:-----------:|----------|
-| Результат `$gates` | ✅ | PASS или CONDITIONAL PASS — handoff невозможен при FAIL |
-| Агент-отправитель | ✅ | Кто передаёт (текущий гейт с ID) |
-| Агент-получатель | ✅ | Кому передаёт (следующий гейт с ID) |
-| Артефакты гейта | ✅ | Deliverables текущего гейта (из реестра `$gates`) |
-| Режим пайплайна | ✅ | Full (`/analyze`) / Quick (`/quick-insight`) |
-| Тип handoff | ✅ | Forward / Reverse / Session (межсессионный) |
-| Номер сессии | ⬚ | Для межсессионного handoff — текущая и следующая сессия |
-
-> **Предусловие:** Handoff возможен **только** после `$gates` PASS или CONDITIONAL PASS. При FAIL — вернуть агенту, handoff не выполняется.
-
-### Связь с другими скилами
-| Скил | Взаимодействие | Когда |
-|------|----------------|-------|
-| `$gates` | Предусловие: PASS / CONDITIONAL PASS → разрешает handoff. Gate check приложен к конверту | Перед каждым handoff |
-| `$board` | После handoff: обновить статусы гейтов (текущий → `[✓]`, следующий → `[→]`) | После каждого handoff |
-| `$session-prompt-generator` | Для Session handoff: генерация промпта следующей сессии, включается в файл | При завершении сессии |
-| Фреймворк-скилы | Артефакты фреймворков (заполненные шаблоны) — часть deliverables AN-xx гейтов | При передаче от Data Analyst |
-
-## Типы handoff
-
-| Тип | Описание | Файл | Контекст следующего получателя |
-|-----|----------|------|-------------------------------|
-| **Forward** | Стандартная передача между гейтами внутри сессии | Нет (в памяти) | Полный контекст сессии доступен |
-| **Reverse** | Возврат на доработку | Нет (в памяти) | Полный контекст сессии доступен |
-| **Session** | Межсессионная передача | `docs/analytics/session-N-handoff.md` | **НОЛЬ** предыдущего контекста — файл должен быть самодостаточным |
-
-> **Ключевое правило межсессионного handoff:** следующая сессия начинается с НУЛЯ контекста. Файл handoff — единственный источник информации. Никаких ссылок на «см. выше» или «как обсуждалось». Всё должно быть в файле.
-
-## Реестр передач — что передавать
-
-### Full Pipeline (inter-gate)
-
-| Переход | Артефакты | Ключевой контекст |
-|---------|-----------|-------------------|
-| **COND-01 → INT-01** | Scope задачи, режим, доска | Бизнес-вопрос, ограничения, ожидания |
-| **INT-01 → Session Handoff** | Research brief, контекст интервью, режим оценки | Все ответы пользователя, выбранные метрики |
-| **COND-02 → RES-01** | Session-1 handoff, research brief | Полный контекст из интервью, вопросы для исследования |
-| **RES-01 → AN-01** | Данные, источники, факты | Верифицированные данные с URL и датами |
-| **AN-01 → ST-01** | Фреймворки, анализ, паттерны | Методология, ключевые инсайты |
-| **ST-01 → Session Handoff** | Стратегия, рекомендации | Полный пакет Аналитиков для Критиков и Медиатора |
-| **COND-03 → RES-02** | Session-2 handoff, результаты Аналитиков | Данные для критики и альтернативного исследования |
-| **RES-02 → AN-02** | Альтернативные данные, критика | Контр-данные с источниками |
-| **AN-02 → ST-02** | Альтернативный анализ | Контр-фреймворки, различия с Аналитиками |
-| **ST-02 → Session Handoff** | Альтернативная стратегия, критика | Полный пакет Критиков |
-| **COND-04 → MED-01** | Session-2 + Session-3 handoff | Оба пакета (Аналитики + Критики) |
-| **MED-01 → Session Handoff** | Финальное заключение, оценки | Итоговый вердикт, обоснование |
-| **COND-05 → DS-01** | Session-4 handoff | Заключение Медиатора для визуализации |
-| **DS-01 → LY-01** | Макет, спецификации визуализаций | Структура отчёта, палитра, шрифты |
-
-### Quick Pipeline (inter-gate)
-
-| Переход | Артефакты | Ключевой контекст |
-|---------|-----------|-------------------|
-| **COND-01 → INT-01** | Scope задачи, режим, доска | Бизнес-вопрос, ограничения |
-| **INT-01 → RES-01** | Research brief, режим оценки | Вопросы для исследования, метрики |
-| **RES-01 → AN-01** | Данные, источники, факты | Верифицированные данные с URL и датами |
-| **AN-01 → ST-01** | Фреймворки, анализ, паттерны | Методология, инсайты |
-| **ST-01 → MED-01** | Стратегия, рекомендации | Выводы и рекомендации (без конкурирующей команды) |
-| **MED-01 → DS-01** | Итоговое заключение | Финальный вердикт для визуализации |
-| **DS-01 → LY-01** | Макет, спецификации | Структура отчёта, палитра |
-
-## Межсессионный Handoff (Session)
-
-### Структура файла `docs/analytics/session-N-handoff.md`
-
-Файл содержит **весь** необходимый контекст. Никаких ссылок, никаких сокращений.
-
-```markdown
-# Session [N] Handoff — [Название проекта]
-
-## Meta
-- **Проект:** [Название]
-- **Дата:** [YYYY-MM-DD]
-- **Сессия:** [N] из [M]
-- **Режим:** Full / Quick
-- **Завершённые гейты:** [список ID с deliverables]
-- **Следующий гейт:** [ID] [Название]
-
-## Краткое резюме
-[2-3 предложения: что было сделано в этой сессии, ключевой результат]
-
-## Состояние доски ($board)
-[Полная копия таблицы доски в текущем состоянии + метрики прогресса]
-
-## Полное содержание артефактов
-
-### [Артефакт 1 — Название]
-[ПОЛНЫЙ ТЕКСТ артефакта, не ссылка и не краткое описание]
-
-### [Артефакт 2 — Название]
-[ПОЛНЫЙ ТЕКСТ артефакта]
-
-### [Артефакт N — ...]
-[ПОЛНЫЙ ТЕКСТ]
-
-## Решения и контекст
-| # | Решение | Обоснование | Принято кем | Влияет на |
-|---|---------|-------------|-------------|-----------|
-| 1 | [Что решили] | [Почему] | [User / Conductor] | [Какие гейты] |
-
-## Открытые вопросы и блокеры
-| # | Вопрос / Блокер | Severity | Для какого гейта | Статус |
-|---|-----------------|:--------:|:----------------:|--------|
-| 1 | [Описание] | 🔴/🟡/🟢 | [ID гейта] | Открыт / Разрешён |
-
-## Кумулятивный индекс
-| Сессия | Гейты | Ключевые артефакты | Файл |
-|--------|-------|--------------------|------|
-| 1 | COND-01, INT-01 | Research brief, контекст интервью | session-1-handoff.md |
-| 2 | RES-01, AN-01, ST-01 | Данные, анализ, стратегия Аналитиков | session-2-handoff.md |
-| [N] | [...] | [...] | session-N-handoff.md |
-
-## Промпт для следующей сессии
-[Генерируется через $session-prompt-generator — готовый к вставке промпт]
-
-## Чек-лист верификации
-- [ ] Все артефакты включены полностью (не ссылками)
-- [ ] Доска задач ($board) сохранена в текущем состоянии
-- [ ] Решения и контекст зафиксированы
-- [ ] Открытые вопросы / блокеры зафиксированы
-- [ ] Кумулятивный индекс актуален
-- [ ] Промпт для следующей сессии сгенерирован
-- [ ] Файл самодостаточен — тест: можно прочитать без ЛЮБОГО предыдущего контекста
-```
-
-### Протокол восстановления (повреждённый / неполный handoff)
-
-При загрузке session handoff в новой сессии — Conductor выполняет верификацию:
-
-| Проверка | Действие при провале |
-|----------|---------------------|
-| Файл не найден | Запросить у пользователя путь или пересоздать из памяти предыдущей сессии |
-| Артефакты неполные (есть ссылки вместо контента) | Пометить как ⚠️, запросить недостающее у пользователя |
-| Кумулятивный индекс не совпадает с содержанием | Пересобрать индекс из фактического содержания файлов |
-| Промпт отсутствует | Сгенерировать через `$session-prompt-generator` |
-| Доска отсутствует | Восстановить из кумулятивного индекса + артефактов |
-
-> При любом восстановлении — явно сообщить пользователю, что handoff был неполным и что было восстановлено.
-
-## Обратный Handoff (Reverse)
-
-### Когда происходит
-- `$gates` — FAIL.
-- Mediator обнаружил критические расхождения в данных.
-- Пользователь запросил доработку.
-- Следующий гейт обнаружил проблему с артефактом предыдущего.
-
-### Протокол reverse handoff
-1. Указать **причину возврата** — конкретные gap'ы / замечания.
-2. Указать **что именно доработать** — не «переделай», а «проверь источник X: данные 2023 года, нужны актуальные за 2025».
-3. Указать **что НЕ трогать** — что уже одобрено и не нуждается в изменениях.
-4. Обновить `$board` — гейт-получатель → `[↩] Возврат`, гейт-отправитель → `[→] В работе`.
-5. После доработки — повторная `$gates` проверка → forward handoff.
-
-## Подтверждение получения (Receive Acknowledgement)
-
-При получении handoff агент-получатель обязан:
-
-1. **Подтвердить загрузку:** «Handoff от [ID] получен, [N] артефактов загружено».
-2. **Перечислить полученное:** список артефактов с кратким описанием.
-3. **Отметить gap'ы:** если CONDITIONAL PASS — явно перечислить полученные gap'ы.
-4. **Зафиксировать проблемы:** если артефакт неполный или непонятный — запросить уточнение до начала работы (не додумывать).
-
-> Acknowledge встраивается в начало работы следующего гейта. Это не отдельный шаг, а первый абзац deliverable.
-
-## Протокол
-
-### Шаг 0 — Определение типа handoff
-1. Forward (внутри сессии), Reverse (возврат), Session (межсессионный).
-2. Для Session — определить путь файла: `docs/analytics/session-N-handoff.md`.
-
-### Шаг 1 — Предусловия
-1. Убедиться, что `$gates` дал PASS или CONDITIONAL PASS (кроме Reverse).
-2. Определить агента-получателя по реестру.
-3. Собрать все артефакты из реестра передач.
-
-### Шаг 2 — Формирование конверта
-1. Для Forward: заполнить стандартный шаблон конверта.
-2. Для Session: заполнить шаблон файла, включить ПОЛНОЕ содержание артефактов.
-3. Для Reverse: заполнить обратный конверт с gap'ами.
-4. Для CONDITIONAL PASS — явно указать gap'ы, которые передаются.
-
-### Шаг 3 — User sign-off
-1. Показать конверт пользователю.
-2. Ожидать явное **"Approved"**.
-3. Не переходить без Approved. Без исключений.
-
-### Шаг 4 — Сохранение и активация
-1. Для Session: сохранить файл в `docs/analytics/session-N-handoff.md`.
-2. Обновить `$board`: текущий гейт → `[✓] Завершён`, следующий → `[→] В работе`.
-3. Добавить запись в лог передач.
-4. Для Session: вызвать `$session-prompt-generator` для генерации промпта.
-
-## Пример — Forward Handoff RES-01 → AN-01 (CONDITIONAL PASS)
-
-```
-### Handoff Envelope — RES-01 Researcher (Аналитики) → AN-01 Data Analyst (Аналитики)
-
-**Тип:** Forward
-**Режим:** Full Pipeline
-**Сессия:** 2
-**Gate Check:** CONDITIONAL PASS (итерация 1) — 2 Gap'а
-**Дата:** 2026-04-12
-
----
-
-**Артефакты:**
-
-1. **Research Report** — 7 секций по research brief INT-01:
-   - Размер рынка EdTech РФ (TAM $4.2B, SAM $1.8B, SOM $180M)
-   - Ключевые игроки: Skillbox, Нетология, Яндекс Практикум, GeekBrains, Skyeng
-   - Тренды: AI-персонализация, корпоративное обучение, микро-сертификации
-   - Регуляторная среда: лицензирование, аккредитация
-   - Клиентские сегменты: B2C (25-35), B2B (корп. обучение), B2G (Минпросвещения)
-   - Ценообразование: подписка $15-80/мес, корпоративные контракты $5K-50K/год
-   - Барьеры входа: бренд, контент, преподаватели
-
-2. **Таблица источников** — 28 источников, URL, даты, достоверность (✅/⚠️/🔮)
-
-**Gap'ы (CONDITIONAL PASS):**
-- ⚠️ TAM рынка EdTech: 2 источника вместо 3 (Smart Ranking + ВШЭ, нет третьего)
-- ⚠️ Отчёт IDC по корп. обучению: 14 месяцев (янв 2025), рекомендуется верифицировать
-
----
-
-**Задача для AN-01 Data Analyst (Аналитики):**
-Применить фреймворки конкурентного анализа и оценки рынка к данным RES-01. Минимум 2 фреймворка. Учесть gap'ы: TAM помечен как ⚠️ Estimated, данные IDC пометить как ⚠️.
-
-**Ожидаемый deliverable:**
-Заполненные фреймворки с привязкой к данным RES-01, паттерны, инсайты, методология.
-
-**Блокеры:** Нет
-
----
-
-→ Ожидаю **"Approved"** для перехода к **AN-01 Data Analyst (Аналитики)**
-```
-
-## Валидация конверта (Quality Gate)
-
-### Стандартный (Forward) конверт
-- [ ] Результат `$gates` приложен (PASS / CONDITIONAL PASS)
-- [ ] Агент-отправитель и получатель указаны с ID гейтов
-- [ ] Все артефакты из реестра передач приложены
-- [ ] Задача для следующего агента сформулирована конкретно
-- [ ] Gap'ы (если CONDITIONAL) явно перечислены
-- [ ] Контекст передан
-- [ ] User Approved получен
-- [ ] `$board` обновлён
-
-### Межсессионный (Session) конверт — дополнительно
-- [ ] Файл сохранён по пути `docs/analytics/session-N-handoff.md`
-- [ ] Все артефакты включены **полным текстом** (не ссылками и не резюме)
-- [ ] Состояние доски сохранено
-- [ ] Решения и контекст зафиксированы
-- [ ] Открытые вопросы / блокеры зафиксированы
-- [ ] Кумулятивный индекс актуален
-- [ ] Промпт для следующей сессии сгенерирован
-- [ ] Файл самодостаточен — тест: можно прочитать без ЛЮБОГО предыдущего контекста
-
-## Handoff
-Результат `$handoff` является входными данными для: следующего агента в пайплайне, `$board` (обновление статусов), `$session-prompt-generator` (для межсессионных handoff).
-
-## Anti-patterns
-
-| Ошибка | Почему плохо | Как правильно |
-|--------|-------------|---------------|
-| Handoff без `$gates` | Непроверенные артефакты → проблемы на следующем гейте | Всегда `$gates` PASS → затем handoff |
-| Handoff без Approved | Нарушение протокола, пользователь не в курсе | Всегда ждать явное Approved |
-| Session handoff со ссылками вместо контента | Следующая сессия не имеет доступа к контексту | ПОЛНЫЙ текст артефактов в файле |
-| «Сделай анализ» вместо задачи | Агент не знает scope | Конкретная задача с параметрами и ожидаемым deliverable |
-| Передача без артефактов | Следующий агент работает вслепую | Все артефакты из реестра приложены |
-| Reverse handoff без конкретики | Агент не знает что исправлять | Конкретные gap'ы + что НЕ трогать |
-| Не обновить `$board` | Доска рассинхронизирована | Обновлять `$board` при каждом handoff |
-| Потеря контекста между сессиями | Следующая сессия начинает с нуля | Межсессионный handoff с полным содержанием |
-| Получатель не подтвердил загрузку | Неясно, все ли артефакты получены и поняты | Receive Acknowledgement в начале работы следующего гейта |
-| Повреждённый session файл | Следующая сессия работает с неполными данными | Протокол восстановления: верификация при загрузке |
-
-## Шаблоны вывода
-
-### Forward Handoff (внутри сессии)
-
-```
-### Handoff Envelope — [ID From] [Агент From] → [ID To] [Агент To]
-
-**Тип:** Forward
-**Режим:** [Full / Quick]
-**Сессия:** [N]
-**Gate Check:** [PASS / CONDITIONAL PASS] (итерация [N])
-**Дата:** [YYYY-MM-DD]
-
----
-
-**Артефакты:**
-- [Артефакт 1 — описание]
-- [Артефакт 2 — описание]
-
-**Gap'ы (если CONDITIONAL):**
-- [Gap 1 — что учесть]
-
----
-
-**Задача для [Агент To]:**
-[Чёткая конкретная формулировка]
-
-**Ожидаемый deliverable:**
-[Что должен вернуть следующий агент]
-
-**Блокеры:**
-[Список или «Нет»]
-
----
-
-→ Ожидаю **"Approved"** для перехода к **[ID To] [Агент To]**
-```
-
-### Reverse Handoff
-
-```
-### Reverse Handoff — [ID From] [Агент From] → [ID To] [Агент To] (возврат)
-
-**Тип:** Reverse
-**Причина:** [FAIL / feedback / расхождения в данных]
-**Дата:** [YYYY-MM-DD]
-
----
-
-**Что исправить:**
-| # | Gap / Замечание | Sev | Конкретное действие |
-|---|----------------|:---:|---------------------|
-| 1 | [описание] | [B] | [что сделать] |
-
-**Что НЕ трогать:**
-- [Артефакт / секция, которая уже одобрена]
-
----
-
-→ После доработки — повторная проверка `$gates` (итерация [N+1])
-→ Ожидаю **"Approved"** на возврат
-```
-
-### Receive Acknowledgement (начало работы получателя)
-
-```
-**Handoff получен:** [ID From] → [ID To]
-**Артефакты загружены:** [N] шт.
-- [Артефакт 1] — ✅ получен
-- [Артефакт 2] — ✅ получен
-
-**Gap'ы принятые:** [список или «Нет»]
-**Проблемы при загрузке:** [список или «Нет»]
-```
-
-## Общие правила handoff-документа (cross-domain)
-
-> Применяется к **любому** handoff-документу, передающему контекст сессии свежему агенту (session-handoff / conversation summary). Дополняет, не заменяет, разделы про inter-gate / межсессионный handoff выше — в частности, при использовании `os.tmpdir()` вместо `docs/analytics/session-N-handoff.md` для lightweight conversation summary.
-
-1. **Куда сохранять.** Файл — во временную директорию ОС (`%TEMP%` / `/tmp` / `os.tmpdir()`), **не** в рабочий репозиторий. Workspace остаётся чистым; путь к временному файлу цитируется в чате следующей сессии.
-2. **Секция «Suggested skills».** Обязательна секция со списком скиллов, которые свежему агенту имеет смысл подгрузить первым же действием (`$skill-1`, `$skill-2`, ...). Сокращает context-warm-up.
-3. **Не дублировать артефакты.** Если данные уже в PRD / plan / ADR / commit / diff / issue — давать **ссылку по пути или URL**, не копировать содержимое. Дубль создаёт drift между источниками. (Конфликт с правилом «ПОЛНЫЙ ТЕКСТ артефактов» для legacy session-handoff в `docs/analytics/` — там правило сохраняется; здесь действует для temp-варианта.)
-4. **Редакция чувствительных данных.** Перед сохранением — удалить API-ключи, пароли, токены, PII (email, телефон, реальные имена клиентов). Временная директория тоже потенциальный leak-вектор.
-5. **Аргументы юзера = фокус следующей сессии.** Если `/handoff` вызван с аргументом-строкой — трактовать её как описание задачи следующей сессии; адаптировать summary и suggested-skills под этот фокус.
+---
+name: handoff
+description: Передача контекста между гейтами и сессиями — Handoff Envelope, межсессионный протокол, генерация файлов
+type: mandatory
+domain: analytics
+owners:
+  - conductor
+gates:
+  - INTERVIEWER
+  - RESEARCHER
+  - DATA_ANALYST
+  - STRATEGIST
+  - MEDIATOR
+  - DESIGNER
+  - LAYOUTER
+  - RELEASE_GATE
+tech: []
+topic: []
+triggers:
+  - handoff
+  - Передача контекста между гейтами и сессиями
+  - Передача контекста между гейтами и сессиями — Handoff Envelope, межсессионный протокол, генерация файлов
+related: []
+budget_lines: 402
+schema_version: 1
+---
+# Handoff — Передача контекста между гейтами и сессиями
+
+## Когда использовать
+- При **каждом переходе** между гейтами внутри сессии — стандартная передача (intra-session handoff).
+- При **завершении сессии** — межсессионная передача (multi-session handoff), сохранение в файл.
+- При **возврате на доработку** — обратная передача (reverse handoff).
+- **Обязателен** на каждом переходе, в любом режиме пайплайна. Без исключений.
+
+> **Разграничение:** `$gates` проверяет готовность. `$handoff` передаёт работу. `$board` отслеживает статус. Порядок: `$gates` PASS → `$handoff` → обновить `$board`.
+
+## Вход
+
+| Поле | Обязательно | Описание |
+|------|:-----------:|----------|
+| Результат `$gates` | ✅ | PASS или CONDITIONAL PASS — handoff невозможен при FAIL |
+| Агент-отправитель | ✅ | Кто передаёт (текущий гейт с ID) |
+| Агент-получатель | ✅ | Кому передаёт (следующий гейт с ID) |
+| Артефакты гейта | ✅ | Deliverables текущего гейта (из реестра `$gates`) |
+| Режим пайплайна | ✅ | Full (`/analyze`) / Quick (`/quick-insight`) |
+| Тип handoff | ✅ | Forward / Reverse / Session (межсессионный) |
+| Номер сессии | ⬚ | Для межсессионного handoff — текущая и следующая сессия |
+
+> **Предусловие:** Handoff возможен **только** после `$gates` PASS или CONDITIONAL PASS. При FAIL — вернуть агенту, handoff не выполняется.
+
+### Связь с другими скилами
+| Скил | Взаимодействие | Когда |
+|------|----------------|-------|
+| `$gates` | Предусловие: PASS / CONDITIONAL PASS → разрешает handoff. Gate check приложен к конверту | Перед каждым handoff |
+| `$board` | После handoff: обновить статусы гейтов (текущий → `[✓]`, следующий → `[→]`) | После каждого handoff |
+| `$session-prompt-generator` | Для Session handoff: генерация промпта следующей сессии, включается в файл | При завершении сессии |
+| Фреймворк-скилы | Артефакты фреймворков (заполненные шаблоны) — часть deliverables AN-xx гейтов | При передаче от Data Analyst |
+
+## Типы handoff
+
+| Тип | Описание | Файл | Контекст следующего получателя |
+|-----|----------|------|-------------------------------|
+| **Forward** | Стандартная передача между гейтами внутри сессии | Нет (в памяти) | Полный контекст сессии доступен |
+| **Reverse** | Возврат на доработку | Нет (в памяти) | Полный контекст сессии доступен |
+| **Session** | Межсессионная передача | `docs/analytics/session-N-handoff.md` | **НОЛЬ** предыдущего контекста — файл должен быть самодостаточным |
+
+> **Ключевое правило межсессионного handoff:** следующая сессия начинается с НУЛЯ контекста. Файл handoff — единственный источник информации. Никаких ссылок на «см. выше» или «как обсуждалось». Всё должно быть в файле.
+
+## Реестр передач — что передавать
+
+### Full Pipeline (inter-gate)
+
+| Переход | Артефакты | Ключевой контекст |
+|---------|-----------|-------------------|
+| **COND-01 → INT-01** | Scope задачи, режим, доска | Бизнес-вопрос, ограничения, ожидания |
+| **INT-01 → Session Handoff** | Research brief, контекст интервью, режим оценки | Все ответы пользователя, выбранные метрики |
+| **COND-02 → RES-01** | Session-1 handoff, research brief | Полный контекст из интервью, вопросы для исследования |
+| **RES-01 → AN-01** | Данные, источники, факты | Верифицированные данные с URL и датами |
+| **AN-01 → ST-01** | Фреймворки, анализ, паттерны | Методология, ключевые инсайты |
+| **ST-01 → Session Handoff** | Стратегия, рекомендации | Полный пакет Аналитиков для Критиков и Медиатора |
+| **COND-03 → RES-02** | Session-2 handoff, результаты Аналитиков | Данные для критики и альтернативного исследования |
+| **RES-02 → AN-02** | Альтернативные данные, критика | Контр-данные с источниками |
+| **AN-02 → ST-02** | Альтернативный анализ | Контр-фреймворки, различия с Аналитиками |
+| **ST-02 → Session Handoff** | Альтернативная стратегия, критика | Полный пакет Критиков |
+| **COND-04 → MED-01** | Session-2 + Session-3 handoff | Оба пакета (Аналитики + Критики) |
+| **MED-01 → Session Handoff** | Финальное заключение, оценки | Итоговый вердикт, обоснование |
+| **COND-05 → DS-01** | Session-4 handoff | Заключение Медиатора для визуализации |
+| **DS-01 → LY-01** | Макет, спецификации визуализаций | Структура отчёта, палитра, шрифты |
+
+### Quick Pipeline (inter-gate)
+
+| Переход | Артефакты | Ключевой контекст |
+|---------|-----------|-------------------|
+| **COND-01 → INT-01** | Scope задачи, режим, доска | Бизнес-вопрос, ограничения |
+| **INT-01 → RES-01** | Research brief, режим оценки | Вопросы для исследования, метрики |
+| **RES-01 → AN-01** | Данные, источники, факты | Верифицированные данные с URL и датами |
+| **AN-01 → ST-01** | Фреймворки, анализ, паттерны | Методология, инсайты |
+| **ST-01 → MED-01** | Стратегия, рекомендации | Выводы и рекомендации (без конкурирующей команды) |
+| **MED-01 → DS-01** | Итоговое заключение | Финальный вердикт для визуализации |
+| **DS-01 → LY-01** | Макет, спецификации | Структура отчёта, палитра |
+
+## Межсессионный Handoff (Session)
+
+### Структура файла `docs/analytics/session-N-handoff.md`
+
+Файл содержит **весь** необходимый контекст. Никаких ссылок, никаких сокращений.
+
+```markdown
+# Session [N] Handoff — [Название проекта]
+
+## Meta
+- **Проект:** [Название]
+- **Дата:** [YYYY-MM-DD]
+- **Сессия:** [N] из [M]
+- **Режим:** Full / Quick
+- **Завершённые гейты:** [список ID с deliverables]
+- **Следующий гейт:** [ID] [Название]
+
+## Краткое резюме
+[2-3 предложения: что было сделано в этой сессии, ключевой результат]
+
+## Состояние доски ($board)
+[Полная копия таблицы доски в текущем состоянии + метрики прогресса]
+
+## Полное содержание артефактов
+
+### [Артефакт 1 — Название]
+[ПОЛНЫЙ ТЕКСТ артефакта, не ссылка и не краткое описание]
+
+### [Артефакт 2 — Название]
+[ПОЛНЫЙ ТЕКСТ артефакта]
+
+### [Артефакт N — ...]
+[ПОЛНЫЙ ТЕКСТ]
+
+## Решения и контекст
+| # | Решение | Обоснование | Принято кем | Влияет на |
+|---|---------|-------------|-------------|-----------|
+| 1 | [Что решили] | [Почему] | [User / Conductor] | [Какие гейты] |
+
+## Открытые вопросы и блокеры
+| # | Вопрос / Блокер | Severity | Для какого гейта | Статус |
+|---|-----------------|:--------:|:----------------:|--------|
+| 1 | [Описание] | 🔴/🟡/🟢 | [ID гейта] | Открыт / Разрешён |
+
+## Кумулятивный индекс
+| Сессия | Гейты | Ключевые артефакты | Файл |
+|--------|-------|--------------------|------|
+| 1 | COND-01, INT-01 | Research brief, контекст интервью | session-1-handoff.md |
+| 2 | RES-01, AN-01, ST-01 | Данные, анализ, стратегия Аналитиков | session-2-handoff.md |
+| [N] | [...] | [...] | session-N-handoff.md |
+
+## Промпт для следующей сессии
+[Генерируется через $session-prompt-generator — готовый к вставке промпт]
+
+## Чек-лист верификации
+- [ ] Все артефакты включены полностью (не ссылками)
+- [ ] Доска задач ($board) сохранена в текущем состоянии
+- [ ] Решения и контекст зафиксированы
+- [ ] Открытые вопросы / блокеры зафиксированы
+- [ ] Кумулятивный индекс актуален
+- [ ] Промпт для следующей сессии сгенерирован
+- [ ] Файл самодостаточен — тест: можно прочитать без ЛЮБОГО предыдущего контекста
+```
+
+### Протокол восстановления (повреждённый / неполный handoff)
+
+При загрузке session handoff в новой сессии — Conductor выполняет верификацию:
+
+| Проверка | Действие при провале |
+|----------|---------------------|
+| Файл не найден | Запросить у пользователя путь или пересоздать из памяти предыдущей сессии |
+| Артефакты неполные (есть ссылки вместо контента) | Пометить как ⚠️, запросить недостающее у пользователя |
+| Кумулятивный индекс не совпадает с содержанием | Пересобрать индекс из фактического содержания файлов |
+| Промпт отсутствует | Сгенерировать через `$session-prompt-generator` |
+| Доска отсутствует | Восстановить из кумулятивного индекса + артефактов |
+
+> При любом восстановлении — явно сообщить пользователю, что handoff был неполным и что было восстановлено.
+
+## Обратный Handoff (Reverse)
+
+### Когда происходит
+- `$gates` — FAIL.
+- Mediator обнаружил критические расхождения в данных.
+- Пользователь запросил доработку.
+- Следующий гейт обнаружил проблему с артефактом предыдущего.
+
+### Протокол reverse handoff
+1. Указать **причину возврата** — конкретные gap'ы / замечания.
+2. Указать **что именно доработать** — не «переделай», а «проверь источник X: данные 2023 года, нужны актуальные за 2025».
+3. Указать **что НЕ трогать** — что уже одобрено и не нуждается в изменениях.
+4. Обновить `$board` — гейт-получатель → `[↩] Возврат`, гейт-отправитель → `[→] В работе`.
+5. После доработки — повторная `$gates` проверка → forward handoff.
+
+## Подтверждение получения (Receive Acknowledgement)
+
+При получении handoff агент-получатель обязан:
+
+1. **Подтвердить загрузку:** «Handoff от [ID] получен, [N] артефактов загружено».
+2. **Перечислить полученное:** список артефактов с кратким описанием.
+3. **Отметить gap'ы:** если CONDITIONAL PASS — явно перечислить полученные gap'ы.
+4. **Зафиксировать проблемы:** если артефакт неполный или непонятный — запросить уточнение до начала работы (не додумывать).
+
+> Acknowledge встраивается в начало работы следующего гейта. Это не отдельный шаг, а первый абзац deliverable.
+
+## Протокол
+
+### Шаг 0 — Определение типа handoff
+1. Forward (внутри сессии), Reverse (возврат), Session (межсессионный).
+2. Для Session — определить путь файла: `docs/analytics/session-N-handoff.md`.
+
+### Шаг 1 — Предусловия
+1. Убедиться, что `$gates` дал PASS или CONDITIONAL PASS (кроме Reverse).
+2. Определить агента-получателя по реестру.
+3. Собрать все артефакты из реестра передач.
+
+### Шаг 2 — Формирование конверта
+1. Для Forward: заполнить стандартный шаблон конверта.
+2. Для Session: заполнить шаблон файла, включить ПОЛНОЕ содержание артефактов.
+3. Для Reverse: заполнить обратный конверт с gap'ами.
+4. Для CONDITIONAL PASS — явно указать gap'ы, которые передаются.
+
+### Шаг 3 — User sign-off
+1. Показать конверт пользователю.
+2. Ожидать явное **"Approved"**.
+3. Не переходить без Approved. Без исключений.
+
+### Шаг 4 — Сохранение и активация
+1. Для Session: сохранить файл в `docs/analytics/session-N-handoff.md`.
+2. Обновить `$board`: текущий гейт → `[✓] Завершён`, следующий → `[→] В работе`.
+3. Добавить запись в лог передач.
+4. Для Session: вызвать `$session-prompt-generator` для генерации промпта.
+
+## Пример — Forward Handoff RES-01 → AN-01 (CONDITIONAL PASS)
+
+```
+### Handoff Envelope — RES-01 Researcher (Аналитики) → AN-01 Data Analyst (Аналитики)
+
+**Тип:** Forward
+**Режим:** Full Pipeline
+**Сессия:** 2
+**Gate Check:** CONDITIONAL PASS (итерация 1) — 2 Gap'а
+**Дата:** 2026-04-12
+
+---
+
+**Артефакты:**
+
+1. **Research Report** — 7 секций по research brief INT-01:
+   - Размер рынка EdTech РФ (TAM $4.2B, SAM $1.8B, SOM $180M)
+   - Ключевые игроки: Skillbox, Нетология, Яндекс Практикум, GeekBrains, Skyeng
+   - Тренды: AI-персонализация, корпоративное обучение, микро-сертификации
+   - Регуляторная среда: лицензирование, аккредитация
+   - Клиентские сегменты: B2C (25-35), B2B (корп. обучение), B2G (Минпросвещения)
+   - Ценообразование: подписка $15-80/мес, корпоративные контракты $5K-50K/год
+   - Барьеры входа: бренд, контент, преподаватели
+
+2. **Таблица источников** — 28 источников, URL, даты, достоверность (✅/⚠️/🔮)
+
+**Gap'ы (CONDITIONAL PASS):**
+- ⚠️ TAM рынка EdTech: 2 источника вместо 3 (Smart Ranking + ВШЭ, нет третьего)
+- ⚠️ Отчёт IDC по корп. обучению: 14 месяцев (янв 2025), рекомендуется верифицировать
+
+---
+
+**Задача для AN-01 Data Analyst (Аналитики):**
+Применить фреймворки конкурентного анализа и оценки рынка к данным RES-01. Минимум 2 фреймворка. Учесть gap'ы: TAM помечен как ⚠️ Estimated, данные IDC пометить как ⚠️.
+
+**Ожидаемый deliverable:**
+Заполненные фреймворки с привязкой к данным RES-01, паттерны, инсайты, методология.
+
+**Блокеры:** Нет
+
+---
+
+→ Ожидаю **"Approved"** для перехода к **AN-01 Data Analyst (Аналитики)**
+```
+
+## Валидация конверта (Quality Gate)
+
+### Стандартный (Forward) конверт
+- [ ] Результат `$gates` приложен (PASS / CONDITIONAL PASS)
+- [ ] Агент-отправитель и получатель указаны с ID гейтов
+- [ ] Все артефакты из реестра передач приложены
+- [ ] Задача для следующего агента сформулирована конкретно
+- [ ] Gap'ы (если CONDITIONAL) явно перечислены
+- [ ] Контекст передан
+- [ ] User Approved получен
+- [ ] `$board` обновлён
+
+### Межсессионный (Session) конверт — дополнительно
+- [ ] Файл сохранён по пути `docs/analytics/session-N-handoff.md`
+- [ ] Все артефакты включены **полным текстом** (не ссылками и не резюме)
+- [ ] Состояние доски сохранено
+- [ ] Решения и контекст зафиксированы
+- [ ] Открытые вопросы / блокеры зафиксированы
+- [ ] Кумулятивный индекс актуален
+- [ ] Промпт для следующей сессии сгенерирован
+- [ ] Файл самодостаточен — тест: можно прочитать без ЛЮБОГО предыдущего контекста
+
+## Handoff
+Результат `$handoff` является входными данными для: следующего агента в пайплайне, `$board` (обновление статусов), `$session-prompt-generator` (для межсессионных handoff).
+
+## Anti-patterns
+
+| Ошибка | Почему плохо | Как правильно |
+|--------|-------------|---------------|
+| Handoff без `$gates` | Непроверенные артефакты → проблемы на следующем гейте | Всегда `$gates` PASS → затем handoff |
+| Handoff без Approved | Нарушение протокола, пользователь не в курсе | Всегда ждать явное Approved |
+| Session handoff со ссылками вместо контента | Следующая сессия не имеет доступа к контексту | ПОЛНЫЙ текст артефактов в файле |
+| «Сделай анализ» вместо задачи | Агент не знает scope | Конкретная задача с параметрами и ожидаемым deliverable |
+| Передача без артефактов | Следующий агент работает вслепую | Все артефакты из реестра приложены |
+| Reverse handoff без конкретики | Агент не знает что исправлять | Конкретные gap'ы + что НЕ трогать |
+| Не обновить `$board` | Доска рассинхронизирована | Обновлять `$board` при каждом handoff |
+| Потеря контекста между сессиями | Следующая сессия начинает с нуля | Межсессионный handoff с полным содержанием |
+| Получатель не подтвердил загрузку | Неясно, все ли артефакты получены и поняты | Receive Acknowledgement в начале работы следующего гейта |
+| Повреждённый session файл | Следующая сессия работает с неполными данными | Протокол восстановления: верификация при загрузке |
+
+## Шаблоны вывода
+
+### Forward Handoff (внутри сессии)
+
+```
+### Handoff Envelope — [ID From] [Агент From] → [ID To] [Агент To]
+
+**Тип:** Forward
+**Режим:** [Full / Quick]
+**Сессия:** [N]
+**Gate Check:** [PASS / CONDITIONAL PASS] (итерация [N])
+**Дата:** [YYYY-MM-DD]
+
+---
+
+**Артефакты:**
+- [Артефакт 1 — описание]
+- [Артефакт 2 — описание]
+
+**Gap'ы (если CONDITIONAL):**
+- [Gap 1 — что учесть]
+
+---
+
+**Задача для [Агент To]:**
+[Чёткая конкретная формулировка]
+
+**Ожидаемый deliverable:**
+[Что должен вернуть следующий агент]
+
+**Блокеры:**
+[Список или «Нет»]
+
+---
+
+→ Ожидаю **"Approved"** для перехода к **[ID To] [Агент To]**
+```
+
+### Reverse Handoff
+
+```
+### Reverse Handoff — [ID From] [Агент From] → [ID To] [Агент To] (возврат)
+
+**Тип:** Reverse
+**Причина:** [FAIL / feedback / расхождения в данных]
+**Дата:** [YYYY-MM-DD]
+
+---
+
+**Что исправить:**
+| # | Gap / Замечание | Sev | Конкретное действие |
+|---|----------------|:---:|---------------------|
+| 1 | [описание] | [B] | [что сделать] |
+
+**Что НЕ трогать:**
+- [Артефакт / секция, которая уже одобрена]
+
+---
+
+→ После доработки — повторная проверка `$gates` (итерация [N+1])
+→ Ожидаю **"Approved"** на возврат
+```
+
+### Receive Acknowledgement (начало работы получателя)
+
+```
+**Handoff получен:** [ID From] → [ID To]
+**Артефакты загружены:** [N] шт.
+- [Артефакт 1] — ✅ получен
+- [Артефакт 2] — ✅ получен
+
+**Gap'ы принятые:** [список или «Нет»]
+**Проблемы при загрузке:** [список или «Нет»]
+```
+
+## Общие правила handoff-документа (cross-domain)
+
+> Применяется к **любому** handoff-документу, передающему контекст сессии свежему агенту (session-handoff / conversation summary). Дополняет, не заменяет, разделы про inter-gate / межсессионный handoff выше — в частности, при использовании `os.tmpdir()` вместо `docs/analytics/session-N-handoff.md` для lightweight conversation summary.
+
+1. **Куда сохранять.** Файл — во временную директорию ОС (`%TEMP%` / `/tmp` / `os.tmpdir()`), **не** в рабочий репозиторий. Workspace остаётся чистым; путь к временному файлу цитируется в чате следующей сессии.
+2. **Секция «Suggested skills».** Обязательна секция со списком скиллов, которые свежему агенту имеет смысл подгрузить первым же действием (`$skill-1`, `$skill-2`, ...). Сокращает context-warm-up.
+3. **Не дублировать артефакты.** Если данные уже в PRD / plan / ADR / commit / diff / issue — давать **ссылку по пути или URL**, не копировать содержимое. Дубль создаёт drift между источниками. (Конфликт с правилом «ПОЛНЫЙ ТЕКСТ артефактов» для legacy session-handoff в `docs/analytics/` — там правило сохраняется; здесь действует для temp-варианта.)
+4. **Редакция чувствительных данных.** Перед сохранением — удалить API-ключи, пароли, токены, PII (email, телефон, реальные имена клиентов). Временная директория тоже потенциальный leak-вектор.
+5. **Аргументы юзера = фокус следующей сессии.** Если `/handoff` вызван с аргументом-строкой — трактовать её как описание задачи следующей сессии; адаптировать summary и suggested-skills под этот фокус.