code-ai-installer 3.0.0 → 4.0.1-a

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

@@ -1,364 +1,386 @@
----
-name: board
-description: Управление доской задач аналитического пайплайна — инициализация, статусы, лог событий, эскалация блокеров
----
-# Board — Управление доской задач аналитического пайплайна
-
-## Когда использовать
-- При **инициализации** пайплайна — Conductor создаёт доску как первое действие.
-- При **каждом переходе** между гейтами — совместно с `$handoff`.
-- При **переходе между сессиями** — доска фиксирует текущий прогресс и передаётся через `$handoff`.
-- При **блокере** — эскалация пользователю через протокол эскалации.
-- При **запросе статуса** — пользователь спрашивает «где мы сейчас?».
-
-## Вход
-
-| Поле | Обязательно | Описание |
-|------|:-----------:|----------|
-| Режим пайплайна | ✅ | Full (`/analyze`, 5 сессий) / Quick (`/quick-insight`, 1 сессия) |
-| Название задачи | ✅ | Краткое название аналитического запроса |
-| ID задачи | ⬚ | Внешний ID (Linear, Notion, etc.), если есть |
-| Ответственный | ⬚ | Кто инициировал запрос |
-| Номер сессии | ⬚ | Текущая сессия (1-5 для Full Pipeline) |
-
-> Если режим не определён — Conductor определяет по Decision Tree до создания доски.
-
-## Идентификаторы гейтов
-
-Каждый гейт получает уникальный ID по схеме `[РОЛЬ]-[NN]`:
-
-| Префикс | Роль | Пример |
-|----------|------|--------|
-| `COND` | Conductor (Дирижёр) | COND-01 |
-| `INT` | Interviewer (Интервьюер) | INT-01 |
-| `RES` | Researcher (Исследователь) | RES-01, RES-02 |
-| `AN` | Data Analyst (Аналитик данных) | AN-01, AN-02 |
-| `ST` | Strategist (Стратег) | ST-01, ST-02 |
-| `MED` | Mediator (Медиатор) | MED-01 |
-| `DS` | Designer (Дизайнер) | DS-01 |
-| `LY` | Layouter (Верстальщик) | LY-01 |
-
-> Суффикс `-01` / `-02` используется для различения гейтов одного типа (например, Researcher Аналитиков vs Researcher Критиков).
-
-## Статусы и State Machine
-
-### Допустимые статусы
-
-| Иконка | Статус | Значение |
-|--------|--------|----------|
-| `[ ]` | Ожидает | Гейт ещё не начат |
-| `[→]` | В работе | Агент активно работает на этом гейте |
-| `[✓]` | Завершён | Гейт пройден, deliverable зафиксирован, user sign-off получен |
-| `[!]` | Блокер | Работа остановлена, требуется эскалация |
-| `[↩]` | Возврат | Гейт отправлен на доработку (после review или user feedback) |
-| `[⊘]` | Пропущен | Гейт пропущен по решению пользователя (только через протокол skip) |
-
-### Допустимые переходы
-
-```
-[ ] Ожидает ──→ [→] В работе      (агент начал работу)
-[ ] Ожидает ──→ [⊘] Пропущен     (user skip — только через протокол)
-[→] В работе ──→ [✓] Завершён     (deliverable готов + user "Approved")
-[→] В работе ──→ [!] Блокер       (обнаружен блокер)
-[→] В работе ──→ [↩] Возврат      (user запросил доработку)
-[!] Блокер ────→ [→] В работе      (блокер разрешён)
-[↩] Возврат ───→ [→] В работе      (доработка начата)
-[✓] Завершён ──→ [↩] Возврат      (поздний feedback, пересмотр)
-```
-
-> **Запрещённые переходы:**
-> - `[ ] Ожидает` → `[✓] Завершён` (нельзя пропускать гейт без работы)
-> - `[!] Блокер` → `[✓] Завершён` (блокер нужно сначала разрешить)
-> - `[⊘] Пропущен` → любой статус (skip необратим)
-> - Любой переход назад через несколько гейтов (возврат — только на текущий или предыдущий)
-
-## Протокол
-
-### Шаг 0 — Определение режима и сессии
-1. Получить от пользователя тип запроса: `/analyze` (Full) или `/quick-insight` (Quick).
-2. Для Full Pipeline — определить текущую сессию (1-5).
-3. Если продолжение предыдущей сессии — загрузить доску из `$handoff` файла.
-
-### Шаг 1 — Инициализация доски
-1. Получить входные данные (режим, название, ID, сессия).
-2. Определить набор гейтов по режиму и сессии (см. шаблоны ниже).
-3. Создать доску со всеми гейтами в статусе `[ ] Ожидает`.
-4. Перевести первый гейт (Conductor) в `[→] В работе`.
-5. Добавить колонку «Сессия» для трекинга межсессионного прогресса.
-6. Зафиксировать время старта.
-7. Показать доску пользователю.
-
-### Шаг 2 — Обновление при переходе
-При каждом `$handoff`:
-1. Текущий гейт → `[✓] Завершён`, заполнить deliverable и дату.
-2. Следующий гейт → `[→] В работе`.
-3. Рассчитать метрики прогресса (см. раздел «Метрики»).
-4. Добавить запись в лог событий.
-5. Показать обновлённую доску пользователю.
-
-### Шаг 3 — Обработка блокера
-1. Текущий гейт → `[!] Блокер`.
-2. Определить severity блокера (см. раздел «Протокол эскалации»).
-3. Заполнить описание блокера в лог событий.
-4. Выполнить протокол эскалации.
-5. После разрешения: гейт → `[→] В работе`, добавить запись в лог с решением.
-
-### Шаг 4 — Обработка возврата
-1. Гейт, на который идёт возврат → `[↩] Возврат`.
-2. Все последующие гейты → `[ ] Ожидает` (сброс).
-3. Зафиксировать причину возврата в лог событий.
-4. После доработки: гейт → `[→] В работе`.
-
-### Шаг 5 — Протокол Skip (пропуск гейта)
-Используется когда пользователь запрашивает пропуск гейта.
-
-1. **Запросить подтверждение:**
-   ```
-   ⚠️ Запрос на пропуск гейта [ID] [Название]
-
-   **Влияние:** [На какие последующие гейты повлияет отсутствие deliverable этого гейта]
-   **Риск:** [Что может пойти не так без этого гейта]
-
-   Подтвердить пропуск? (Да / Нет)
-   ```
-2. Только при явном «Да» от пользователя → гейт переводится в `[⊘] Пропущен`.
-3. В лог событий добавить: причина skip + подтверждение пользователя.
-4. Следующий гейт → `[→] В работе`.
-
-> **Нельзя пропускать:** COND-01 (инициализация), MED-01 (медиация — ядро пайплайна), LY-01 (финальный deliverable).
-
-### Шаг 6 — Протокол Add (добавление гейта)
-Используется когда в процессе работы выясняется, что нужен дополнительный гейт.
-
-1. Conductor определяет: какой гейт, после какого существующего, обоснование.
-2. **Запросить подтверждение:**
-   ```
-   ➕ Добавление гейта
-
-   **Новый гейт:** [ID] [Название]
-   **Позиция:** после [ID существующего гейта]
-   **Обоснование:** [Почему необходим]
-   **Влияние на сроки:** +[оценка времени]
-
-   Подтвердить добавление? (Да / Нет)
-   ```
-3. При «Да» — вставить гейт в доску со статусом `[ ] Ожидает`, обновить нумерацию.
-4. Зафиксировать в логе событий.
-
-### Шаг 7 — Завершение сессии (межсессионный handoff)
-1. Зафиксировать текущее состояние доски.
-2. Сформировать пакет handoff:
-
-   | Компонент | Описание |
-   |-----------|----------|
-   | Доска (полная) | Все гейты со статусами, deliverables, датами |
-   | Лог событий | Полная история переходов, блокеров, решений |
-   | Метрики | Прогресс, время на гейты, блокеры |
-   | Контекст | Ключевые решения, открытые вопросы, зависимости |
-   | Артефакты | Ссылки на все созданные deliverables |
-
-3. Сохранить пакет через `$handoff` в файл `docs/analytics/session-N-handoff.md`.
-4. Сгенерировать промпт для следующей сессии через `$session-prompt-generator`.
-
-### Шаг 8 — Закрытие доски
-1. Убедиться, что все гейты в `[✓] Завершён` или `[⊘] Пропущен`.
-2. Рассчитать финальные метрики.
-3. Добавить финальную запись в лог.
-4. Показать итоговую доску + полный лог + метрики.
-
-## Метрики прогресса
-
-При каждом обновлении доски рассчитывать:
-
-| Метрика | Формула | Пример |
-|---------|---------|--------|
-| Прогресс (%) | `завершённые / всего × 100` | 6/15 = 40% |
-| Текущая сессия | `N из M` | 2 из 5 |
-| Время на текущий гейт | `now - время_старта_гейта` | 12 мин |
-| Среднее время на гейт | `Σ время_гейтов / кол-во_завершённых` | 8 мин |
-| Блокеры (total) | `кол-во [!] за всё время` | 1 |
-| Возвраты (total) | `кол-во [↩] за всё время` | 0 |
-| ETA | `оставшиеся_гейты × среднее_время` | ~72 мин |
-
-Отображать в строке прогресса под заголовком доски:
-```
-📊 Прогресс: 40% (6/15) | Сессия: 2/5 | Ср. время/гейт: 8 мин | ETA: ~72 мин | Блокеры: 1 | Возвраты: 0
-```
-
-## Протокол эскалации
-
-### Severity блокеров
-
-| Severity | Описание | Пример | Действие |
-|:--------:|----------|--------|----------|
-| 🔴 Critical | Пайплайн не может продолжаться, нет обходного пути | Отсутствуют ключевые данные, нужен ввод пользователя | Немедленная эскалация, остановка пайплайна |
-| 🟡 Major | Гейт заблокирован, но можно работать на следующем параллельно | Один из источников недоступен, но есть альтернативные | Эскалация + предложение продолжить с оговоркой |
-| 🟢 Minor | Качество deliverable снижается, но гейт проходим | Данные приблизительные, нет второго подтверждающего источника | Предупреждение в лог, пометка ⚠️ в deliverable |
-
-### Шаблон эскалации
-
-```
-### ⚠️ Блокер — [Гейт ID] [Гейт]
-
-**Задача:** [Название задачи]
-**Сессия:** [N из M]
-**Гейт:** [ID] [Название гейта]
-**Severity:** [🔴 Critical / 🟡 Major / 🟢 Minor]
-**Описание блокера:** [Что именно заблокировано и почему]
-**Влияние:** [На какие последующие гейты влияет]
-**Варианты решения:**
-1. [Вариант A] — [плюсы / минусы]
-2. [Вариант B] — [плюсы / минусы]
-
-→ Ожидаю решение от пользователя.
-```
-
-## Интеграция с другими скилами
-
-| Скил | Взаимодействие |
-|------|----------------|
-| `$handoff` | При каждом handoff — обновлять доску (шаг 2). При межсессионном handoff — сохранять полный пакет в файл (шаг 7) |
-| `$gates` | Доска отражает гейты, определённые в `$gates`. Добавление гейтов (шаг 6) — согласовывать с `$gates` |
-| `$session-prompt-generator` | Состояние доски + метрики + лог — входные данные для генерации промпта следующей сессии |
-| `$web-research` | Researcher гейты включают обязательный веб-поиск |
-
-## Валидация (Quality Gate)
-
-Доска считается корректной если:
-
-- [ ] Набор гейтов соответствует выбранному режиму пайплайна и сессии
-- [ ] Ровно один гейт в статусе `[→] В работе` (или ноль, если все завершены / есть блокер)
-- [ ] Нет пропущенных гейтов (`[✓]` / `[⊘]` идут подряд от начала)
-- [ ] Все `[✓]` гейты имеют заполненный deliverable и дату
-- [ ] Все `[⊘]` гейты имеют причину skip и подтверждение пользователя в логе
-- [ ] Лог событий содержит запись для каждого перехода
-- [ ] Нет запрещённых переходов
-- [ ] Колонка «Сессия» заполнена для всех гейтов
-- [ ] ID гейтов соответствуют схеме именования
-- [ ] Метрики прогресса рассчитаны и отображены
-- [ ] Блокеры имеют severity и разрешение зафиксировано в логе
-
-## Handoff
-Результат `$board` является входными данными для: `$handoff`, `$gates`, `$session-prompt-generator`.
-
-Формат передачи при межсессионном handoff: доска + лог + метрики + контекст + артефакты (см. шаг 7).
-
-## Anti-patterns
-
-| Ошибка | Почему плохо | Как правильно |
-|--------|-------------|---------------|
-| Пропуск обновления доски | Потеря трекинга, непонятно где мы | Обновлять при каждом `$handoff` |
-| Несколько гейтов `[→]` одновременно | Параллельная работа без контроля | Только один `[→]` в любой момент |
-| `[✓]` без deliverable | Непонятно, что было сделано | Всегда заполнять колонку «Deliverable» |
-| Блокер без эскалации | Пользователь не знает о проблеме | Всегда использовать протокол эскалации с severity |
-| Доска не показана пользователю | Пользователь вне контекста | Показывать доску при каждом обновлении |
-| Ручная правка прошлых статусов | Искажение истории | Только `[↩] Возврат`, не перезапись |
-| Потеря доски между сессиями | Следующая сессия начинает с нуля | Сохранять полный пакет через `$handoff` (шаг 7) |
-| Отсутствие ID гейтов | Невозможно ссылаться на конкретный гейт | Всегда использовать ID: COND-01, INT-01 и т.д. |
-| Пропуск гейта без протокола | Нарушение целостности пайплайна | Только через протокол skip (шаг 5) с подтверждением |
-| Блокеры без severity | Все блокеры кажутся одинаковыми, нет приоритизации | Всегда определять 🔴/🟡/🟢 severity |
-
-## Пример — Доска mid-flight (сессия 2, гейт RES-01 в работе, был блокер на INT-01)
-
-```
-### Доска задач — Full Pipeline (Аналитика)
-**Задача:** Анализ рынка EdTech в РФ
-**ID:** LIN-2847
-**Текущая сессия:** 2 из 5
-
-📊 Прогресс: 27% (4/15) | Сессия: 2/5 | Ср. время/гейт: 11 мин | ETA: ~121 мин | Блокеры: 1 | Возвраты: 0
-
-| # | ID | Гейт | Сессия | Статус | Deliverable | Дата |
-|---|----|------|:------:|:------:|-------------|------|
-| 1 | COND-01 | Conductor | 1 | [✓] | Decision Tree → Full Pipeline | 10:00 |
-| 2 | INT-01 | Interviewer | 1 | [✓] | Бриф: 12 вопросов, цели, scope | 10:15 |
-| 3 | COND-02 | Conductor (сессия 2) | 2 | [✓] | Загрузка контекста, назначение скилов | 10:22 |
-| 4 | RES-01 | Researcher (Аналитики) | 2 | [→] | — | 10:25 |
-| 5 | AN-01 | Data Analyst (Аналитики) | 2 | [ ] | — | — |
-| 6 | ST-01 | Strategist (Аналитики) | 2 | [ ] | — | — |
-| 7 | COND-03 | Conductor (сессия 3) | 3 | [ ] | — | — |
-| 8 | RES-02 | Researcher (Критики) | 3 | [ ] | — | — |
-| 9 | AN-02 | Data Analyst (Критики) | 3 | [ ] | — | — |
-| 10 | ST-02 | Strategist (Критики) | 3 | [ ] | — | — |
-| 11 | COND-04 | Conductor (сессия 4) | 4 | [ ] | — | — |
-| 12 | MED-01 | Mediator | 4 | [ ] | — | — |
-| 13 | COND-05 | Conductor (сессия 5) | 5 | [ ] | — | — |
-| 14 | DS-01 | Designer | 5 | [ ] | — | — |
-| 15 | LY-01 | Layouter | 5 | [ ] | — | — |
-
-#### Лог событий
-| Время | Сессия | Гейт | Событие | Детали |
-|-------|:------:|------|---------|--------|
-| 10:00 | 1 | COND-01 | [ ] → [→] | Пайплайн инициализирован. Режим: Full |
-| 10:08 | 1 | COND-01 | [→] → [✓] | Decision Tree → Full Pipeline, 5 сессий |
-| 10:08 | 1 | INT-01 | [ ] → [→] | Handoff: контекст задачи передан |
-| 10:12 | 1 | INT-01 | [→] → [!] | 🟡 Major: пользователь не указал бюджет и сроки |
-| 10:14 | 1 | INT-01 | [!] → [→] | Разрешено: бюджет ≤$50K, горизонт 12 мес |
-| 10:15 | 1 | INT-01 | [→] → [✓] | Бриф: 12 вопросов, scope зафиксирован |
-| 10:22 | 2 | COND-02 | [ ] → [→] | Сессия 2 начата, контекст загружен |
-| 10:22 | 2 | COND-02 | [→] → [✓] | Скилы назначены: tam-sam-som, competitive-analysis |
-| 10:25 | 2 | RES-01 | [ ] → [→] | Web-research: EdTech рынок РФ 2025-2026 |
-```
-
-## Шаблоны вывода
-
-### Full Pipeline (`/analyze`, 5 сессий)
-
-```
-### Доска задач — Full Pipeline (Аналитика)
-**Задача:** [Название]
-**ID:** [ID или —]
-**Текущая сессия:** [N из 5]
-
-📊 Прогресс: X% (N/15) | Сессия: N/5 | Ср. время/гейт: X мин | ETA: ~X мин | Блокеры: N | Возвраты: N
-
-| # | ID | Гейт | Сессия | Статус | Deliverable | Дата |
-|---|----|------|--------|--------|-------------|------|
-| 1 | COND-01 | Conductor | 1 | [→] В работе | — | [дата] |
-| 2 | INT-01 | Interviewer | 1 | [ ] Ожидает | — | — |
-| 3 | COND-02 | Conductor (сессия 2) | 2 | [ ] Ожидает | — | — |
-| 4 | RES-01 | Researcher (Аналитики) | 2 | [ ] Ожидает | — | — |
-| 5 | AN-01 | Data Analyst (Аналитики) | 2 | [ ] Ожидает | — | — |
-| 6 | ST-01 | Strategist (Аналитики) | 2 | [ ] Ожидает | — | — |
-| 7 | COND-03 | Conductor (сессия 3) | 3 | [ ] Ожидает | — | — |
-| 8 | RES-02 | Researcher (Критики) | 3 | [ ] Ожидает | — | — |
-| 9 | AN-02 | Data Analyst (Критики) | 3 | [ ] Ожидает | — | — |
-| 10 | ST-02 | Strategist (Критики) | 3 | [ ] Ожидает | — | — |
-| 11 | COND-04 | Conductor (сессия 4) | 4 | [ ] Ожидает | — | — |
-| 12 | MED-01 | Mediator | 4 | [ ] Ожидает | — | — |
-| 13 | COND-05 | Conductor (сессия 5) | 5 | [ ] Ожидает | — | — |
-| 14 | DS-01 | Designer | 5 | [ ] Ожидает | — | — |
-| 15 | LY-01 | Layouter | 5 | [ ] Ожидает | — | — |
-
-#### Лог событий
-| Время | Сессия | Гейт | Событие | Детали |
-|-------|--------|------|---------|--------|
-| [timestamp] | 1 | COND-01 | [ ] → [→] | Пайплайн инициализирован |
-```
-
-### Quick Pipeline (`/quick-insight`, 1 сессия)
-
-```
-### Доска задач — Quick Pipeline (Аналитика)
-**Задача:** [Название]
-**ID:** [ID или —]
-**Сессия:** 1 (единственная)
-
-📊 Прогресс: X% (N/8) | Ср. время/гейт: X мин | ETA: ~X мин | Блокеры: N | Возвраты: N
-
-| # | ID | Гейт | Статус | Deliverable | Дата |
-|---|----|------|--------|-------------|------|
-| 1 | COND-01 | Conductor | [→] В работе | — | [дата] |
-| 2 | INT-01 | Interviewer | [ ] Ожидает | — | — |
-| 3 | RES-01 | Researcher | [ ] Ожидает | — | — |
-| 4 | AN-01 | Data Analyst | [ ] Ожидает | — | — |
-| 5 | ST-01 | Strategist | [ ] Ожидает | — | — |
-| 6 | MED-01 | Mediator | [ ] Ожидает | — | — |
-| 7 | DS-01 | Designer | [ ] Ожидает | — | — |
-| 8 | LY-01 | Layouter | [ ] Ожидает | — | — |
-
-#### Лог событий
-| Время | Гейт | Событие | Детали |
-|-------|------|---------|--------|
-| [timestamp] | COND-01 | [ ] → [→] | Пайплайн инициализирован |
-```
+---
+name: board
+description: Управление доской задач аналитического пайплайна — инициализация, статусы, лог событий, эскалация блокеров
+type: mandatory
+domain: analytics
+owners:
+  - conductor
+gates:
+  - INTERVIEWER
+  - RESEARCHER
+  - DATA_ANALYST
+  - STRATEGIST
+  - MEDIATOR
+  - DESIGNER
+  - LAYOUTER
+  - RELEASE_GATE
+tech: []
+topic: []
+triggers:
+  - "board"
+  - "Доска задач аналитического пайплайна"
+  - "Управление доской задач аналитического пайплайна — инициализация, статусы, лог событий, эскалация блокеров"
+related: []
+budget_lines: 386
+schema_version: 1
+---
+# Board — Управление доской задач аналитического пайплайна
+
+## Когда использовать
+- При **инициализации** пайплайна — Conductor создаёт доску как первое действие.
+- При **каждом переходе** между гейтами — совместно с `$handoff`.
+- При **переходе между сессиями** — доска фиксирует текущий прогресс и передаётся через `$handoff`.
+- При **блокере** — эскалация пользователю через протокол эскалации.
+- При **запросе статуса** — пользователь спрашивает «где мы сейчас?».
+
+## Вход
+
+| Поле | Обязательно | Описание |
+|------|:-----------:|----------|
+| Режим пайплайна | ✅ | Full (`/analyze`, 5 сессий) / Quick (`/quick-insight`, 1 сессия) |
+| Название задачи | ✅ | Краткое название аналитического запроса |
+| ID задачи | ⬚ | Внешний ID (Linear, Notion, etc.), если есть |
+| Ответственный | ⬚ | Кто инициировал запрос |
+| Номер сессии | ⬚ | Текущая сессия (1-5 для Full Pipeline) |
+
+> Если режим не определён — Conductor определяет по Decision Tree до создания доски.
+
+## Идентификаторы гейтов
+
+Каждый гейт получает уникальный ID по схеме `[РОЛЬ]-[NN]`:
+
+| Префикс | Роль | Пример |
+|----------|------|--------|
+| `COND` | Conductor (Дирижёр) | COND-01 |
+| `INT` | Interviewer (Интервьюер) | INT-01 |
+| `RES` | Researcher (Исследователь) | RES-01, RES-02 |
+| `AN` | Data Analyst (Аналитик данных) | AN-01, AN-02 |
+| `ST` | Strategist (Стратег) | ST-01, ST-02 |
+| `MED` | Mediator (Медиатор) | MED-01 |
+| `DS` | Designer (Дизайнер) | DS-01 |
+| `LY` | Layouter (Верстальщик) | LY-01 |
+
+> Суффикс `-01` / `-02` используется для различения гейтов одного типа (например, Researcher Аналитиков vs Researcher Критиков).
+
+## Статусы и State Machine
+
+### Допустимые статусы
+
+| Иконка | Статус | Значение |
+|--------|--------|----------|
+| `[ ]` | Ожидает | Гейт ещё не начат |
+| `[→]` | В работе | Агент активно работает на этом гейте |
+| `[✓]` | Завершён | Гейт пройден, deliverable зафиксирован, user sign-off получен |
+| `[!]` | Блокер | Работа остановлена, требуется эскалация |
+| `[↩]` | Возврат | Гейт отправлен на доработку (после review или user feedback) |
+| `[⊘]` | Пропущен | Гейт пропущен по решению пользователя (только через протокол skip) |
+
+### Допустимые переходы
+
+```
+[ ] Ожидает ──→ [→] В работе      (агент начал работу)
+[ ] Ожидает ──→ [⊘] Пропущен     (user skip — только через протокол)
+[→] В работе ──→ [✓] Завершён     (deliverable готов + user "Approved")
+[→] В работе ──→ [!] Блокер       (обнаружен блокер)
+[→] В работе ──→ [↩] Возврат      (user запросил доработку)
+[!] Блокер ────→ [→] В работе      (блокер разрешён)
+[↩] Возврат ───→ [→] В работе      (доработка начата)
+[✓] Завершён ──→ [↩] Возврат      (поздний feedback, пересмотр)
+```
+
+> **Запрещённые переходы:**
+> - `[ ] Ожидает` → `[✓] Завершён` (нельзя пропускать гейт без работы)
+> - `[!] Блокер` → `[✓] Завершён` (блокер нужно сначала разрешить)
+> - `[⊘] Пропущен` → любой статус (skip необратим)
+> - Любой переход назад через несколько гейтов (возврат — только на текущий или предыдущий)
+
+## Протокол
+
+### Шаг 0 — Определение режима и сессии
+1. Получить от пользователя тип запроса: `/analyze` (Full) или `/quick-insight` (Quick).
+2. Для Full Pipeline — определить текущую сессию (1-5).
+3. Если продолжение предыдущей сессии — загрузить доску из `$handoff` файла.
+
+### Шаг 1 — Инициализация доски
+1. Получить входные данные (режим, название, ID, сессия).
+2. Определить набор гейтов по режиму и сессии (см. шаблоны ниже).
+3. Создать доску со всеми гейтами в статусе `[ ] Ожидает`.
+4. Перевести первый гейт (Conductor) в `[→] В работе`.
+5. Добавить колонку «Сессия» для трекинга межсессионного прогресса.
+6. Зафиксировать время старта.
+7. Показать доску пользователю.
+
+### Шаг 2 — Обновление при переходе
+При каждом `$handoff`:
+1. Текущий гейт → `[✓] Завершён`, заполнить deliverable и дату.
+2. Следующий гейт → `[→] В работе`.
+3. Рассчитать метрики прогресса (см. раздел «Метрики»).
+4. Добавить запись в лог событий.
+5. Показать обновлённую доску пользователю.
+
+### Шаг 3 — Обработка блокера
+1. Текущий гейт → `[!] Блокер`.
+2. Определить severity блокера (см. раздел «Протокол эскалации»).
+3. Заполнить описание блокера в лог событий.
+4. Выполнить протокол эскалации.
+5. После разрешения: гейт → `[→] В работе`, добавить запись в лог с решением.
+
+### Шаг 4 — Обработка возврата
+1. Гейт, на который идёт возврат → `[↩] Возврат`.
+2. Все последующие гейты → `[ ] Ожидает` (сброс).
+3. Зафиксировать причину возврата в лог событий.
+4. После доработки: гейт → `[→] В работе`.
+
+### Шаг 5 — Протокол Skip (пропуск гейта)
+Используется когда пользователь запрашивает пропуск гейта.
+
+1. **Запросить подтверждение:**
+   ```
+   ⚠️ Запрос на пропуск гейта [ID] [Название]
+
+   **Влияние:** [На какие последующие гейты повлияет отсутствие deliverable этого гейта]
+   **Риск:** [Что может пойти не так без этого гейта]
+
+   Подтвердить пропуск? (Да / Нет)
+   ```
+2. Только при явном «Да» от пользователя → гейт переводится в `[⊘] Пропущен`.
+3. В лог событий добавить: причина skip + подтверждение пользователя.
+4. Следующий гейт → `[→] В работе`.
+
+> **Нельзя пропускать:** COND-01 (инициализация), MED-01 (медиация — ядро пайплайна), LY-01 (финальный deliverable).
+
+### Шаг 6 — Протокол Add (добавление гейта)
+Используется когда в процессе работы выясняется, что нужен дополнительный гейт.
+
+1. Conductor определяет: какой гейт, после какого существующего, обоснование.
+2. **Запросить подтверждение:**
+   ```
+   ➕ Добавление гейта
+
+   **Новый гейт:** [ID] [Название]
+   **Позиция:** после [ID существующего гейта]
+   **Обоснование:** [Почему необходим]
+   **Влияние на сроки:** +[оценка времени]
+
+   Подтвердить добавление? (Да / Нет)
+   ```
+3. При «Да» — вставить гейт в доску со статусом `[ ] Ожидает`, обновить нумерацию.
+4. Зафиксировать в логе событий.
+
+### Шаг 7 — Завершение сессии (межсессионный handoff)
+1. Зафиксировать текущее состояние доски.
+2. Сформировать пакет handoff:
+
+   | Компонент | Описание |
+   |-----------|----------|
+   | Доска (полная) | Все гейты со статусами, deliverables, датами |
+   | Лог событий | Полная история переходов, блокеров, решений |
+   | Метрики | Прогресс, время на гейты, блокеры |
+   | Контекст | Ключевые решения, открытые вопросы, зависимости |
+   | Артефакты | Ссылки на все созданные deliverables |
+
+3. Сохранить пакет через `$handoff` в файл `docs/analytics/session-N-handoff.md`.
+4. Сгенерировать промпт для следующей сессии через `$session-prompt-generator`.
+
+### Шаг 8 — Закрытие доски
+1. Убедиться, что все гейты в `[✓] Завершён` или `[⊘] Пропущен`.
+2. Рассчитать финальные метрики.
+3. Добавить финальную запись в лог.
+4. Показать итоговую доску + полный лог + метрики.
+
+## Метрики прогресса
+
+При каждом обновлении доски рассчитывать:
+
+| Метрика | Формула | Пример |
+|---------|---------|--------|
+| Прогресс (%) | `завершённые / всего × 100` | 6/15 = 40% |
+| Текущая сессия | `N из M` | 2 из 5 |
+| Время на текущий гейт | `now - время_старта_гейта` | 12 мин |
+| Среднее время на гейт | `Σ время_гейтов / кол-во_завершённых` | 8 мин |
+| Блокеры (total) | `кол-во [!] за всё время` | 1 |
+| Возвраты (total) | `кол-во [↩] за всё время` | 0 |
+| ETA | `оставшиеся_гейты × среднее_время` | ~72 мин |
+
+Отображать в строке прогресса под заголовком доски:
+```
+📊 Прогресс: 40% (6/15) | Сессия: 2/5 | Ср. время/гейт: 8 мин | ETA: ~72 мин | Блокеры: 1 | Возвраты: 0
+```
+
+## Протокол эскалации
+
+### Severity блокеров
+
+| Severity | Описание | Пример | Действие |
+|:--------:|----------|--------|----------|
+| 🔴 Critical | Пайплайн не может продолжаться, нет обходного пути | Отсутствуют ключевые данные, нужен ввод пользователя | Немедленная эскалация, остановка пайплайна |
+| 🟡 Major | Гейт заблокирован, но можно работать на следующем параллельно | Один из источников недоступен, но есть альтернативные | Эскалация + предложение продолжить с оговоркой |
+| 🟢 Minor | Качество deliverable снижается, но гейт проходим | Данные приблизительные, нет второго подтверждающего источника | Предупреждение в лог, пометка ⚠️ в deliverable |
+
+### Шаблон эскалации
+
+```
+### ⚠️ Блокер — [Гейт ID] [Гейт]
+
+**Задача:** [Название задачи]
+**Сессия:** [N из M]
+**Гейт:** [ID] [Название гейта]
+**Severity:** [🔴 Critical / 🟡 Major / 🟢 Minor]
+**Описание блокера:** [Что именно заблокировано и почему]
+**Влияние:** [На какие последующие гейты влияет]
+**Варианты решения:**
+1. [Вариант A] — [плюсы / минусы]
+2. [Вариант B] — [плюсы / минусы]
+
+→ Ожидаю решение от пользователя.
+```
+
+## Интеграция с другими скилами
+
+| Скил | Взаимодействие |
+|------|----------------|
+| `$handoff` | При каждом handoff — обновлять доску (шаг 2). При межсессионном handoff — сохранять полный пакет в файл (шаг 7) |
+| `$gates` | Доска отражает гейты, определённые в `$gates`. Добавление гейтов (шаг 6) — согласовывать с `$gates` |
+| `$session-prompt-generator` | Состояние доски + метрики + лог — входные данные для генерации промпта следующей сессии |
+| `$web-research` | Researcher гейты включают обязательный веб-поиск |
+
+## Валидация (Quality Gate)
+
+Доска считается корректной если:
+
+- [ ] Набор гейтов соответствует выбранному режиму пайплайна и сессии
+- [ ] Ровно один гейт в статусе `[→] В работе` (или ноль, если все завершены / есть блокер)
+- [ ] Нет пропущенных гейтов (`[✓]` / `[⊘]` идут подряд от начала)
+- [ ] Все `[✓]` гейты имеют заполненный deliverable и дату
+- [ ] Все `[⊘]` гейты имеют причину skip и подтверждение пользователя в логе
+- [ ] Лог событий содержит запись для каждого перехода
+- [ ] Нет запрещённых переходов
+- [ ] Колонка «Сессия» заполнена для всех гейтов
+- [ ] ID гейтов соответствуют схеме именования
+- [ ] Метрики прогресса рассчитаны и отображены
+- [ ] Блокеры имеют severity и разрешение зафиксировано в логе
+
+## Handoff
+Результат `$board` является входными данными для: `$handoff`, `$gates`, `$session-prompt-generator`.
+
+Формат передачи при межсессионном handoff: доска + лог + метрики + контекст + артефакты (см. шаг 7).
+
+## Anti-patterns
+
+| Ошибка | Почему плохо | Как правильно |
+|--------|-------------|---------------|
+| Пропуск обновления доски | Потеря трекинга, непонятно где мы | Обновлять при каждом `$handoff` |
+| Несколько гейтов `[→]` одновременно | Параллельная работа без контроля | Только один `[→]` в любой момент |
+| `[✓]` без deliverable | Непонятно, что было сделано | Всегда заполнять колонку «Deliverable» |
+| Блокер без эскалации | Пользователь не знает о проблеме | Всегда использовать протокол эскалации с severity |
+| Доска не показана пользователю | Пользователь вне контекста | Показывать доску при каждом обновлении |
+| Ручная правка прошлых статусов | Искажение истории | Только `[↩] Возврат`, не перезапись |
+| Потеря доски между сессиями | Следующая сессия начинает с нуля | Сохранять полный пакет через `$handoff` (шаг 7) |
+| Отсутствие ID гейтов | Невозможно ссылаться на конкретный гейт | Всегда использовать ID: COND-01, INT-01 и т.д. |
+| Пропуск гейта без протокола | Нарушение целостности пайплайна | Только через протокол skip (шаг 5) с подтверждением |
+| Блокеры без severity | Все блокеры кажутся одинаковыми, нет приоритизации | Всегда определять 🔴/🟡/🟢 severity |
+
+## Пример — Доска mid-flight (сессия 2, гейт RES-01 в работе, был блокер на INT-01)
+
+```
+### Доска задач — Full Pipeline (Аналитика)
+**Задача:** Анализ рынка EdTech в РФ
+**ID:** LIN-2847
+**Текущая сессия:** 2 из 5
+
+📊 Прогресс: 27% (4/15) | Сессия: 2/5 | Ср. время/гейт: 11 мин | ETA: ~121 мин | Блокеры: 1 | Возвраты: 0
+
+| # | ID | Гейт | Сессия | Статус | Deliverable | Дата |
+|---|----|------|:------:|:------:|-------------|------|
+| 1 | COND-01 | Conductor | 1 | [✓] | Decision Tree → Full Pipeline | 10:00 |
+| 2 | INT-01 | Interviewer | 1 | [✓] | Бриф: 12 вопросов, цели, scope | 10:15 |
+| 3 | COND-02 | Conductor (сессия 2) | 2 | [✓] | Загрузка контекста, назначение скилов | 10:22 |
+| 4 | RES-01 | Researcher (Аналитики) | 2 | [→] | — | 10:25 |
+| 5 | AN-01 | Data Analyst (Аналитики) | 2 | [ ] | — | — |
+| 6 | ST-01 | Strategist (Аналитики) | 2 | [ ] | — | — |
+| 7 | COND-03 | Conductor (сессия 3) | 3 | [ ] | — | — |
+| 8 | RES-02 | Researcher (Критики) | 3 | [ ] | — | — |
+| 9 | AN-02 | Data Analyst (Критики) | 3 | [ ] | — | — |
+| 10 | ST-02 | Strategist (Критики) | 3 | [ ] | — | — |
+| 11 | COND-04 | Conductor (сессия 4) | 4 | [ ] | — | — |
+| 12 | MED-01 | Mediator | 4 | [ ] | — | — |
+| 13 | COND-05 | Conductor (сессия 5) | 5 | [ ] | — | — |
+| 14 | DS-01 | Designer | 5 | [ ] | — | — |
+| 15 | LY-01 | Layouter | 5 | [ ] | — | — |
+
+#### Лог событий
+| Время | Сессия | Гейт | Событие | Детали |
+|-------|:------:|------|---------|--------|
+| 10:00 | 1 | COND-01 | [ ] → [→] | Пайплайн инициализирован. Режим: Full |
+| 10:08 | 1 | COND-01 | [→] → [✓] | Decision Tree → Full Pipeline, 5 сессий |
+| 10:08 | 1 | INT-01 | [ ] → [→] | Handoff: контекст задачи передан |
+| 10:12 | 1 | INT-01 | [→] → [!] | 🟡 Major: пользователь не указал бюджет и сроки |
+| 10:14 | 1 | INT-01 | [!] → [→] | Разрешено: бюджет ≤$50K, горизонт 12 мес |
+| 10:15 | 1 | INT-01 | [→] → [✓] | Бриф: 12 вопросов, scope зафиксирован |
+| 10:22 | 2 | COND-02 | [ ] → [→] | Сессия 2 начата, контекст загружен |
+| 10:22 | 2 | COND-02 | [→] → [✓] | Скилы назначены: tam-sam-som, competitive-analysis |
+| 10:25 | 2 | RES-01 | [ ] → [→] | Web-research: EdTech рынок РФ 2025-2026 |
+```
+
+## Шаблоны вывода
+
+### Full Pipeline (`/analyze`, 5 сессий)
+
+```
+### Доска задач — Full Pipeline (Аналитика)
+**Задача:** [Название]
+**ID:** [ID или —]
+**Текущая сессия:** [N из 5]
+
+📊 Прогресс: X% (N/15) | Сессия: N/5 | Ср. время/гейт: X мин | ETA: ~X мин | Блокеры: N | Возвраты: N
+
+| # | ID | Гейт | Сессия | Статус | Deliverable | Дата |
+|---|----|------|--------|--------|-------------|------|
+| 1 | COND-01 | Conductor | 1 | [→] В работе | — | [дата] |
+| 2 | INT-01 | Interviewer | 1 | [ ] Ожидает | — | — |
+| 3 | COND-02 | Conductor (сессия 2) | 2 | [ ] Ожидает | — | — |
+| 4 | RES-01 | Researcher (Аналитики) | 2 | [ ] Ожидает | — | — |
+| 5 | AN-01 | Data Analyst (Аналитики) | 2 | [ ] Ожидает | — | — |
+| 6 | ST-01 | Strategist (Аналитики) | 2 | [ ] Ожидает | — | — |
+| 7 | COND-03 | Conductor (сессия 3) | 3 | [ ] Ожидает | — | — |
+| 8 | RES-02 | Researcher (Критики) | 3 | [ ] Ожидает | — | — |
+| 9 | AN-02 | Data Analyst (Критики) | 3 | [ ] Ожидает | — | — |
+| 10 | ST-02 | Strategist (Критики) | 3 | [ ] Ожидает | — | — |
+| 11 | COND-04 | Conductor (сессия 4) | 4 | [ ] Ожидает | — | — |
+| 12 | MED-01 | Mediator | 4 | [ ] Ожидает | — | — |
+| 13 | COND-05 | Conductor (сессия 5) | 5 | [ ] Ожидает | — | — |
+| 14 | DS-01 | Designer | 5 | [ ] Ожидает | — | — |
+| 15 | LY-01 | Layouter | 5 | [ ] Ожидает | — | — |
+
+#### Лог событий
+| Время | Сессия | Гейт | Событие | Детали |
+|-------|--------|------|---------|--------|
+| [timestamp] | 1 | COND-01 | [ ] → [→] | Пайплайн инициализирован |
+```
+
+### Quick Pipeline (`/quick-insight`, 1 сессия)
+
+```
+### Доска задач — Quick Pipeline (Аналитика)
+**Задача:** [Название]
+**ID:** [ID или —]
+**Сессия:** 1 (единственная)
+
+📊 Прогресс: X% (N/8) | Ср. время/гейт: X мин | ETA: ~X мин | Блокеры: N | Возвраты: N
+
+| # | ID | Гейт | Статус | Deliverable | Дата |
+|---|----|------|--------|-------------|------|
+| 1 | COND-01 | Conductor | [→] В работе | — | [дата] |
+| 2 | INT-01 | Interviewer | [ ] Ожидает | — | — |
+| 3 | RES-01 | Researcher | [ ] Ожидает | — | — |
+| 4 | AN-01 | Data Analyst | [ ] Ожидает | — | — |
+| 5 | ST-01 | Strategist | [ ] Ожидает | — | — |
+| 6 | MED-01 | Mediator | [ ] Ожидает | — | — |
+| 7 | DS-01 | Designer | [ ] Ожидает | — | — |
+| 8 | LY-01 | Layouter | [ ] Ожидает | — | — |
+
+#### Лог событий
+| Время | Гейт | Событие | Детали |
+|-------|------|---------|--------|
+| [timestamp] | COND-01 | [ ] → [→] | Пайплайн инициализирован |
+```