code-ai-installer 4.0.0 → 4.0.1-a

package/domains/analytics/.agents/skills/report-design/SKILL.md

@@ -1,398 +1,416 @@
----
-name: report-design
-description: Проектирование макета аналитического отчёта — структура, визуализации, иерархия, палитра
----
-# Дизайн отчёта — Проектирование макета аналитического отчёта
-
-## Когда использовать
-- При подготовке **финального аналитического отчёта** по результатам пайплайна (Сессия 5 Full Pipeline или финал Quick Pipeline).
-- При необходимости **спроектировать структуру** PDF-отчёта: какие секции, какие визуализации, какая иерархия.
-- При создании **report design specification** для передачи Верстальщику (Layouter).
-- При проектировании **executive summary** на основе заключения Медиатора.
-- При определении **цветовой палитры** и **визуальной иерархии** для печатного документа.
-
-## Вход
-
-| Поле | Обязательно | Описание |
-|------|:-----------:|----------|
-| Заключение Медиатора | ✅ | Финальный вердикт, синтез, рекомендации |
-| Отчёт Team Alpha | ✅ | Исследование, данные, фреймворки, стратегия |
-| Отчёт Team Beta | ⬚ | Альтернативное исследование, критика, стратегия (Full Pipeline) |
-| Interview Brief | ✅ | Тема, scope, ограничения, целевая аудитория |
-| Appendix D (Synthesis) | ⬚ | Объединённые выводы (если одобрен) |
-| Целевая аудитория | ✅ | CEO / инвестор / операционная команда / внешний клиент |
-| Предпочтения по стилю | ⬚ | Корпоративный брендбук, цвета, шрифты |
-
-> Если обязательные поля не предоставлены — **запросить у пользователя** до начала работы. Не генерировать заглушки.
-
-## Источники данных
-1. session-1-handoff.md — Interview Brief с scope и ограничениями.
-2. session-2-handoff.md — Alpha Report с findings и фреймворками.
-3. session-3-handoff.md — Beta Report с критикой и альтернативой.
-4. session-4-handoff.md — Mediated Conclusion с финальным вердиктом.
-5. Пользовательские предпочтения — аудитория, стиль, формат.
-
-### Связь с другими скилами
-| Скил | Взаимодействие | Когда |
-|------|----------------|-------|
-| `$html-pdf-report` | Главный получатель: Report Design Spec → Layouter реализует в HTML/CSS/Chart.js | После завершения дизайна (шаг 7) |
-| `$gates` (DS-01) | Проверка готовности design spec перед передачей Layouter | После шага 7 |
-| `$handoff` | Передача design spec через handoff envelope | После gate check |
-| `$board` | Обновление статуса DS-01 | После передачи |
-| Фреймворк-скилы | Шаблоны вывода фреймворков (SWOT, BCG, Ansoff и т.д.) → определяют тип визуализации | Шаг 3: выбор визуализаций |
-
-## Протокол
-
-### Шаг 0 — Clarification
-1. Уточнить целевую аудиторию отчёта.
-2. Узнать о наличии корпоративного стиля / брендбука.
-3. Определить уровень детализации:
-
-   | Аудитория | Уровень | Объём | Фокус |
-   |-----------|---------|-------|-------|
-   | CEO / инвестор | Executive | 8-12 стр. | Вердикт, метрики, рекомендации |
-   | Операционная команда | Detailed | 15-25 стр. | Данные, методология, action plan |
-   | Внешний клиент | Presentable | 10-15 стр. | Findings, визуализации, рекомендации |
-
-4. Уточнить формат (A4 portrait, количество страниц).
-5. Зафиксировать предпочтения по визуализациям.
-
-### Шаг 1 — Инвентаризация контента
-1. Пройти все входные артефакты последовательно.
-2. Для каждого элемента зафиксировать:
-
-   | Источник | Элемент | Тип данных | Importance | Рекомендация |
-   |----------|---------|:----------:|:----------:|-------------|
-   | Brief | Scope задачи | Текст | Critical | Title + Exec Summary |
-   | Alpha / RES-01 | TAM рынка EdTech | Число ($4.2B) | Critical | Bar chart + Exec Summary |
-   | Alpha / AN-01 | SWOT-матрица | Фреймворк 2×2 | Important | CSS Matrix |
-   | Mediator | Финальный вердикт | Текст | Critical | Pull quote + Exec Summary |
-   | Beta / ST-02 | Альтернативная стратегия | Текст + таблица | Supporting | Appendix B |
-
-3. Подсчитать: сколько Critical / Important / Supporting элементов.
-4. Отметить точки данных, требующие визуализации.
-5. Отметить текстовые блоки для callout boxes и pull quotes.
-
-### Шаг 2 — Структура отчёта
-1. Определить секции:
-
-   | # | Секция | Стр. | Содержание | Page Break |
-   |---|--------|:----:|------------|:----------:|
-   | 1 | Title Page | 1 | Название, дата, аудитория, логотип | After |
-   | 2 | Table of Contents | 1 | Автогенерация из секций | After |
-   | 3 | Executive Summary | 1-1.5 | Вердикт, findings, рекомендации | After |
-   | 4 | Main: Вердикт и метрики | 2-3 | Ключевые данные, scoring | — |
-   | 5 | Main: Стратегия и roadmap | 2-3 | Рекомендации, дорожная карта | — |
-   | 6 | Main: Детальный анализ | 3-5 | Фреймворки, таблицы | — |
-   | 7 | Appendix A: Alpha Report | 3-5 | Полный отчёт Team Alpha | Before |
-   | 8 | Appendix B: Beta Report | 3-5 | Полный отчёт Team Beta (Full) | Before |
-   | 9 | Appendix C: Mediator Reasoning | 1-2 | Обоснование вердикта | Before |
-   | 10 | Appendix D: Sources | 1-2 | Все источники с датами | Before |
-
-2. Для Quick Pipeline: убрать Appendix B, секции 4-6 сократить.
-3. Назначить page breaks между секциями.
-
-### Шаг 3 — Выбор визуализаций
-
-**Decision tree: тип данных → визуализация:**
-
-| Тип данных | Визуализация | Инструмент | Пример |
-|------------|-------------|------------|--------|
-| Сравнение N значений | **Bar chart** (вертикальный) | Chart.js | Threat Score конкурентов |
-| Тренд / динамика | **Line chart** | Chart.js | Retention curves, выручка по месяцам |
-| Доли / распределение | **Doughnut / Pie** | Chart.js | Доли рынка, распределение бюджета |
-| Мультикритериальное сравнение | **Radar chart** | Chart.js | Сравнение конкурентов по 6+ осям |
-| Позиционирование 2D | **Scatter chart** | Chart.js | Карта позиционирования |
-| Матрица 2×2 | **CSS Grid matrix** | HTML/CSS | SWOT, BCG, Ansoff, Impact×Effort |
-| Процесс / поток | **Flowchart** | Mermaid | Customer journey, пайплайн |
-| Иерархия / структура | **Mindmap** | Mermaid | Стратегия роста, организационная карта |
-| Приоритизация 2D | **Quadrant chart** | Mermaid | Importance×Satisfaction, Impact×Effort |
-| Детальное сравнение | **HTML table** | HTML/CSS | Матрица функционала, scoring |
-| Ключевой вывод | **Callout box** | HTML/CSS | Critical finding, риск, рекомендация |
-| Цитата / вердикт | **Pull quote** | HTML/CSS | Финальный вердикт Медиатора |
-| Единичная метрика | **Score badge** | HTML/CSS | NPS, Threat Score, Opportunity Score |
-
-**Правила:**
-- Максимум **3 визуализации на страницу**.
-- Каждая визуализация имеет `<figcaption>` (подпись) и `aria-label` (accessibility).
-- Фреймворк-скилы определяют структуру данных → Дизайнер выбирает визуальную форму.
-
-### Шаг 4 — Визуальная иерархия
-1. Определить 4 уровня emphasis:
-
-   | Уровень | Элементы | Размещение | CSS-приём |
-   |---------|----------|------------|-----------|
-   | **Hero** | Вердикт, главная рекомендация | Exec Summary, начало Main | Pull quote, крупный шрифт (14-16pt), accent цвет |
-   | **Key Finding** | ТОП-3 findings, критические метрики | Main section | Callout box, score badge, bold |
-   | **Supporting** | Данные, фреймворки, таблицы | Main + Appendices | Стандартный шрифт, data tables |
-   | **Background** | Методология, источники, детали | Appendices | Мелкий шрифт (9-10pt), muted цвет |
-
-2. Severity indicators:
-
-   | Severity | Цвет | Использование |
-   |----------|------|---------------|
-   | Critical / Negative | `var(--danger)` красный | Риски, угрозы, blockers |
-   | Warning / Attention | `var(--warning)` оранжевый | Ограничения, ⚠️ данные |
-   | Positive / Opportunity | `var(--success)` зелёный | Возможности, сильные стороны |
-   | Neutral / Info | `var(--accent)` синий | Контекст, нейтральные данные |
-
-3. Для каждой секции — назначить emphasis level.
-
-### Шаг 5 — Цветовая палитра
-1. Если есть брендбук — адаптировать под корпоративные цвета.
-2. Если нет — использовать дефолтную профессиональную палитру:
-
-   **Дефолтная палитра (тёмно-синяя основа):**
-
-   | Variable | HEX | Использование |
-   |----------|-----|---------------|
-   | `--primary` | `#1a1a2e` | Заголовки, header таблиц, основной текст |
-   | `--secondary` | `#16213e` | Подзаголовки, h3 |
-   | `--accent` | `#0f3460` | Ссылки, callout info, нейтральные акценты |
-   | `--highlight` | `#e94560` | Ключевые метрики, hero-элементы |
-   | `--success` | `#2ecc71` | Позитивные индикаторы, возможности |
-   | `--warning` | `#f39c12` | Предупреждения, ⚠️ данные |
-   | `--danger` | `#e74c3c` | Риски, угрозы, критические |
-   | `--bg-light` | `#f5f5f5` | Фон callout, alternating rows |
-   | `--border` | `#e0e0e0` | Границы таблиц, разделители |
-   | `--text` | `#1a1a2e` | Основной текст |
-   | `--muted` | `#666666` | Подписи, мелкий текст, источники |
-
-   **Chart.js палитра (6 серий):**
-   `['#1a1a2e', '#0f3460', '#e94560', '#2ecc71', '#f39c12', '#9b59b6']`
-
-3. Проверить:
-   - Контрастность WCAG AA: текст на фоне ≥ 4.5:1.
-   - Различимость в ч/б печати: каждый цвет различим в greyscale.
-   - Цветовая слепота: не полагаться только на красный/зелёный — добавлять иконки/текст.
-
-### Шаг 6 — Executive Summary
-1. Написать черновик на основе заключения Медиатора.
-2. Структура:
-
-   ```
-   ## Executive Summary
-
-   ### Контекст
-   [1-2 предложения: что анализировалось, для кого, в каком scope]
-
-   ### Методология
-   [1-2 предложения: какие фреймворки, сколько источников, adversarial подход]
-
-   ### Ключевые выводы
-
-   > «[Главный вердикт Медиатора — pull quote]»
-
-   1. **[Finding 1]:** [описание + ключевая метрика]
-   2. **[Finding 2]:** [описание + ключевая метрика]
-   3. **[Finding 3]:** [описание + ключевая метрика]
-
-   ### Рекомендация
-   [1-2 предложения: что делать, какой приоритет]
-
-   ### Риски
-   [1-2 предложения: основные ограничения и риски]
-
-   ### Следующие шаги
-   [Bulleted list: 3-5 конкретных действий]
-   ```
-
-3. Объём: **максимум 1.5 страницы A4**.
-4. Язык: чёткий, без жаргона, адаптированный под аудиторию.
-5. Каждый finding подкреплён числом или фактом (не «рынок растёт», а «TAM $4.2B, CAGR 18%»).
-
-### Шаг 7 — Report Design Spec (финальный deliverable)
-1. Заполнить полную спецификацию (см. шаблон вывода).
-2. Приложить:
-   - Content Inventory (шаг 1)
-   - Report Structure (шаг 2)
-   - Visualization Map (шаг 3)
-   - Color Palette (шаг 5)
-   - Executive Summary Draft (шаг 6)
-3. Передать Верстальщику через `$handoff`.
-
-## Пример — EdTech-отчёт для CEO
-
-**Контекст:** Анализ рынка EdTech РФ, Full Pipeline, аудитория — CEO. Уровень: Executive (10 стр.).
-
-### Content Inventory (фрагмент)
-
-| Источник | Элемент | Тип | Importance | Визуализация |
-|----------|---------|:---:|:----------:|-------------|
-| Mediator | Вердикт: «AI-first корп. обучение» | Текст | Critical | Pull quote |
-| Alpha/RES-01 | TAM $4.2B, SAM $1.8B, SOM $180M | Числа | Critical | Bar chart |
-| Alpha/AN-01 | Threat Score конкурентов | Scoring | Critical | Bar chart + table |
-| Alpha/AN-01 | SWOT-матрица | 2×2 | Important | CSS Matrix |
-| Beta/AN-02 | Альтернативный Porter's 5 Forces | Scoring 1-5 | Supporting | Radar chart |
-| Mediator | Итоговый scoring Alpha vs Beta | Scoring | Critical | Table + badge |
-
-**Всего:** 28 элементов (8 Critical, 12 Important, 8 Supporting).
-
-### Report Structure
-
-| # | Секция | Стр. | Визуализации | Emphasis |
-|---|--------|:----:|:------------:|:--------:|
-| 1 | Title Page | 1 | — | Hero |
-| 2 | TOC | 0.5 | — | — |
-| 3 | Executive Summary | 1.5 | 1 pull quote, 1 callout | Hero |
-| 4 | Рынок и конкуренция | 2 | Bar (TAM), Radar (конкуренты), Table (threat) | Key Finding |
-| 5 | Стратегия и roadmap | 1.5 | Mindmap (стратегия), Table (actions) | Key Finding |
-| 6 | Appendix A: Alpha | 2 | SWOT matrix, Table | Supporting |
-| 7 | Appendix B: Beta | 1.5 | Porter's radar | Supporting |
-| 8 | Appendix C: Mediator | 1 | Scoring table | Background |
-| 9 | Appendix D: Sources | 1 | — | Background |
-
-**Итого:** ~12 страниц, 9 визуализаций.
-
-### Visualization Map (фрагмент)
-
-| # | Секция | Данные | Тип | Инструмент |
-|---|--------|--------|-----|------------|
-| 1 | Exec Summary | Вердикт Медиатора | Pull quote | HTML/CSS |
-| 2 | Рынок | TAM $4.2B, SAM $1.8B, SOM $180M | Bar chart | Chart.js |
-| 3 | Конкуренция | Threat Score: Skillbox 7.2, Нетология 6.8, Яндекс 7.6 | Bar chart | Chart.js |
-| 4 | Конкуренция | 6 осей сравнения конкурентов | Radar | Chart.js |
-| 5 | Стратегия | Дерево стратегии роста | Mindmap | Mermaid |
-| 6 | App. A | SWOT S/W/O/T | 2×2 matrix | CSS Grid |
-
-## Валидация (Quality Gate)
-
-- [ ] Content Inventory полный: каждый элемент из входных артефактов учтён
-- [ ] Каждая числовая точка данных имеет назначенный тип визуализации (по decision tree)
-- [ ] Структура отчёта полная (Title → TOC → Summary → Main → Appendices)
-- [ ] Executive Summary ≤ 1.5 стр., содержит: контекст, методологию, 3-5 findings с числами, рекомендацию
-- [ ] Визуальная иерархия определена (4 уровня emphasis) и назначена секциям
-- [ ] Палитра определена (11 CSS variables), проверена на контрастность WCAG AA и ч/б различимость
-- [ ] Chart.js палитра определена (6 серий)
-- [ ] Максимум 3 визуализации на страницу
-- [ ] Report Design Spec заполнен полностью (structure + visualization map + palette + exec summary)
-- [ ] Brief compliance: отчёт отвечает на вопросы из Interview Brief
-- [ ] Appendix D (Sources) включён / исключён осознанно
-- [ ] Каждая визуализация имеет подпись (`figcaption`) и `aria-label`
-
-## Handoff
-Результат `$report-design` является входом для:
-- **`$html-pdf-report`** (Layouter) — главный получатель: реализация в HTML/CSS/Chart.js/Mermaid.
-- **`$gates` (DS-01)** — проверка готовности design spec.
-- **`$board`** — обновление статуса DS-01.
-
-Формат передачи: Report Design Spec (structure + content inventory + visualization map + color palette + executive summary draft). При передаче — использовать `$handoff`.
-
-## Anti-patterns
-
-| Ошибка | Почему плохо | Как правильно |
-|--------|-------------|---------------|
-| Дизайн без инвентаризации | Пустые секции, лишние графики | Сначала пройти все артефакты, создать реестр |
-| Один тип графика на всё | Неинформативно, не подходит под тип данных | Decision tree: тип данных → визуализация |
-| Executive summary > 2 стр. | Руководитель не читает | Максимум 1.5 страницы, факты с числами |
-| Палитра для экрана | В PDF серо и неразличимо | WCAG AA, ч/б различимость, тест цветовой слепоты |
-| Перегруженные страницы | Каша из графиков | Максимум 3 визуализации на страницу |
-| Изменение выводов | Нарушение chain of custody: Дизайнер не аналитик | Оформлять, не редактировать содержание |
-| Findings без чисел | «Рынок растёт» — не finding | Каждый finding = конкретная метрика: «TAM $4.2B, CAGR 18%» |
-| Палитра без HEX-кодов | Layouter не может реализовать «тёмно-синяя основа» | 11 CSS variables с конкретными HEX |
-
-## Шаблон вывода
-
-```
-## Report Design Spec: [Тема отчёта]
-**Аудитория:** [CEO / инвестор / опер. команда / внешний клиент]
-**Уровень:** [Executive / Detailed / Presentable]
-**Режим:** Full / Quick
-**Страниц:** ~[N]
-**Дата:** [дата]
-
----
-
-### Content Inventory
-
-| Источник | Элемент | Тип данных | Importance | Рекомендация |
-|----------|---------|:----------:|:----------:|-------------|
-| [Источник] | [Элемент] | [Число/Текст/Фреймворк/Scoring] | Critical/Important/Supporting | [Визуализация / секция] |
-
-**Итого:** [N] элементов ([N] Critical, [N] Important, [N] Supporting)
-
----
-
-### Report Structure
-
-| # | Секция | Стр. | Визуализации | Emphasis | Page Break |
-|---|--------|:----:|:------------:|:--------:|:----------:|
-| 1 | Title Page | 1 | — | Hero | After |
-| 2 | TOC | 0.5-1 | — | — | After |
-| 3 | Executive Summary | 1-1.5 | [N]: [типы] | Hero | After |
-| 4 | Main: [Название] | [N] | [N]: [типы] | Key Finding | — |
-| 5 | Main: [Название] | [N] | [N]: [типы] | Key Finding | — |
-| 6 | Appendix A: Alpha | [N] | [N]: [типы] | Supporting | Before |
-| 7 | Appendix B: Beta | [N] | [N]: [типы] | Supporting | Before |
-| 8 | Appendix C: Mediator | [N] | [N]: [типы] | Background | Before |
-| 9 | Appendix D: Sources | [N] | — | Background | Before |
-
----
-
-### Visualization Map
-
-| # | Секция | Данные | Тип визуализации | Инструмент | Подпись (figcaption) |
-|---|--------|--------|:----------------:|:----------:|---------------------|
-| 1 | [Секция] | [Какие данные] | [Bar/Line/Radar/...] | Chart.js / Mermaid / CSS | «Рис. N — [описание]» |
-
----
-
-### Color Palette
-
-| Variable | HEX | Использование |
-|----------|-----|---------------|
-| --primary | #XXXXXX | Заголовки, header таблиц |
-| --secondary | #XXXXXX | Подзаголовки |
-| --accent | #XXXXXX | Ссылки, callout info |
-| --highlight | #XXXXXX | Ключевые метрики |
-| --success | #XXXXXX | Позитивные индикаторы |
-| --warning | #XXXXXX | Предупреждения |
-| --danger | #XXXXXX | Риски, критические |
-| --bg-light | #XXXXXX | Фон callout, alternating rows |
-| --border | #XXXXXX | Границы |
-| --text | #XXXXXX | Основной текст |
-| --muted | #XXXXXX | Подписи, мелкий текст |
-
-**Chart.js серии:** ['#XXXXXX', '#XXXXXX', '#XXXXXX', '#XXXXXX', '#XXXXXX', '#XXXXXX']
-
-**Проверки:** WCAG AA ✅ / ⚠️ | ч/б различимость ✅ / ⚠️ | Цветовая слепота ✅ / ⚠️
-
----
-
-### Executive Summary (Draft)
-
-## Executive Summary
-
-### Контекст
-[1-2 предложения: что анализировалось, для кого, scope]
-
-### Методология
-[1-2 предложения: фреймворки, источники, adversarial подход]
-
-### Ключевые выводы
-
-> «[Главный вердикт Медиатора]»
-
-1. **[Finding 1]:** [описание + метрика]
-2. **[Finding 2]:** [описание + метрика]
-3. **[Finding 3]:** [описание + метрика]
-
-### Рекомендация
-[1-2 предложения: что делать]
-
-### Риски
-[1-2 предложения: ограничения]
-
-### Следующие шаги
-- [Действие 1]
-- [Действие 2]
-- [Действие 3]
-
----
-
-### Emphasis Map
-
-| Секция | Emphasis Level | Элементы |
-|--------|:-------------:|----------|
-| [Секция] | Hero / Key / Supporting / Background | [Какие элементы] |
-```
+---
+name: report-design
+description: Проектирование макета аналитического отчёта — структура, визуализации, иерархия, палитра
+type: triggered
+domain: analytics
+owners:
+  - layouter
+  - data_analyst
+gates:
+  - LAYOUTER
+  - DATA_ANALYST
+tech: []
+topic: []
+triggers:
+  - "report-design"
+  - "дизайн отчёта"
+  - "структура отчёта"
+  - "report structure"
+related: []
+budget_lines: 416
+schema_version: 1
+---
+# Дизайн отчёта — Проектирование макета аналитического отчёта
+
+## Когда использовать
+- При подготовке **финального аналитического отчёта** по результатам пайплайна (Сессия 5 Full Pipeline или финал Quick Pipeline).
+- При необходимости **спроектировать структуру** PDF-отчёта: какие секции, какие визуализации, какая иерархия.
+- При создании **report design specification** для передачи Верстальщику (Layouter).
+- При проектировании **executive summary** на основе заключения Медиатора.
+- При определении **цветовой палитры** и **визуальной иерархии** для печатного документа.
+
+## Вход
+
+| Поле | Обязательно | Описание |
+|------|:-----------:|----------|
+| Заключение Медиатора | ✅ | Финальный вердикт, синтез, рекомендации |
+| Отчёт Team Alpha | ✅ | Исследование, данные, фреймворки, стратегия |
+| Отчёт Team Beta | ⬚ | Альтернативное исследование, критика, стратегия (Full Pipeline) |
+| Interview Brief | ✅ | Тема, scope, ограничения, целевая аудитория |
+| Appendix D (Synthesis) | ⬚ | Объединённые выводы (если одобрен) |
+| Целевая аудитория | ✅ | CEO / инвестор / операционная команда / внешний клиент |
+| Предпочтения по стилю | ⬚ | Корпоративный брендбук, цвета, шрифты |
+
+> Если обязательные поля не предоставлены — **запросить у пользователя** до начала работы. Не генерировать заглушки.
+
+## Источники данных
+1. session-1-handoff.md — Interview Brief с scope и ограничениями.
+2. session-2-handoff.md — Alpha Report с findings и фреймворками.
+3. session-3-handoff.md — Beta Report с критикой и альтернативой.
+4. session-4-handoff.md — Mediated Conclusion с финальным вердиктом.
+5. Пользовательские предпочтения — аудитория, стиль, формат.
+
+### Связь с другими скилами
+| Скил | Взаимодействие | Когда |
+|------|----------------|-------|
+| `$html-pdf-report` | Главный получатель: Report Design Spec → Layouter реализует в HTML/CSS/Chart.js | После завершения дизайна (шаг 7) |
+| `$gates` (DS-01) | Проверка готовности design spec перед передачей Layouter | После шага 7 |
+| `$handoff` | Передача design spec через handoff envelope | После gate check |
+| `$board` | Обновление статуса DS-01 | После передачи |
+| Фреймворк-скилы | Шаблоны вывода фреймворков (SWOT, BCG, Ansoff и т.д.) → определяют тип визуализации | Шаг 3: выбор визуализаций |
+
+## Протокол
+
+### Шаг 0 — Clarification
+1. Уточнить целевую аудиторию отчёта.
+2. Узнать о наличии корпоративного стиля / брендбука.
+3. Определить уровень детализации:
+
+   | Аудитория | Уровень | Объём | Фокус |
+   |-----------|---------|-------|-------|
+   | CEO / инвестор | Executive | 8-12 стр. | Вердикт, метрики, рекомендации |
+   | Операционная команда | Detailed | 15-25 стр. | Данные, методология, action plan |
+   | Внешний клиент | Presentable | 10-15 стр. | Findings, визуализации, рекомендации |
+
+4. Уточнить формат (A4 portrait, количество страниц).
+5. Зафиксировать предпочтения по визуализациям.
+
+### Шаг 1 — Инвентаризация контента
+1. Пройти все входные артефакты последовательно.
+2. Для каждого элемента зафиксировать:
+
+   | Источник | Элемент | Тип данных | Importance | Рекомендация |
+   |----------|---------|:----------:|:----------:|-------------|
+   | Brief | Scope задачи | Текст | Critical | Title + Exec Summary |
+   | Alpha / RES-01 | TAM рынка EdTech | Число ($4.2B) | Critical | Bar chart + Exec Summary |
+   | Alpha / AN-01 | SWOT-матрица | Фреймворк 2×2 | Important | CSS Matrix |
+   | Mediator | Финальный вердикт | Текст | Critical | Pull quote + Exec Summary |
+   | Beta / ST-02 | Альтернативная стратегия | Текст + таблица | Supporting | Appendix B |
+
+3. Подсчитать: сколько Critical / Important / Supporting элементов.
+4. Отметить точки данных, требующие визуализации.
+5. Отметить текстовые блоки для callout boxes и pull quotes.
+
+### Шаг 2 — Структура отчёта
+1. Определить секции:
+
+   | # | Секция | Стр. | Содержание | Page Break |
+   |---|--------|:----:|------------|:----------:|
+   | 1 | Title Page | 1 | Название, дата, аудитория, логотип | After |
+   | 2 | Table of Contents | 1 | Автогенерация из секций | After |
+   | 3 | Executive Summary | 1-1.5 | Вердикт, findings, рекомендации | After |
+   | 4 | Main: Вердикт и метрики | 2-3 | Ключевые данные, scoring | — |
+   | 5 | Main: Стратегия и roadmap | 2-3 | Рекомендации, дорожная карта | — |
+   | 6 | Main: Детальный анализ | 3-5 | Фреймворки, таблицы | — |
+   | 7 | Appendix A: Alpha Report | 3-5 | Полный отчёт Team Alpha | Before |
+   | 8 | Appendix B: Beta Report | 3-5 | Полный отчёт Team Beta (Full) | Before |
+   | 9 | Appendix C: Mediator Reasoning | 1-2 | Обоснование вердикта | Before |
+   | 10 | Appendix D: Sources | 1-2 | Все источники с датами | Before |
+
+2. Для Quick Pipeline: убрать Appendix B, секции 4-6 сократить.
+3. Назначить page breaks между секциями.
+
+### Шаг 3 — Выбор визуализаций
+
+**Decision tree: тип данных → визуализация:**
+
+| Тип данных | Визуализация | Инструмент | Пример |
+|------------|-------------|------------|--------|
+| Сравнение N значений | **Bar chart** (вертикальный) | Chart.js | Threat Score конкурентов |
+| Тренд / динамика | **Line chart** | Chart.js | Retention curves, выручка по месяцам |
+| Доли / распределение | **Doughnut / Pie** | Chart.js | Доли рынка, распределение бюджета |
+| Мультикритериальное сравнение | **Radar chart** | Chart.js | Сравнение конкурентов по 6+ осям |
+| Позиционирование 2D | **Scatter chart** | Chart.js | Карта позиционирования |
+| Матрица 2×2 | **CSS Grid matrix** | HTML/CSS | SWOT, BCG, Ansoff, Impact×Effort |
+| Процесс / поток | **Flowchart** | Mermaid | Customer journey, пайплайн |
+| Иерархия / структура | **Mindmap** | Mermaid | Стратегия роста, организационная карта |
+| Приоритизация 2D | **Quadrant chart** | Mermaid | Importance×Satisfaction, Impact×Effort |
+| Детальное сравнение | **HTML table** | HTML/CSS | Матрица функционала, scoring |
+| Ключевой вывод | **Callout box** | HTML/CSS | Critical finding, риск, рекомендация |
+| Цитата / вердикт | **Pull quote** | HTML/CSS | Финальный вердикт Медиатора |
+| Единичная метрика | **Score badge** | HTML/CSS | NPS, Threat Score, Opportunity Score |
+
+**Правила:**
+- Максимум **3 визуализации на страницу**.
+- Каждая визуализация имеет `<figcaption>` (подпись) и `aria-label` (accessibility).
+- Фреймворк-скилы определяют структуру данных → Дизайнер выбирает визуальную форму.
+
+### Шаг 4 — Визуальная иерархия
+1. Определить 4 уровня emphasis:
+
+   | Уровень | Элементы | Размещение | CSS-приём |
+   |---------|----------|------------|-----------|
+   | **Hero** | Вердикт, главная рекомендация | Exec Summary, начало Main | Pull quote, крупный шрифт (14-16pt), accent цвет |
+   | **Key Finding** | ТОП-3 findings, критические метрики | Main section | Callout box, score badge, bold |
+   | **Supporting** | Данные, фреймворки, таблицы | Main + Appendices | Стандартный шрифт, data tables |
+   | **Background** | Методология, источники, детали | Appendices | Мелкий шрифт (9-10pt), muted цвет |
+
+2. Severity indicators:
+
+   | Severity | Цвет | Использование |
+   |----------|------|---------------|
+   | Critical / Negative | `var(--danger)` красный | Риски, угрозы, blockers |
+   | Warning / Attention | `var(--warning)` оранжевый | Ограничения, ⚠️ данные |
+   | Positive / Opportunity | `var(--success)` зелёный | Возможности, сильные стороны |
+   | Neutral / Info | `var(--accent)` синий | Контекст, нейтральные данные |
+
+3. Для каждой секции — назначить emphasis level.
+
+### Шаг 5 — Цветовая палитра
+1. Если есть брендбук — адаптировать под корпоративные цвета.
+2. Если нет — использовать дефолтную профессиональную палитру:
+
+   **Дефолтная палитра (тёмно-синяя основа):**
+
+   | Variable | HEX | Использование |
+   |----------|-----|---------------|
+   | `--primary` | `#1a1a2e` | Заголовки, header таблиц, основной текст |
+   | `--secondary` | `#16213e` | Подзаголовки, h3 |
+   | `--accent` | `#0f3460` | Ссылки, callout info, нейтральные акценты |
+   | `--highlight` | `#e94560` | Ключевые метрики, hero-элементы |
+   | `--success` | `#2ecc71` | Позитивные индикаторы, возможности |
+   | `--warning` | `#f39c12` | Предупреждения, ⚠️ данные |
+   | `--danger` | `#e74c3c` | Риски, угрозы, критические |
+   | `--bg-light` | `#f5f5f5` | Фон callout, alternating rows |
+   | `--border` | `#e0e0e0` | Границы таблиц, разделители |
+   | `--text` | `#1a1a2e` | Основной текст |
+   | `--muted` | `#666666` | Подписи, мелкий текст, источники |
+
+   **Chart.js палитра (6 серий):**
+   `['#1a1a2e', '#0f3460', '#e94560', '#2ecc71', '#f39c12', '#9b59b6']`
+
+3. Проверить:
+   - Контрастность WCAG AA: текст на фоне ≥ 4.5:1.
+   - Различимость в ч/б печати: каждый цвет различим в greyscale.
+   - Цветовая слепота: не полагаться только на красный/зелёный — добавлять иконки/текст.
+
+### Шаг 6 — Executive Summary
+1. Написать черновик на основе заключения Медиатора.
+2. Структура:
+
+   ```
+   ## Executive Summary
+
+   ### Контекст
+   [1-2 предложения: что анализировалось, для кого, в каком scope]
+
+   ### Методология
+   [1-2 предложения: какие фреймворки, сколько источников, adversarial подход]
+
+   ### Ключевые выводы
+
+   > «[Главный вердикт Медиатора — pull quote]»
+
+   1. **[Finding 1]:** [описание + ключевая метрика]
+   2. **[Finding 2]:** [описание + ключевая метрика]
+   3. **[Finding 3]:** [описание + ключевая метрика]
+
+   ### Рекомендация
+   [1-2 предложения: что делать, какой приоритет]
+
+   ### Риски
+   [1-2 предложения: основные ограничения и риски]
+
+   ### Следующие шаги
+   [Bulleted list: 3-5 конкретных действий]
+   ```
+
+3. Объём: **максимум 1.5 страницы A4**.
+4. Язык: чёткий, без жаргона, адаптированный под аудиторию.
+5. Каждый finding подкреплён числом или фактом (не «рынок растёт», а «TAM $4.2B, CAGR 18%»).
+
+### Шаг 7 — Report Design Spec (финальный deliverable)
+1. Заполнить полную спецификацию (см. шаблон вывода).
+2. Приложить:
+   - Content Inventory (шаг 1)
+   - Report Structure (шаг 2)
+   - Visualization Map (шаг 3)
+   - Color Palette (шаг 5)
+   - Executive Summary Draft (шаг 6)
+3. Передать Верстальщику через `$handoff`.
+
+## Пример — EdTech-отчёт для CEO
+
+**Контекст:** Анализ рынка EdTech РФ, Full Pipeline, аудитория — CEO. Уровень: Executive (10 стр.).
+
+### Content Inventory (фрагмент)
+
+| Источник | Элемент | Тип | Importance | Визуализация |
+|----------|---------|:---:|:----------:|-------------|
+| Mediator | Вердикт: «AI-first корп. обучение» | Текст | Critical | Pull quote |
+| Alpha/RES-01 | TAM $4.2B, SAM $1.8B, SOM $180M | Числа | Critical | Bar chart |
+| Alpha/AN-01 | Threat Score конкурентов | Scoring | Critical | Bar chart + table |
+| Alpha/AN-01 | SWOT-матрица | 2×2 | Important | CSS Matrix |
+| Beta/AN-02 | Альтернативный Porter's 5 Forces | Scoring 1-5 | Supporting | Radar chart |
+| Mediator | Итоговый scoring Alpha vs Beta | Scoring | Critical | Table + badge |
+
+**Всего:** 28 элементов (8 Critical, 12 Important, 8 Supporting).
+
+### Report Structure
+
+| # | Секция | Стр. | Визуализации | Emphasis |
+|---|--------|:----:|:------------:|:--------:|
+| 1 | Title Page | 1 | — | Hero |
+| 2 | TOC | 0.5 | — | — |
+| 3 | Executive Summary | 1.5 | 1 pull quote, 1 callout | Hero |
+| 4 | Рынок и конкуренция | 2 | Bar (TAM), Radar (конкуренты), Table (threat) | Key Finding |
+| 5 | Стратегия и roadmap | 1.5 | Mindmap (стратегия), Table (actions) | Key Finding |
+| 6 | Appendix A: Alpha | 2 | SWOT matrix, Table | Supporting |
+| 7 | Appendix B: Beta | 1.5 | Porter's radar | Supporting |
+| 8 | Appendix C: Mediator | 1 | Scoring table | Background |
+| 9 | Appendix D: Sources | 1 | — | Background |
+
+**Итого:** ~12 страниц, 9 визуализаций.
+
+### Visualization Map (фрагмент)
+
+| # | Секция | Данные | Тип | Инструмент |
+|---|--------|--------|-----|------------|
+| 1 | Exec Summary | Вердикт Медиатора | Pull quote | HTML/CSS |
+| 2 | Рынок | TAM $4.2B, SAM $1.8B, SOM $180M | Bar chart | Chart.js |
+| 3 | Конкуренция | Threat Score: Skillbox 7.2, Нетология 6.8, Яндекс 7.6 | Bar chart | Chart.js |
+| 4 | Конкуренция | 6 осей сравнения конкурентов | Radar | Chart.js |
+| 5 | Стратегия | Дерево стратегии роста | Mindmap | Mermaid |
+| 6 | App. A | SWOT S/W/O/T | 2×2 matrix | CSS Grid |
+
+## Валидация (Quality Gate)
+
+- [ ] Content Inventory полный: каждый элемент из входных артефактов учтён
+- [ ] Каждая числовая точка данных имеет назначенный тип визуализации (по decision tree)
+- [ ] Структура отчёта полная (Title → TOC → Summary → Main → Appendices)
+- [ ] Executive Summary ≤ 1.5 стр., содержит: контекст, методологию, 3-5 findings с числами, рекомендацию
+- [ ] Визуальная иерархия определена (4 уровня emphasis) и назначена секциям
+- [ ] Палитра определена (11 CSS variables), проверена на контрастность WCAG AA и ч/б различимость
+- [ ] Chart.js палитра определена (6 серий)
+- [ ] Максимум 3 визуализации на страницу
+- [ ] Report Design Spec заполнен полностью (structure + visualization map + palette + exec summary)
+- [ ] Brief compliance: отчёт отвечает на вопросы из Interview Brief
+- [ ] Appendix D (Sources) включён / исключён осознанно
+- [ ] Каждая визуализация имеет подпись (`figcaption`) и `aria-label`
+
+## Handoff
+Результат `$report-design` является входом для:
+- **`$html-pdf-report`** (Layouter) — главный получатель: реализация в HTML/CSS/Chart.js/Mermaid.
+- **`$gates` (DS-01)** — проверка готовности design spec.
+- **`$board`** — обновление статуса DS-01.
+
+Формат передачи: Report Design Spec (structure + content inventory + visualization map + color palette + executive summary draft). При передаче — использовать `$handoff`.
+
+## Anti-patterns
+
+| Ошибка | Почему плохо | Как правильно |
+|--------|-------------|---------------|
+| Дизайн без инвентаризации | Пустые секции, лишние графики | Сначала пройти все артефакты, создать реестр |
+| Один тип графика на всё | Неинформативно, не подходит под тип данных | Decision tree: тип данных → визуализация |
+| Executive summary > 2 стр. | Руководитель не читает | Максимум 1.5 страницы, факты с числами |
+| Палитра для экрана | В PDF серо и неразличимо | WCAG AA, ч/б различимость, тест цветовой слепоты |
+| Перегруженные страницы | Каша из графиков | Максимум 3 визуализации на страницу |
+| Изменение выводов | Нарушение chain of custody: Дизайнер не аналитик | Оформлять, не редактировать содержание |
+| Findings без чисел | «Рынок растёт» — не finding | Каждый finding = конкретная метрика: «TAM $4.2B, CAGR 18%» |
+| Палитра без HEX-кодов | Layouter не может реализовать «тёмно-синяя основа» | 11 CSS variables с конкретными HEX |
+
+## Шаблон вывода
+
+```
+## Report Design Spec: [Тема отчёта]
+**Аудитория:** [CEO / инвестор / опер. команда / внешний клиент]
+**Уровень:** [Executive / Detailed / Presentable]
+**Режим:** Full / Quick
+**Страниц:** ~[N]
+**Дата:** [дата]
+
+---
+
+### Content Inventory
+
+| Источник | Элемент | Тип данных | Importance | Рекомендация |
+|----------|---------|:----------:|:----------:|-------------|
+| [Источник] | [Элемент] | [Число/Текст/Фреймворк/Scoring] | Critical/Important/Supporting | [Визуализация / секция] |
+
+**Итого:** [N] элементов ([N] Critical, [N] Important, [N] Supporting)
+
+---
+
+### Report Structure
+
+| # | Секция | Стр. | Визуализации | Emphasis | Page Break |
+|---|--------|:----:|:------------:|:--------:|:----------:|
+| 1 | Title Page | 1 | — | Hero | After |
+| 2 | TOC | 0.5-1 | — | — | After |
+| 3 | Executive Summary | 1-1.5 | [N]: [типы] | Hero | After |
+| 4 | Main: [Название] | [N] | [N]: [типы] | Key Finding | — |
+| 5 | Main: [Название] | [N] | [N]: [типы] | Key Finding | — |
+| 6 | Appendix A: Alpha | [N] | [N]: [типы] | Supporting | Before |
+| 7 | Appendix B: Beta | [N] | [N]: [типы] | Supporting | Before |
+| 8 | Appendix C: Mediator | [N] | [N]: [типы] | Background | Before |
+| 9 | Appendix D: Sources | [N] | — | Background | Before |
+
+---
+
+### Visualization Map
+
+| # | Секция | Данные | Тип визуализации | Инструмент | Подпись (figcaption) |
+|---|--------|--------|:----------------:|:----------:|---------------------|
+| 1 | [Секция] | [Какие данные] | [Bar/Line/Radar/...] | Chart.js / Mermaid / CSS | «Рис. N — [описание]» |
+
+---
+
+### Color Palette
+
+| Variable | HEX | Использование |
+|----------|-----|---------------|
+| --primary | #XXXXXX | Заголовки, header таблиц |
+| --secondary | #XXXXXX | Подзаголовки |
+| --accent | #XXXXXX | Ссылки, callout info |
+| --highlight | #XXXXXX | Ключевые метрики |
+| --success | #XXXXXX | Позитивные индикаторы |
+| --warning | #XXXXXX | Предупреждения |
+| --danger | #XXXXXX | Риски, критические |
+| --bg-light | #XXXXXX | Фон callout, alternating rows |
+| --border | #XXXXXX | Границы |
+| --text | #XXXXXX | Основной текст |
+| --muted | #XXXXXX | Подписи, мелкий текст |
+
+**Chart.js серии:** ['#XXXXXX', '#XXXXXX', '#XXXXXX', '#XXXXXX', '#XXXXXX', '#XXXXXX']
+
+**Проверки:** WCAG AA ✅ / ⚠️ | ч/б различимость ✅ / ⚠️ | Цветовая слепота ✅ / ⚠️
+
+---
+
+### Executive Summary (Draft)
+
+## Executive Summary
+
+### Контекст
+[1-2 предложения: что анализировалось, для кого, scope]
+
+### Методология
+[1-2 предложения: фреймворки, источники, adversarial подход]
+
+### Ключевые выводы
+
+> «[Главный вердикт Медиатора]»
+
+1. **[Finding 1]:** [описание + метрика]
+2. **[Finding 2]:** [описание + метрика]
+3. **[Finding 3]:** [описание + метрика]
+
+### Рекомендация
+[1-2 предложения: что делать]
+
+### Риски
+[1-2 предложения: ограничения]
+
+### Следующие шаги
+- [Действие 1]
+- [Действие 2]
+- [Действие 3]
+
+---
+
+### Emphasis Map
+
+| Секция | Emphasis Level | Элементы |
+|--------|:-------------:|----------|
+| [Секция] | Hero / Key / Supporting / Background | [Какие элементы] |
+```