code-ai-installer 3.0.0 → 4.0.0

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

@@ -1,366 +1,366 @@
----
-name: gates
-description: Контроль качества гейтов аналитического пайплайна — критерии прохождения, чек-листы, блокеры
----
-# Gates — Контроль качества гейтов аналитического пайплайна
-
-## Когда использовать
-- **Перед каждым переходом** между гейтами — проверка deliverable текущего гейта.
-- **При возврате на доработку** — повторная проверка после исправлений.
-- **При завершении сессии** — проверка полноты материалов перед межсессионным `$handoff`.
-- **При споре о готовности** — формальный арбитр: что сделано, а что нет.
-
-> **Разграничение с `$board`:** `$gates` проверяет **качество и полноту** deliverable. `$board` отслеживает **статус и прогресс**. Gates отвечает на «готово ли?», Board — на «где мы сейчас?».
-
-## Вход
-
-| Поле | Обязательно | Описание |
-|------|:-----------:|----------|
-| Название гейта | ✅ | Какой гейт проверяем (с ID: COND-01, INT-01 и т.д.) |
-| Режим пайплайна | ✅ | Full (`/analyze`) / Quick (`/quick-insight`) — определяет набор гейтов и критерии |
-| Deliverables гейта | ✅ | Артефакты, которые агент передаёт на проверку |
-| Итерация | ⬚ | Если повторная проверка — номер итерации + gap'ы предыдущей |
-| Номер сессии | ⬚ | Текущая сессия (для Full Pipeline) |
-
-### Связь с другими скилами
-| Скил | Взаимодействие |
-|------|----------------|
-| `$board` | После gate check — обновить статус гейта на доске (PASS → `[✓]`, FAIL → `[↩]`) |
-| `$handoff` | При PASS / CONDITIONAL PASS — сформировать handoff-конверт с приложением gate check |
-| `$web-research` | Researcher-гейты (RES-xx): отсутствие web-research = автоматический Blocker |
-| `$session-prompt-generator` | При завершении сессии — gate check входит в данные для промпта следующей сессии |
-| Фреймворк-скилы | Data Analyst гейты (AN-xx): проверка корректного заполнения Quality Gate каждого фреймворка |
-
-## Реестр гейтов и deliverables
-
-### Full Pipeline (`/analyze`, 5 сессий)
-
-| # | Гейт | ID | Агент | Сессия | Обязательные deliverables | Скилы |
-|---|------|----|-------|--------|--------------------------|-------|
-| 1 | **Conductor** | COND-01 | Conductor | 1 | Режим определён, scope задачи, доска создана | `$board` |
-| 2 | **Interviewer** | INT-01 | Interviewer | 1 | Контекст собран, режим оценки выбран (scoring/qualitative), research brief | `$handoff` |
-| 3 | **Researcher (Аналитики)** | RES-01 | Researcher | 2 | Данные собраны, источники верифицированы, минимум источников достигнут | `$web-research` |
-| 4 | **Data Analyst (Аналитики)** | AN-01 | Data Analyst | 2 | Фреймворки применены, методология задокументирована | Фреймворк-скилы |
-| 5 | **Strategist (Аналитики)** | ST-01 | Strategist | 2 | Рекомендации actionable, привязаны к evidence | — |
-| 6 | **Researcher (Критики)** | RES-02 | Researcher | 3 | Альтернативные данные, критика данных Аналитиков, источники верифицированы | `$web-research` |
-| 7 | **Data Analyst (Критики)** | AN-02 | Data Analyst | 3 | Альтернативный анализ, контр-фреймворки | Фреймворк-скилы |
-| 8 | **Strategist (Критики)** | ST-02 | Strategist | 3 | Альтернативная стратегия, критика стратегии Аналитиков | — |
-| 9 | **Mediator** | MED-01 | Mediator | 4 | Обе команды оценены, scoring/qualitative завершён, финальное заключение | `$gates` |
-| 10 | **Designer** | DS-01 | Designer | 5 | Структура отчёта утверждена, спецификации визуализаций | — |
-| 11 | **Layouter** | LY-01 | Layouter | 5 | HTML сгенерирован, форматирование валидировано | — |
-| 12 | **Release Gate** | RG-01 | Conductor | 5 | Все гейты пройдены, PDF сгенерирован | `$board`, `$gates` |
-
-### Quick Pipeline (`/quick-insight`, 1 сессия)
-
-| # | Гейт | ID | Агент | Обязательные deliverables |
-|---|------|----|-------|--------------------------|
-| 1 | **Conductor** | COND-01 | Conductor | Режим определён, scope задачи, доска создана |
-| 2 | **Interviewer** | INT-01 | Interviewer | Контекст собран, режим оценки выбран |
-| 3 | **Researcher** | RES-01 | Researcher | Данные собраны, источники верифицированы |
-| 4 | **Data Analyst** | AN-01 | Data Analyst | Фреймворки применены |
-| 5 | **Strategist** | ST-01 | Strategist | Рекомендации actionable |
-| 6 | **Mediator** | MED-01 | Mediator | Итоговое заключение (без конкурирующих команд) |
-| 7 | **Designer** | DS-01 | Designer | Структура отчёта, визуализации |
-| 8 | **Layouter** | LY-01 | Layouter | HTML сгенерирован, PDF готов |
-
-## Критерии готовности по гейтам
-
-> Каждый критерий имеет предустановленный severity: **[B]** = Blocker, **[G]** = Gap, **[N]** = Note. При проверке severity можно повысить (G→B), но не понизить (B→G).
-
-### Conductor (COND-xx)
-- [ ] **[B]** Режим пайплайна определён и обоснован (Full / Quick)
-- [ ] **[B]** Scope задачи сформулирован (что анализируем, для чего, ограничения)
-- [ ] **[B]** Доска создана через `$board` с корректными ID гейтов
-- [ ] **[G]** Первый гейт активирован
-- [ ] **[G]** Для продолжающихся сессий: предыдущий handoff загружен и верифицирован
-
-### Interviewer (INT-xx)
-- [ ] **[B]** Контекст пользователя собран (бизнес-вопрос, отрасль, размер компании, цели)
-- [ ] **[B]** Режим оценки выбран: scoring (количественный) или qualitative (качественный)
-- [ ] **[B]** Research brief сформирован с конкретными вопросами для исследования
-- [ ] **[G]** Определены ключевые метрики / критерии оценки
-- [ ] **[G]** Scope зафиксирован — что входит и что НЕ входит в анализ
-
-### Researcher (RES-xx)
-- [ ] **[B]** Данные собраны по всем вопросам research brief
-- [ ] **[B]** Веб-поиск выполнен через `$web-research` (обязательно; отсутствие = автоматический Blocker)
-- [ ] **[B]** Источники верифицированы: каждая точка данных имеет URL, дату, уровень достоверности
-- [ ] **[B]** Данные без источника отсутствуют (любой факт без источника = Blocker)
-- [ ] **[G]** Минимум источников достигнут (задаётся в research brief, по умолчанию ≥ 3 на тезис)
-- [ ] **[G]** Перекрёстная проверка: 2+ источника на ключевые данные
-- [ ] **[G]** Конфликтующие данные помечены и объяснены
-- [ ] **[G]** Данные актуальны: рыночные — не старше 12 месяцев, регуляторные — текущая версия
-- [ ] **[N]** Дополнительные источники для углубления (nice-to-have)
-
-**Dependency check:** Research brief из INT-xx должен быть явно процитирован. Каждый вопрос brief = секция в deliverable.
-
-### Data Analyst (AN-xx)
-- [ ] **[B]** Фреймворки выбраны обоснованно (не менее 2 для Full Pipeline)
-- [ ] **[B]** Каждый фреймворк применён корректно — все секции заполнены, Quality Gate фреймворка пройден
-- [ ] **[B]** Данные из Researcher привязаны к выводам (не «по нашему мнению», а «по данным [источник]»)
-- [ ] **[G]** Методология задокументирована: почему этот фреймворк, какие данные использованы
-- [ ] **[G]** Паттерны и инсайты выделены явно
-- [ ] **[N]** Ограничения анализа зафиксированы
-
-**Dependency check:** Deliverable RES-xx должен быть явно использован. Каждый ключевой вывод ссылается на данные Researcher, а не на собственные допущения.
-
-### Strategist (ST-xx)
-- [ ] **[B]** Рекомендации actionable — конкретные действия, а не общие советы
-- [ ] **[B]** Каждая рекомендация привязана к evidence из Data Analyst / Researcher
-- [ ] **[G]** Приоритизация рекомендаций (impact / effort или аналогичная матрица)
-- [ ] **[G]** Риски обозначены для каждой рекомендации
-- [ ] **[N]** Временные горизонты указаны (краткосрочные / среднесрочные / долгосрочные)
-
-**Dependency check:** Каждая рекомендация трассируется до инсайта AN-xx → данных RES-xx. «Рекомендация без evidence» = Blocker.
-
-### Mediator (MED-xx)
-- [ ] **[B]** Результаты обеих команд получены (для Full Pipeline) или единственной команды (Quick)
-- [ ] **[B]** Scoring или qualitative оценка выполнена (по выбранному в INT-01 режиму)
-- [ ] **[B]** Финальное заключение сформулировано с обоснованием
-- [ ] **[G]** Для scoring: критерии и веса определены, баллы обоснованы
-- [ ] **[G]** Для qualitative: аргументы обеих сторон сопоставлены, конфликты разрешены
-- [ ] **[N]** Сильные стороны каждой команды выделены
-
-**Dependency check:** Deliverables ST-01 и ST-02 (Full) или ST-01 (Quick) явно процитированы и сопоставлены.
-
-### Designer (DS-xx)
-- [ ] **[B]** Структура отчёта утверждена (оглавление, секции, порядок)
-- [ ] **[B]** Спецификации визуализаций определены (типы графиков, данные, палитра)
-- [ ] **[G]** Макет согласован с содержанием Mediator
-- [ ] **[N]** Брендинг / стилистика определены
-
-**Dependency check:** Структура отчёта покрывает все секции из заключения MED-xx.
-
-### Layouter (LY-xx)
-- [ ] **[B]** HTML сгенерирован по макету Designer
-- [ ] **[B]** Все визуализации отрендерены
-- [ ] **[G]** Форматирование валидировано (отступы, шрифты, таблицы)
-- [ ] **[G]** PDF сгенерирован и проверен
-
-**Dependency check:** HTML соответствует спецификации DS-xx. Все визуализации из спецификации присутствуют.
-
-### Release Gate (RG-xx)
-- [ ] **[B]** Все предыдущие гейты пройдены (статус `[✓]` на `$board`)
-- [ ] **[B]** PDF отчёт сгенерирован и проверен
-- [ ] **[G]** Данные актуальны на дату отчёта
-- [ ] **[G]** User sign-off получен
-
-## Severity критериев
-
-| Severity | Маркер | Определение | Влияние на решение |
-|----------|:------:|-------------|-------------------|
-| Blocker | **[B]** | Обязательный deliverable отсутствует или критически неполный | FAIL — возврат на доработку |
-| Gap | **[G]** | Deliverable есть, но неполный или с замечаниями | CONDITIONAL PASS — можно передать, но gap'ы зафиксированы |
-| Note | **[N]** | Мелкое замечание, не влияет на переход | PASS — замечание передаётся следующему гейту как контекст |
-
-> Severity можно повысить (G→B при критичности), но **нельзя понизить** (B→G). Предустановленный severity — минимальный.
-
-## Решения
-
-| Решение | Условие | Действие |
-|---------|---------|----------|
-| **PASS** | 0 Blocker + 0 Gap | Запросить user Approved → `$handoff` → следующий гейт |
-| **CONDITIONAL PASS** | 0 Blocker + 1-2 Gap | Зафиксировать gap'ы → Запросить user Approved с пометкой → `$handoff` с пометкой |
-| **FAIL** | ≥ 1 Blocker | Вернуть агенту с конкретным списком gap'ов → Не запрашивать Approved |
-
-> **Абсолютное правило:** Никогда не пропускать гейты, даже если задача кажется простой. FAIL — доработка — повторная проверка. Без исключений.
-
-### Специальные правила
-- Researcher-гейты (RES-xx): отсутствие `$web-research` — **автоматический Blocker**.
-- Данные без источника — **Blocker** (не Gap, не Note).
-- Данные старше 12 месяцев (рыночные) — **Gap** с пометкой «требует обновления».
-
-## Протокол эскалации при повторных FAIL
-
-| Итерация | Действие |
-|:--------:|----------|
-| 1-й FAIL | Стандартный возврат: список gap'ов → агент дорабатывает → повторная проверка |
-| 2-й FAIL | Расширенный возврат: gap'ы + конкретные инструкции «как исправить» + предупреждение |
-| 3-й FAIL | **Эскалация пользователю:** |
-
-Шаблон эскалации (3+ FAIL):
-```
-### ⚠️ Эскалация — Гейт [ID] не проходит проверку (итерация [N])
-
-**Гейт:** [ID] [Название]
-**Итераций FAIL:** [N]
-**Повторяющиеся gap'ы:** [список gap'ов, не исправленных за N итераций]
-
-**Варианты:**
-1. Пересмотреть scope / снизить требования к deliverable
-2. Вернуть на предыдущий гейт (проблема в исходных данных)
-3. Принудительный CONDITIONAL PASS (user принимает риск gap'ов)
-
-→ Ожидаю решение от пользователя.
-```
-
-## Протокол
-
-### Шаг 0 — Загрузка контекста
-1. Определить какой гейт проверяем (по ID из `$board`).
-2. Определить режим пайплайна (Full / Quick) и номер сессии.
-3. Загрузить критерии готовности для этого гейта из реестра (с предустановленным severity).
-4. Если повторная проверка — загрузить gap'ы предыдущей итерации.
-
-### Шаг 1 — Проверка deliverables
-1. Для каждого критерия готовности — проверить: выполнен / не выполнен / N/A.
-2. Для невыполненных — применить предустановленный severity (можно повысить, нельзя понизить).
-3. Для невыполненных — описать конкретный gap: что именно не хватает / что исправить.
-4. **Dependency check:** проверить, что deliverable предыдущего гейта явно использован (не просто существует, а процитирован / задействован в текущем deliverable).
-
-### Шаг 2 — Принятие решения
-1. Подсчитать severity.
-2. Применить правила решений (PASS / CONDITIONAL PASS / FAIL).
-3. Проверить номер итерации — если 3+ FAIL, активировать протокол эскалации.
-4. Добавить запись в лог проверок.
-
-### Шаг 3 — Действие по результату
-- **PASS:** показать пользователю → запросить Approved → `$handoff` → обновить `$board`.
-- **CONDITIONAL PASS:** показать gap'ы → запросить Approved с подтверждением gap'ов → `$handoff` с пометкой → обновить `$board`.
-- **FAIL:** показать gap'ы → вернуть агенту → обновить `$board` (статус `[↩] Возврат`). Если 3+ FAIL — эскалация.
-
-## Пример — Gate Check RES-01 (Researcher Аналитики), итерация 1 → CONDITIONAL PASS
-
-```
-### Gate Check — RES-01 Researcher (Аналитики)
-
-**Режим:** Full Pipeline
-**Сессия:** 2 из 5
-**Итерация:** 1
-**Предыдущие gap'ы:** Первая проверка
-
----
-
-#### Критерии готовности
-
-| # | Критерий | Sev | Статус | Gap / Комментарий |
-|---|----------|:---:|:------:|-------------------|
-| 1 | Данные собраны по всем вопросам research brief | [B] | ✅ | 7 из 7 вопросов покрыты |
-| 2 | Веб-поиск выполнен через `$web-research` | [B] | ✅ | 12 запросов, 28 источников |
-| 3 | Источники верифицированы (URL, дата, достоверность) | [B] | ✅ | Все 28 с URL и датой |
-| 4 | Данные без источника отсутствуют | [B] | ✅ | 0 фактов без источника |
-| 5 | Минимум источников (≥ 3 на тезис) | [G] | ⚠️ | Тезис о TAM рынка EdTech — 2 источника вместо 3 |
-| 6 | Перекрёстная проверка (2+ на ключевые) | [G] | ✅ | OK |
-| 7 | Конфликтующие данные помечены | [G] | ✅ | 2 конфликта помечены и объяснены |
-| 8 | Актуальность данных (≤ 12 мес) | [G] | ⚠️ | 1 источник (отчёт IDC) — 14 мес, помечен ⚠️ |
-| 9 | Дополнительные источники (nice-to-have) | [N] | ℹ️ | Рекомендуется добавить данные Росстата |
-
-**Dependency check:** Research brief INT-01 процитирован в заголовке каждой секции. Все 7 вопросов = 7 секций. ✅
-
----
-
-#### Сводка
-
-| Severity | Количество | Пункты |
-|----------|:----------:|--------|
-| Blocker | 0 | — |
-| Gap | 2 | #5 (TAM: 2 источника), #8 (IDC: 14 мес) |
-| Note | 1 | #9 (Росстат nice-to-have) |
-
-### Решение: CONDITIONAL PASS
-
-**Обоснование:** 0 Blocker, 2 Gap — допустимо для передачи. Gap'ы зафиксированы для AN-01.
-
----
-
-**Deliverables для передачи:**
-- Research Report (7 секций, 28 источников, 2 конфликта объяснены)
-
-**Gap'ы для AN-01:**
-- TAM рынка EdTech подкреплён 2 источниками (а не 3) — учесть как ⚠️ Estimated
-- Отчёт IDC 14 мес — помечен, рекомендуется верифицировать через свежие данные
-
-→ Готов к передаче **Data Analyst (Аналитики)**. Ожидаю **"Approved"**.
-```
-
-## Валидация (Quality Gate)
-
-Проверка гейта считается завершённой если:
-
-- [ ] Все критерии готовности пройдены (выполнен / не выполнен / N/A — нет пустых)
-- [ ] Каждому критерию присвоен severity из реестра (B/G/N), при необходимости повышен
-- [ ] Для каждого невыполненного указаны: severity, описание gap'а, что исправить
-- [ ] Dependency check пройден: deliverable предыдущего гейта явно использован в текущем
-- [ ] Решение соответствует правилам (не субъективное)
-- [ ] При 3+ FAIL — активирован протокол эскалации
-- [ ] Лог проверок обновлён
-- [ ] При PASS/CONDITIONAL PASS — user Approved получен
-- [ ] `$board` обновлён
-
-## Handoff
-Результат `$gates` является входными данными для: `$handoff` (приложение gate check к конверту).
-
-Формат передачи: заполненный шаблон gate check + решение + gap'ы (если CONDITIONAL PASS) + dependency check результат.
-
-## Anti-patterns
-
-| Ошибка | Почему плохо | Как правильно |
-|--------|-------------|---------------|
-| Пропуск гейта «потому что просто» | Ошибки проходят незамеченными | Никогда не пропускать. Без исключений |
-| PASS без проверки всех критериев | Незамеченные gap'ы | Каждый критерий = выполнен / не выполнен / N/A |
-| «В целом ок» вместо конкретики | Агент не знает что исправлять | Конкретный gap: «источник X не содержит дату публикации» |
-| FAIL без описания gap'ов | Агент возвращается и не знает что делать | Каждый FAIL = список конкретных доработок |
-| Approved без user sign-off | Нарушение протокола пайплайна | Всегда явное Approved от пользователя |
-| Данные Researcher без веб-поиска | Непроверенные данные в отчёте | `$web-research` — обязателен, его отсутствие = Blocker |
-| Одинаковая важность всех критериев | Мелочь блокирует, критичное проходит | Предустановленный severity: [B] / [G] / [N] per criterion |
-| Повторная проверка без сверки с gap'ами | Gap мог быть не исправлен | Загрузить gap'ы предыдущей итерации, проверить каждый |
-| Понижение severity (B→G) | Критический deliverable проходит без проверки | Severity можно повысить, но нельзя понизить |
-| Бесконечный цикл FAIL | Пайплайн зависает, пользователь не в курсе | 3+ FAIL = эскалация пользователю с вариантами решения |
-| Формальная проверка «существует» | Deliverable есть, но не использован следующим гейтом | Dependency check: предыдущий deliverable процитирован и задействован |
-
-## Шаблон вывода
-
-```
-### Gate Check — [ID] [Название гейта]
-
-**Режим:** [Full / Quick]
-**Сессия:** [N из M]
-**Итерация:** [1 / 2 / N]
-**Предыдущие gap'ы:** [список или «Первая проверка»]
-
----
-
-#### Критерии готовности
-
-| # | Критерий | Sev | Статус | Gap / Комментарий |
-|---|----------|:---:|:------:|-------------------|
-| 1 | [Критерий из реестра] | [B] | ✅/⚠️/❌ | [Если не выполнен: что не хватает] |
-
-**Dependency check:** [Deliverable [предыдущий ID] процитирован: ✅/❌. Детали.]
-
----
-
-#### Сводка
-
-| Severity | Количество | Пункты |
-|----------|:----------:|--------|
-| Blocker | [N] | #[список] |
-| Gap | [N] | #[список] |
-| Note | [N] | #[список] |
-
-### Решение: [ PASS / CONDITIONAL PASS / FAIL ]
-
-**Обоснование:** [по правилам: 0 blocker + 0 gap = PASS и т.д.]
-
----
-
-#### При PASS / CONDITIONAL PASS:
-**Deliverables для передачи:**
-- [Артефакт 1]
-- [Артефакт 2]
-
-**Gap'ы для следующего гейта (если CONDITIONAL):**
-- [Gap 1 — что учесть]
-
-→ Готов к передаче **[Следующий агент]**. Ожидаю **"Approved"**.
-
-#### При FAIL:
-**Gap'ы для доработки:**
-
-| # | Gap | Sev | Что исправить | Ответственный |
-|---|-----|:---:|---------------|---------------|
-| [N] | [описание] | [B] | [конкретное действие] | [агент] |
-
-→ Возврат к **[Текущий агент]**. После исправления — повторная проверка (итерация [N+1]).
-[Если итерация ≥ 3: активирован протокол эскалации]
-```
+---
+name: gates
+description: Контроль качества гейтов аналитического пайплайна — критерии прохождения, чек-листы, блокеры
+---
+# Gates — Контроль качества гейтов аналитического пайплайна
+
+## Когда использовать
+- **Перед каждым переходом** между гейтами — проверка deliverable текущего гейта.
+- **При возврате на доработку** — повторная проверка после исправлений.
+- **При завершении сессии** — проверка полноты материалов перед межсессионным `$handoff`.
+- **При споре о готовности** — формальный арбитр: что сделано, а что нет.
+
+> **Разграничение с `$board`:** `$gates` проверяет **качество и полноту** deliverable. `$board` отслеживает **статус и прогресс**. Gates отвечает на «готово ли?», Board — на «где мы сейчас?».
+
+## Вход
+
+| Поле | Обязательно | Описание |
+|------|:-----------:|----------|
+| Название гейта | ✅ | Какой гейт проверяем (с ID: COND-01, INT-01 и т.д.) |
+| Режим пайплайна | ✅ | Full (`/analyze`) / Quick (`/quick-insight`) — определяет набор гейтов и критерии |
+| Deliverables гейта | ✅ | Артефакты, которые агент передаёт на проверку |
+| Итерация | ⬚ | Если повторная проверка — номер итерации + gap'ы предыдущей |
+| Номер сессии | ⬚ | Текущая сессия (для Full Pipeline) |
+
+### Связь с другими скилами
+| Скил | Взаимодействие |
+|------|----------------|
+| `$board` | После gate check — обновить статус гейта на доске (PASS → `[✓]`, FAIL → `[↩]`) |
+| `$handoff` | При PASS / CONDITIONAL PASS — сформировать handoff-конверт с приложением gate check |
+| `$web-research` | Researcher-гейты (RES-xx): отсутствие web-research = автоматический Blocker |
+| `$session-prompt-generator` | При завершении сессии — gate check входит в данные для промпта следующей сессии |
+| Фреймворк-скилы | Data Analyst гейты (AN-xx): проверка корректного заполнения Quality Gate каждого фреймворка |
+
+## Реестр гейтов и deliverables
+
+### Full Pipeline (`/analyze`, 5 сессий)
+
+| # | Гейт | ID | Агент | Сессия | Обязательные deliverables | Скилы |
+|---|------|----|-------|--------|--------------------------|-------|
+| 1 | **Conductor** | COND-01 | Conductor | 1 | Режим определён, scope задачи, доска создана | `$board` |
+| 2 | **Interviewer** | INT-01 | Interviewer | 1 | Контекст собран, режим оценки выбран (scoring/qualitative), research brief | `$handoff` |
+| 3 | **Researcher (Аналитики)** | RES-01 | Researcher | 2 | Данные собраны, источники верифицированы, минимум источников достигнут | `$web-research` |
+| 4 | **Data Analyst (Аналитики)** | AN-01 | Data Analyst | 2 | Фреймворки применены, методология задокументирована | Фреймворк-скилы |
+| 5 | **Strategist (Аналитики)** | ST-01 | Strategist | 2 | Рекомендации actionable, привязаны к evidence | — |
+| 6 | **Researcher (Критики)** | RES-02 | Researcher | 3 | Альтернативные данные, критика данных Аналитиков, источники верифицированы | `$web-research` |
+| 7 | **Data Analyst (Критики)** | AN-02 | Data Analyst | 3 | Альтернативный анализ, контр-фреймворки | Фреймворк-скилы |
+| 8 | **Strategist (Критики)** | ST-02 | Strategist | 3 | Альтернативная стратегия, критика стратегии Аналитиков | — |
+| 9 | **Mediator** | MED-01 | Mediator | 4 | Обе команды оценены, scoring/qualitative завершён, финальное заключение | `$gates` |
+| 10 | **Designer** | DS-01 | Designer | 5 | Структура отчёта утверждена, спецификации визуализаций | — |
+| 11 | **Layouter** | LY-01 | Layouter | 5 | HTML сгенерирован, форматирование валидировано | — |
+| 12 | **Release Gate** | RG-01 | Conductor | 5 | Все гейты пройдены, PDF сгенерирован | `$board`, `$gates` |
+
+### Quick Pipeline (`/quick-insight`, 1 сессия)
+
+| # | Гейт | ID | Агент | Обязательные deliverables |
+|---|------|----|-------|--------------------------|
+| 1 | **Conductor** | COND-01 | Conductor | Режим определён, scope задачи, доска создана |
+| 2 | **Interviewer** | INT-01 | Interviewer | Контекст собран, режим оценки выбран |
+| 3 | **Researcher** | RES-01 | Researcher | Данные собраны, источники верифицированы |
+| 4 | **Data Analyst** | AN-01 | Data Analyst | Фреймворки применены |
+| 5 | **Strategist** | ST-01 | Strategist | Рекомендации actionable |
+| 6 | **Mediator** | MED-01 | Mediator | Итоговое заключение (без конкурирующих команд) |
+| 7 | **Designer** | DS-01 | Designer | Структура отчёта, визуализации |
+| 8 | **Layouter** | LY-01 | Layouter | HTML сгенерирован, PDF готов |
+
+## Критерии готовности по гейтам
+
+> Каждый критерий имеет предустановленный severity: **[B]** = Blocker, **[G]** = Gap, **[N]** = Note. При проверке severity можно повысить (G→B), но не понизить (B→G).
+
+### Conductor (COND-xx)
+- [ ] **[B]** Режим пайплайна определён и обоснован (Full / Quick)
+- [ ] **[B]** Scope задачи сформулирован (что анализируем, для чего, ограничения)
+- [ ] **[B]** Доска создана через `$board` с корректными ID гейтов
+- [ ] **[G]** Первый гейт активирован
+- [ ] **[G]** Для продолжающихся сессий: предыдущий handoff загружен и верифицирован
+
+### Interviewer (INT-xx)
+- [ ] **[B]** Контекст пользователя собран (бизнес-вопрос, отрасль, размер компании, цели)
+- [ ] **[B]** Режим оценки выбран: scoring (количественный) или qualitative (качественный)
+- [ ] **[B]** Research brief сформирован с конкретными вопросами для исследования
+- [ ] **[G]** Определены ключевые метрики / критерии оценки
+- [ ] **[G]** Scope зафиксирован — что входит и что НЕ входит в анализ
+
+### Researcher (RES-xx)
+- [ ] **[B]** Данные собраны по всем вопросам research brief
+- [ ] **[B]** Веб-поиск выполнен через `$web-research` (обязательно; отсутствие = автоматический Blocker)
+- [ ] **[B]** Источники верифицированы: каждая точка данных имеет URL, дату, уровень достоверности
+- [ ] **[B]** Данные без источника отсутствуют (любой факт без источника = Blocker)
+- [ ] **[G]** Минимум источников достигнут (задаётся в research brief, по умолчанию ≥ 3 на тезис)
+- [ ] **[G]** Перекрёстная проверка: 2+ источника на ключевые данные
+- [ ] **[G]** Конфликтующие данные помечены и объяснены
+- [ ] **[G]** Данные актуальны: рыночные — не старше 12 месяцев, регуляторные — текущая версия
+- [ ] **[N]** Дополнительные источники для углубления (nice-to-have)
+
+**Dependency check:** Research brief из INT-xx должен быть явно процитирован. Каждый вопрос brief = секция в deliverable.
+
+### Data Analyst (AN-xx)
+- [ ] **[B]** Фреймворки выбраны обоснованно (не менее 2 для Full Pipeline)
+- [ ] **[B]** Каждый фреймворк применён корректно — все секции заполнены, Quality Gate фреймворка пройден
+- [ ] **[B]** Данные из Researcher привязаны к выводам (не «по нашему мнению», а «по данным [источник]»)
+- [ ] **[G]** Методология задокументирована: почему этот фреймворк, какие данные использованы
+- [ ] **[G]** Паттерны и инсайты выделены явно
+- [ ] **[N]** Ограничения анализа зафиксированы
+
+**Dependency check:** Deliverable RES-xx должен быть явно использован. Каждый ключевой вывод ссылается на данные Researcher, а не на собственные допущения.
+
+### Strategist (ST-xx)
+- [ ] **[B]** Рекомендации actionable — конкретные действия, а не общие советы
+- [ ] **[B]** Каждая рекомендация привязана к evidence из Data Analyst / Researcher
+- [ ] **[G]** Приоритизация рекомендаций (impact / effort или аналогичная матрица)
+- [ ] **[G]** Риски обозначены для каждой рекомендации
+- [ ] **[N]** Временные горизонты указаны (краткосрочные / среднесрочные / долгосрочные)
+
+**Dependency check:** Каждая рекомендация трассируется до инсайта AN-xx → данных RES-xx. «Рекомендация без evidence» = Blocker.
+
+### Mediator (MED-xx)
+- [ ] **[B]** Результаты обеих команд получены (для Full Pipeline) или единственной команды (Quick)
+- [ ] **[B]** Scoring или qualitative оценка выполнена (по выбранному в INT-01 режиму)
+- [ ] **[B]** Финальное заключение сформулировано с обоснованием
+- [ ] **[G]** Для scoring: критерии и веса определены, баллы обоснованы
+- [ ] **[G]** Для qualitative: аргументы обеих сторон сопоставлены, конфликты разрешены
+- [ ] **[N]** Сильные стороны каждой команды выделены
+
+**Dependency check:** Deliverables ST-01 и ST-02 (Full) или ST-01 (Quick) явно процитированы и сопоставлены.
+
+### Designer (DS-xx)
+- [ ] **[B]** Структура отчёта утверждена (оглавление, секции, порядок)
+- [ ] **[B]** Спецификации визуализаций определены (типы графиков, данные, палитра)
+- [ ] **[G]** Макет согласован с содержанием Mediator
+- [ ] **[N]** Брендинг / стилистика определены
+
+**Dependency check:** Структура отчёта покрывает все секции из заключения MED-xx.
+
+### Layouter (LY-xx)
+- [ ] **[B]** HTML сгенерирован по макету Designer
+- [ ] **[B]** Все визуализации отрендерены
+- [ ] **[G]** Форматирование валидировано (отступы, шрифты, таблицы)
+- [ ] **[G]** PDF сгенерирован и проверен
+
+**Dependency check:** HTML соответствует спецификации DS-xx. Все визуализации из спецификации присутствуют.
+
+### Release Gate (RG-xx)
+- [ ] **[B]** Все предыдущие гейты пройдены (статус `[✓]` на `$board`)
+- [ ] **[B]** PDF отчёт сгенерирован и проверен
+- [ ] **[G]** Данные актуальны на дату отчёта
+- [ ] **[G]** User sign-off получен
+
+## Severity критериев
+
+| Severity | Маркер | Определение | Влияние на решение |
+|----------|:------:|-------------|-------------------|
+| Blocker | **[B]** | Обязательный deliverable отсутствует или критически неполный | FAIL — возврат на доработку |
+| Gap | **[G]** | Deliverable есть, но неполный или с замечаниями | CONDITIONAL PASS — можно передать, но gap'ы зафиксированы |
+| Note | **[N]** | Мелкое замечание, не влияет на переход | PASS — замечание передаётся следующему гейту как контекст |
+
+> Severity можно повысить (G→B при критичности), но **нельзя понизить** (B→G). Предустановленный severity — минимальный.
+
+## Решения
+
+| Решение | Условие | Действие |
+|---------|---------|----------|
+| **PASS** | 0 Blocker + 0 Gap | Запросить user Approved → `$handoff` → следующий гейт |
+| **CONDITIONAL PASS** | 0 Blocker + 1-2 Gap | Зафиксировать gap'ы → Запросить user Approved с пометкой → `$handoff` с пометкой |
+| **FAIL** | ≥ 1 Blocker | Вернуть агенту с конкретным списком gap'ов → Не запрашивать Approved |
+
+> **Абсолютное правило:** Никогда не пропускать гейты, даже если задача кажется простой. FAIL — доработка — повторная проверка. Без исключений.
+
+### Специальные правила
+- Researcher-гейты (RES-xx): отсутствие `$web-research` — **автоматический Blocker**.
+- Данные без источника — **Blocker** (не Gap, не Note).
+- Данные старше 12 месяцев (рыночные) — **Gap** с пометкой «требует обновления».
+
+## Протокол эскалации при повторных FAIL
+
+| Итерация | Действие |
+|:--------:|----------|
+| 1-й FAIL | Стандартный возврат: список gap'ов → агент дорабатывает → повторная проверка |
+| 2-й FAIL | Расширенный возврат: gap'ы + конкретные инструкции «как исправить» + предупреждение |
+| 3-й FAIL | **Эскалация пользователю:** |
+
+Шаблон эскалации (3+ FAIL):
+```
+### ⚠️ Эскалация — Гейт [ID] не проходит проверку (итерация [N])
+
+**Гейт:** [ID] [Название]
+**Итераций FAIL:** [N]
+**Повторяющиеся gap'ы:** [список gap'ов, не исправленных за N итераций]
+
+**Варианты:**
+1. Пересмотреть scope / снизить требования к deliverable
+2. Вернуть на предыдущий гейт (проблема в исходных данных)
+3. Принудительный CONDITIONAL PASS (user принимает риск gap'ов)
+
+→ Ожидаю решение от пользователя.
+```
+
+## Протокол
+
+### Шаг 0 — Загрузка контекста
+1. Определить какой гейт проверяем (по ID из `$board`).
+2. Определить режим пайплайна (Full / Quick) и номер сессии.
+3. Загрузить критерии готовности для этого гейта из реестра (с предустановленным severity).
+4. Если повторная проверка — загрузить gap'ы предыдущей итерации.
+
+### Шаг 1 — Проверка deliverables
+1. Для каждого критерия готовности — проверить: выполнен / не выполнен / N/A.
+2. Для невыполненных — применить предустановленный severity (можно повысить, нельзя понизить).
+3. Для невыполненных — описать конкретный gap: что именно не хватает / что исправить.
+4. **Dependency check:** проверить, что deliverable предыдущего гейта явно использован (не просто существует, а процитирован / задействован в текущем deliverable).
+
+### Шаг 2 — Принятие решения
+1. Подсчитать severity.
+2. Применить правила решений (PASS / CONDITIONAL PASS / FAIL).
+3. Проверить номер итерации — если 3+ FAIL, активировать протокол эскалации.
+4. Добавить запись в лог проверок.
+
+### Шаг 3 — Действие по результату
+- **PASS:** показать пользователю → запросить Approved → `$handoff` → обновить `$board`.
+- **CONDITIONAL PASS:** показать gap'ы → запросить Approved с подтверждением gap'ов → `$handoff` с пометкой → обновить `$board`.
+- **FAIL:** показать gap'ы → вернуть агенту → обновить `$board` (статус `[↩] Возврат`). Если 3+ FAIL — эскалация.
+
+## Пример — Gate Check RES-01 (Researcher Аналитики), итерация 1 → CONDITIONAL PASS
+
+```
+### Gate Check — RES-01 Researcher (Аналитики)
+
+**Режим:** Full Pipeline
+**Сессия:** 2 из 5
+**Итерация:** 1
+**Предыдущие gap'ы:** Первая проверка
+
+---
+
+#### Критерии готовности
+
+| # | Критерий | Sev | Статус | Gap / Комментарий |
+|---|----------|:---:|:------:|-------------------|
+| 1 | Данные собраны по всем вопросам research brief | [B] | ✅ | 7 из 7 вопросов покрыты |
+| 2 | Веб-поиск выполнен через `$web-research` | [B] | ✅ | 12 запросов, 28 источников |
+| 3 | Источники верифицированы (URL, дата, достоверность) | [B] | ✅ | Все 28 с URL и датой |
+| 4 | Данные без источника отсутствуют | [B] | ✅ | 0 фактов без источника |
+| 5 | Минимум источников (≥ 3 на тезис) | [G] | ⚠️ | Тезис о TAM рынка EdTech — 2 источника вместо 3 |
+| 6 | Перекрёстная проверка (2+ на ключевые) | [G] | ✅ | OK |
+| 7 | Конфликтующие данные помечены | [G] | ✅ | 2 конфликта помечены и объяснены |
+| 8 | Актуальность данных (≤ 12 мес) | [G] | ⚠️ | 1 источник (отчёт IDC) — 14 мес, помечен ⚠️ |
+| 9 | Дополнительные источники (nice-to-have) | [N] | ℹ️ | Рекомендуется добавить данные Росстата |
+
+**Dependency check:** Research brief INT-01 процитирован в заголовке каждой секции. Все 7 вопросов = 7 секций. ✅
+
+---
+
+#### Сводка
+
+| Severity | Количество | Пункты |
+|----------|:----------:|--------|
+| Blocker | 0 | — |
+| Gap | 2 | #5 (TAM: 2 источника), #8 (IDC: 14 мес) |
+| Note | 1 | #9 (Росстат nice-to-have) |
+
+### Решение: CONDITIONAL PASS
+
+**Обоснование:** 0 Blocker, 2 Gap — допустимо для передачи. Gap'ы зафиксированы для AN-01.
+
+---
+
+**Deliverables для передачи:**
+- Research Report (7 секций, 28 источников, 2 конфликта объяснены)
+
+**Gap'ы для AN-01:**
+- TAM рынка EdTech подкреплён 2 источниками (а не 3) — учесть как ⚠️ Estimated
+- Отчёт IDC 14 мес — помечен, рекомендуется верифицировать через свежие данные
+
+→ Готов к передаче **Data Analyst (Аналитики)**. Ожидаю **"Approved"**.
+```
+
+## Валидация (Quality Gate)
+
+Проверка гейта считается завершённой если:
+
+- [ ] Все критерии готовности пройдены (выполнен / не выполнен / N/A — нет пустых)
+- [ ] Каждому критерию присвоен severity из реестра (B/G/N), при необходимости повышен
+- [ ] Для каждого невыполненного указаны: severity, описание gap'а, что исправить
+- [ ] Dependency check пройден: deliverable предыдущего гейта явно использован в текущем
+- [ ] Решение соответствует правилам (не субъективное)
+- [ ] При 3+ FAIL — активирован протокол эскалации
+- [ ] Лог проверок обновлён
+- [ ] При PASS/CONDITIONAL PASS — user Approved получен
+- [ ] `$board` обновлён
+
+## Handoff
+Результат `$gates` является входными данными для: `$handoff` (приложение gate check к конверту).
+
+Формат передачи: заполненный шаблон gate check + решение + gap'ы (если CONDITIONAL PASS) + dependency check результат.
+
+## Anti-patterns
+
+| Ошибка | Почему плохо | Как правильно |
+|--------|-------------|---------------|
+| Пропуск гейта «потому что просто» | Ошибки проходят незамеченными | Никогда не пропускать. Без исключений |
+| PASS без проверки всех критериев | Незамеченные gap'ы | Каждый критерий = выполнен / не выполнен / N/A |
+| «В целом ок» вместо конкретики | Агент не знает что исправлять | Конкретный gap: «источник X не содержит дату публикации» |
+| FAIL без описания gap'ов | Агент возвращается и не знает что делать | Каждый FAIL = список конкретных доработок |
+| Approved без user sign-off | Нарушение протокола пайплайна | Всегда явное Approved от пользователя |
+| Данные Researcher без веб-поиска | Непроверенные данные в отчёте | `$web-research` — обязателен, его отсутствие = Blocker |
+| Одинаковая важность всех критериев | Мелочь блокирует, критичное проходит | Предустановленный severity: [B] / [G] / [N] per criterion |
+| Повторная проверка без сверки с gap'ами | Gap мог быть не исправлен | Загрузить gap'ы предыдущей итерации, проверить каждый |
+| Понижение severity (B→G) | Критический deliverable проходит без проверки | Severity можно повысить, но нельзя понизить |
+| Бесконечный цикл FAIL | Пайплайн зависает, пользователь не в курсе | 3+ FAIL = эскалация пользователю с вариантами решения |
+| Формальная проверка «существует» | Deliverable есть, но не использован следующим гейтом | Dependency check: предыдущий deliverable процитирован и задействован |
+
+## Шаблон вывода
+
+```
+### Gate Check — [ID] [Название гейта]
+
+**Режим:** [Full / Quick]
+**Сессия:** [N из M]
+**Итерация:** [1 / 2 / N]
+**Предыдущие gap'ы:** [список или «Первая проверка»]
+
+---
+
+#### Критерии готовности
+
+| # | Критерий | Sev | Статус | Gap / Комментарий |
+|---|----------|:---:|:------:|-------------------|
+| 1 | [Критерий из реестра] | [B] | ✅/⚠️/❌ | [Если не выполнен: что не хватает] |
+
+**Dependency check:** [Deliverable [предыдущий ID] процитирован: ✅/❌. Детали.]
+
+---
+
+#### Сводка
+
+| Severity | Количество | Пункты |
+|----------|:----------:|--------|
+| Blocker | [N] | #[список] |
+| Gap | [N] | #[список] |
+| Note | [N] | #[список] |
+
+### Решение: [ PASS / CONDITIONAL PASS / FAIL ]
+
+**Обоснование:** [по правилам: 0 blocker + 0 gap = PASS и т.д.]
+
+---
+
+#### При PASS / CONDITIONAL PASS:
+**Deliverables для передачи:**
+- [Артефакт 1]
+- [Артефакт 2]
+
+**Gap'ы для следующего гейта (если CONDITIONAL):**
+- [Gap 1 — что учесть]
+
+→ Готов к передаче **[Следующий агент]**. Ожидаю **"Approved"**.
+
+#### При FAIL:
+**Gap'ы для доработки:**
+
+| # | Gap | Sev | Что исправить | Ответственный |
+|---|-----|:---:|---------------|---------------|
+| [N] | [описание] | [B] | [конкретное действие] | [агент] |
+
+→ Возврат к **[Текущий агент]**. После исправления — повторная проверка (итерация [N+1]).
+[Если итерация ≥ 3: активирован протокол эскалации]
+```