code-ai-installer 2.1.0 → 2.3.0

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

@@ -0,0 +1,708 @@
+---
+name: report-design
+description: Проектирование макета PRD или Product Review Deck — структура, навигация, визуальная иерархия
+---
+# Report Design — Проектирование макета PRD / Product Review Deck
+
+## Когда использовать
+- При подготовке **финального PRD** или **Product Review Deck** (Сессия 6 Full Pipeline A/B).
+- При необходимости **спроектировать структуру** PDF-документа: какие секции, какие визуализации, какая иерархия.
+- При создании **design specification** для передачи Layouter'у.
+- При проектировании **executive summary** на основе Unified Strategy Brief (Mediator synthesis) или утверждённого scope.
+- При определении **цветовой палитры** и **визуальной иерархии** для PRD-документа (B2B SaaS обычно sober, data-driven tone).
+
+## Вход
+
+| Поле | Обязательно | Описание |
+|------|:-----------:|----------|
+| Mediator synthesis | ✅ | Unified Strategy Brief (Full A) или Final Scope Decision (Full B) |
+| PRD (из PM-SPEC) | ✅ | User stories, AC, NFR, success metrics, risks, rollout |
+| Отчёт 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. Для каждого элемента зафиксировать:
+
+   | Источник | Элемент | Тип данных | Важность | Рекомендация |
+   |----------|---------|:----------:|:----------:|-------------|
+   | PRD | Problem + TL;DR | Текст | Критический | Обложка + Резюме для руководства |
+   | Mediator synthesis | Unified vision + NSM | Текст + метрика | Критический | Pull quote + Резюме для руководства |
+   | PRD / PM-SPEC | User stories + AC (top 5) | Таблица | Критический | Таблица stories + Appendix A |
+   | PM / RICE | Prioritized backlog | Таблица оценок | Важный | Bar chart + раздел Backlog |
+   | Strategy / Roadmap | Now/Next/Later | Timeline | Важный | Визуализация roadmap |
+   | Data Analyst | Metric tree + targets | Диаграмма + числа | Критический | Диаграмма metric tree |
+   | Tech Lead | Risk register (top 5) | Таблица | Важный | Раздел рисков |
+   | Strategy Briefs Alpha+Beta (Full A) | Отклонённые пути | Текст | Вспомогательный | Appendix B (обоснование синтеза) |
+
+3. Подсчитать: сколько Critical / Important / Supporting элементов.
+4. Отметить точки данных, требующие визуализации.
+5. Отметить текстовые блоки для callout boxes и pull quotes.
+
+### Шаг 2 — Структура отчёта
+1. Определить секции:
+
+   | # | Секция | Стр. | Содержание | Разрыв страницы |
+   |---|--------|:----:|------------|:----------:|
+   | 1 | Титульная страница | 1 | Название, дата, аудитория, логотип | После |
+   | 2 | Оглавление | 1 | Автогенерация из секций | После |
+   | 3 | Резюме для руководства | 1-1.5 | Вердикт, выводы, рекомендации | После |
+   | 4 | Main: Вердикт и метрики | 2-3 | Ключевые данные, scoring | — |
+   | 5 | Main: Стратегия и roadmap | 2-3 | Рекомендации, дорожная карта | — |
+   | 6 | Main: Детальный анализ | 3-5 | Фреймворки, таблицы | — |
+   | 7 | Appendix A: Alpha Report | 3-5 | Полный отчёт Team Alpha | До |
+   | 8 | Appendix B: Beta Report | 3-5 | Полный отчёт Team Beta (Full) | До |
+   | 9 | Appendix C: Mediator Reasoning | 1-2 | Обоснование вердикта | До |
+   | 10 | Appendix D: Sources | 1-2 | Все источники с датами | До |
+
+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 ключевых вывода, критические метрики | Основная секция | Callout box, score badge, bold |
+   | **Supporting** | Данные, фреймворки, таблицы | Main + Appendices | Стандартный шрифт, data tables |
+   | **Background** | Методология, источники, детали | Appendices | Мелкий шрифт (9-10pt), приглушённый цвет |
+
+2. Индикаторы критичности:
+
+   | Критичность | Цвет | Использование |
+   |----------|------|---------------|
+   | Критический / Негативный | `var(--danger)` красный | Риски, угрозы, blockers |
+   | Предупреждение / Внимание | `var(--warning)` оранжевый | Ограничения, ⚠️ данные |
+   | Позитивный / Возможность | `var(--success)` зелёный | Возможности, сильные стороны |
+   | Нейтральный / Информация | `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`.
+
+## Пример — TeamFlow Product Review Deck для exec review
+
+**Контекст:** TeamFlow (B2B SaaS HR-tech, $8M ARR). Инициатива: AI-powered 1:1 summarization. Full Pipeline A завершён, готовим Product Review Deck для CEO / CRO / VP Eng review. Уровень: Executive (12 слайдов).
+
+### Content Inventory (фрагмент)
+
+| Источник | Элемент | Тип | Важность | Визуализация |
+|----------|---------|:---:|:----------:|-------------|
+| Mediator synthesis | Vision: «Помочь компаниям измеримо повысить эффективность менеджеров через AI-assisted 1:1s» | Текст | Критический | Pull quote (Слайд 3) |
+| Mediator / Data Analyst | NSM: «weekly 1:1s with AI summary used» target 50% в 90 дн | Метрика | Критический | Metric tree + target gauge |
+| PM / RICE | Топ-7 приоритизированных user stories | Таблица оценок | Критический | Backlog bar chart |
+| 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 | [Какие элементы] |
+```
+
+## Worked Example — TeamFlow Product Review Deck Design Spec
+
+**Контекст:** `/ship-right-thing` завершён. Unified Strategy Brief (Mediator) + PRD + Metric Plan готовы. Designer готовит design spec для Layouter — Product Review Deck (12 слайдов, executive-аудитория).
+
+```markdown
+# Design Spec: TeamFlow AI Summarization Product Review Deck
+
+**Целевой артефакт:** Product Review Deck (презентация для executive sign-off)
+**Уровень аудитории:** Executive (CEO, CPO, VP Sales, VP Product)
+**Объём:** 12 страниц в формате слайдов
+**Распространение:** PDF по email + живая презентация на review meeting
+**Тон:** Сдержанный, профессиональный, ориентированный на данные (см. оси тона GTM brief — 80% serious)
+
+---
+
+## Выбор типа артефакта
+
+**Почему Deck, а не PRD-как-документ:**
+- Аудитория = руководители (5-10 минут просмотра; живая презентация 30 минут)
+- Требуемое решение = go/no-go sign-off (не справочный материал)
+- Ожидание mid-market + enterprise B2B SaaS = визуалы уровня exec
+
+**Вторичный артефакт:** Полный PRD (40+ страниц, формат документа) делается separately for engineering/design team — через отдельный скил `$prd-template`. Deck ссылается на PRD в приложении.
+
+---
+
+## Информационная архитектура (12 страниц)
+
+| # | Страница | Назначение | Акцент | Ключевая визуализация |
+|:-:|----------|-----------|:------:|----------------------|
+| 1 | Обложка | Привлечь внимание, задать контекст | Hero | Крупный заголовок, подзаголовок, дата |
+| 2 | Executive Summary (TL;DR) | 30-секундное чтение даёт полную картину | Hero | Pull quote + 3 KPI-карточки |
+| 3 | Проблема | Обозначить срочность с доказательствами | Key | 3 KPI-карточки «масштаб боли» + callouts с дословными цитатами |
+| 4 | Возможность | Масштаб приза | Key | Metric tree со стрелками бизнес-влияния |
+| 5 | Unified Strategy (синтез Mediator) | Подход | Key | Vision statement + список 4 принципов + диаграмма tier-архитектуры |
+| 6 | Product Scope (MoSCoW) | Что входит, что нет | Key | Таблица Must/Should/Could с обоснованием scope |
+| 7 | Пользовательский опыт | Ощущение продукта | Supporting | 3-4 вайрфрейм-миниатюры + стрелки флоу |
+| 8 | Метрики и NSM | Определение успеха | Key | Metric tree + целевые показатели 30/90 дней |
+| 9 | Риски и меры снижения | Доверие | Key | Таблица top 5 рисков с матрицей вероятность × влияние |
+| 10 | План rollout | Исполнение | Supporting | Таймлайн по неделям + диаграмма поэтапного rollout |
+| 11 | Инвестиции и ROI | Бизнес-кейс | Key | График прогноза 3 сценариев + разбивка затрат |
+| 12 | Roadmap Now/Next/Later | Будущее направление | Supporting | 3-колоночный roadmap |
+
+---
+
+## Визуальная иерархия
+
+### Типографическая шкала
+
+| Уровень | Шрифт | Размер | Насыщенность | Использование |
+|---------|-------|:------:|:------------:|--------------|
+| H1 (заголовок страницы) | Inter | 32px | 700 | Заголовки страниц |
+| H2 (раздел) | Inter | 22px | 600 | Разделы внутри страницы |
+| H3 (подраздел) | Inter | 16px | 600 | Подразделы |
+| Lead (вступительный абзац) | Inter | 16px | 400 | Первый абзац на странице |
+| Body | Inter | 14px | 400 | Стандартный текст |
+| Pull-quote | Source Serif Pro | 20px | 400 | Ключевые цитаты, vision statements |
+| Значение KPI | Inter | 32px | 700 | Крупные числа метрик |
+| Подпись KPI | Inter | 11px | 500 | Контекст метрики |
+| Caption | Inter | 10px | 400 | Подвалы страниц, атрибуция источников |
+
+### Цветовая палитра
+
+```css
+--color-primary: #0A2540;     /* Фирменный тёмно-синий TeamFlow — заголовки, основной акцентный цвет */
+--color-accent: #F2A900;      /* Янтарный TeamFlow — выделения, рамки KPI, CTA */
+--color-text: #1A1A1A;         /* Основной текст (почти чёрный) */
+--color-text-muted: #6B6B6B;   /* Вторичный текст */
+--color-bg: #FFFFFF;           /* Фон страницы */
+--color-bg-alt: #F7F9FB;       /* Фон callout, чередующиеся строки */
+--color-success: #22A06B;      /* Зелёные метрики, позитивные сигналы */
+--color-warning: #E67E22;      /* Янтарные предупреждения */
+--color-danger: #C0392B;       /* Красные алерты, метрики масштаба боли */
+--color-border: #E1E4E8;       /* Деликатные рамки, разделители таблиц */
+```
+
+**Обоснование сдержанной палитры:** Executive-аудитория B2B SaaS положительно реагирует на профессиональный, ориентированный на данные стиль. Слишком много цветов → «потребительский» вид. Зелёный / янтарный / красный — только для метрик с эмоциональной нагрузкой.
+
+### Система отступов (сетка 8pt)
+
+- `--space-1: 4px` (плотно — между связанными элементами)
+- `--space-2: 8px` (отступ элементов списка)
+- `--space-3: 16px` (интервал между абзацами)
+- `--space-4: 24px` (между разделами на странице)
+- `--space-5: 32px` (между крупными блоками)
+- `--space-6: 48px` (редко — шапка страницы / hero)
+
+---
+
+## Ключевые визуализации (детальные спецификации)
+
+### 1. KPI-карточка (страницы 2, 3, 11)
+
+**Анатомия:**
+```
+┌─────────────────────────────────┐
+│ [янтарная левая рамка 3px]       │
+│                                  │
+│    40               ← крупное    │
+│    ────              число       │
+│    Target Team Tier  (32px 700)  │
+│    Upgrades (Q2)  ← подпись      │
+│                      (11px 500)  │
+└─────────────────────────────────┘
+```
+
+**Правила:**
+- Максимум 1 число на карточку
+- Подпись максимум 1-2 строки
+- Группировать в сетки по 3 (правило трёх)
+- Цвет числа по настроению: основной синий (по умолчанию) / зелёный успех / красный опасность
+
+**Примеры для TeamFlow:**
+- Страница 2: «40 целевых апгрейдов» / «+$8 надбавка за место» / «3 ч сэкономлено в неделю»
+- Страница 3 (боль): «3-4 ч admin/неделю» / «40% action items теряется» / «0% видимости у VP» (все красные)
+
+### 2. Pull Quote (страницы 2, 3, 5)
+
+**Анатомия:**
+```
+┌──────────────────────────────────────────┐
+│▐ «Текст цитаты в Source Serif Pro,       │
+│▐  20px, межстрочный 1.4. Привлекает      │
+│▐  взгляд, но не слишком крупный.»        │
+└──────────────────────────────────────────┘
+                        — Атрибуция (12px 400 приглушённый)
+```
+
+**Правила:**
+- Использовать для ключевого vision statement или дословной цитаты клиента
+- Максимум 1-2 на странице
+- Строка атрибуции выровнена вправо, приглушённый цвет
+- Левая рамка 3px акцентного цвета; фон alt
+
+### 3. Callout Box (все страницы)
+
+**Варианты:**
+- Нейтральный (акцентная рамка)
+- Успех (зелёная рамка — позитивный сигнал)
+- Предупреждение (янтарная рамка — на что обратить внимание)
+- Опасность (красная рамка — риск / критическое)
+
+**Анатомия:**
+```
+┌──────────────────────────────────────────┐
+│▐ Ожидаемый результат  ← заголовок 600
+│▐ Текст описания, перенос строк...
+└──────────────────────────────────────────┘
+```
+
+### 4. Metric Tree (страницы 4, 8)
+
+**Анатомия:**
+```
+         NSM: Sticky Manager Ratio (AI Tier)
+         ┌─────────────┼─────────────┐
+         ▼             ▼             ▼
+    Входные:       Входные:     Ограждения:
+  Конверсии        Уровень       NPS, Churn,
+  в новый tier     активации     объём Support
+```
+
+**Реализация:** SVG (для точности) или Mermaid (для редактируемости). TeamFlow предпочитает SVG из Figma.
+
+### 5. Roadmap Columns (страница 12)
+
+**Анатомия:**
+```
+┌─────────────┐ ┌─────────────┐ ┌─────────────┐
+│ [accent top] │ │ [accent top] │ │ [accent top] │
+│ NOW          │ │ NEXT         │ │ LATER        │
+│ (Q2 2026)    │ │ (Q3 2026)    │ │ (Q4+)        │
+├─────────────┤ ├─────────────┤ ├─────────────┤
+│ ✨ AI Summary│ │ 📊 Dashboard │ │ 🌍 Multi-lang│
+│ ✨ Action items│ │ ⏱️ Real-time  │ │ 📱 Mobile app│
+│ 🔐 SSO/SCIM  │ │ 🎯 Health Sc.│ │ 🔍 AI Coach  │
+└─────────────┘ └─────────────┘ └─────────────┘
+```
+
+**Правила:**
+- 3-5 элементов в столбце (не перегружать)
+- Emoji-префикс как подсказка категории (✨ фича / 🔐 безопасность / 📊 аналитика)
+- Вертикальная линия между элементами для удобства сканирования
+- Верхняя рамка акцентного цвета поддерживает присутствие бренда
+
+### 6. Матрица рисков (страница 9)
+
+**Реализация:** сетка 2×2, показывающая вероятность × влияние:
+
+```
+           НИЗКОЕ ВЛИЯНИЕ     ВЫСОКОЕ ВЛИЯНИЕ
+ВЫСОКАЯ  ┌──────────────┬──────────────┐
+ ВЕРОЯТ. │ мониторинг    │ ⚠️ ТОП РИСКИ │
+         │               │ R1, R2, R3   │
+         ├──────────────┼──────────────┤
+НИЗКАЯ   │ приемлемо     │ список слежки│
+ ВЕРОЯТ. │               │ R4, R5       │
+         └──────────────┴──────────────┘
+```
+
+**Под матрицей:** детальная таблица top 5 рисков с колонками: #, Риск, Вероятность, Влияние, Меры снижения.
+
+---
+
+## Библиотека компонентов для Layouter
+
+**Файлы:** папка `components/` в design handoff
+
+| Компонент | Файл | Использование |
+|-----------|------|--------------|
+| `kpi-card.html` | Сниппет | Витрины метрик |
+| `pull-quote.html` | Сниппет | Vision statements, цитаты клиентов |
+| `callout-[variant].html` | 4 сниппета | Предупреждения, успехи, инфо |
+| `roadmap-columns.html` | Сниппет | Только страница 12 |
+| `metric-tree.svg` | Ассет | Страницы 4 + 8 |
+| `risk-matrix.svg` | Ассет | Страница 9 |
+| `page-footer.html` | Сниппет | Все страницы |
+| `meta-bar.html` | Сниппет | Все страницы |
+
+---
+
+## Спецификации передачи дизайна Layouter'у
+
+### CSS-токены
+
+Все стили определены как CSS custom properties (см. вывод Layouter'а). Обеспечивают:
+- Лёгкую перекраску для white-label
+- Единообразие отступов и размеров
+- Готовность к тёмной теме в будущем (токены легко переопределяются)
+
+### Спецификации для печати
+
+- `@page { size: A4 portrait; margin: 2cm 1.8cm; }` — стандартный A4
+- `.page { page-break-after: always; }` — каждый крупный раздел на отдельной странице
+- `page-break-inside: avoid` на таблицах + callouts — предотвращает неудобные разрывы
+- `print-color-adjust: exact` — сохраняет фирменные цвета при печати
+
+### Подключение шрифтов
+
+- **Встроенные шрифты** в генерации PDF для единообразия:
+  - Inter (все насыщенности): [ссылка Google Fonts CSS — OK для web, но для PDF встраивать WOFF2 локально]
+  - Source Serif Pro: аналогично — встраивать для PDF
+- **Фолбэки** при отсутствии шрифтов: `-apple-system, sans-serif` (Inter), `Georgia, serif` (Source Serif Pro)
+
+### Пакет ассетов
+
+- Логотип TeamFlow (SVG + PNG 2×)
+- Логотипы партнёров (если референсируются кейс-стади): сравнение с Lattice и т.д.
+- Иконки (lucide-react или аналог — SVG inline)
+- Изображения графиков (экспортированные PNG 2× из Figma для сложных диаграмм)
+
+---
+
+## Требования доступности (WCAG AA)
+
+- **Цветовой контраст:** весь текст ≥ 4.5:1 к фону (проверено: основной синий на белом = 11:1)
+- **Семантический HTML:** иерархия `<section>`, `<article>`, `<h1-h6>` корректна
+- **Alt text** на всех изображениях и SVG
+- **Состояния фокуса** видимы (если deck интерактивен) — не важно для PDF, но важно, если HTML доступен онлайн
+- **Подписи для экранных читалок** на статус-бейджах, иконках
+
+---
+
+## Deliverables для Layouter (handoff)
+
+- [x] Этот документ design spec (markdown)
+- [x] Файл CSS-токенов (`tokens.css`)
+- [x] Папка HTML-сниппетов (`components/`)
+- [x] SVG-ассеты (`assets/`)
+- [x] Файлы шрифтов (WOFF2 встроенные)
+- [x] Справочный лист по цвету / типографике (1-страничный PDF для быстрой справки)
+- [x] Figma-файл со всеми макетами экранов (hi-fi, экспортированные страницы) [ссылка]
+- [x] Манифест экспорта ассетов (какие изображения в каких размерах)
+
+---
+
+## Требуется согласование
+
+- [ ] PM (Alex K.) — точность содержания
+- [ ] Руководитель дизайна (Jordan M.) — визуальные стандарты
+- [ ] Бренд-команда — соответствие идентичности TeamFlow
+- [ ] Технический руководитель (Priya S.) — осуществимость с точки зрения верстки
+
+Целевая дата согласования: 20 мая 2026. Окно производства верстки: 21 мая — 10 июня. Финальный deck готов к запуску 30 июня.
+
+---
+
+### Сводная карта акцентов (Emphasis Map)
+
+| Страница | Акцент | Элементы |
+|:--------:|:------:|----------|
+| 1 Обложка | Hero | Заголовок 42px, подзаголовок, акцентная полоса бренда |
+| 2 TL;DR | Hero | Pull quote, 3 KPI-карточки, разделители секций |
+| 3 Проблема | Key | 3 красных KPI, 2 callout с дословными цитатами |
+| 4 Возможность | Key | Metric tree, стрелки влияния |
+| 5 Стратегия | Key | Vision quote, tier-архитектура |
+| 6 Scope | Key | Таблица MoSCoW, обоснование |
+| 7 UX | Supporting | 4 миниатюры вайрфреймов, флоу |
+| 8 Метрики | Key | Metric tree (второй), таблица целей |
+| 9 Риски | Key | Матрица 2×2 + таблица top 5 |
+| 10 Rollout | Supporting | Таймлайн по неделям (плотный, но детальный) |
+| 11 Инвестиции | Key | График 3 сценариев, разбивка затрат |
+| 12 Roadmap | Supporting | 3 колонки Now/Next/Later |
+```
+
+> **Урок report-design:** Design spec = контракт между Designer и Layouter. CSS-токены + библиотека компонентов превращают разовую работу страница за страницей в системную сборку. **Emphasis map** не позволяет всем страницам быть одинаково громкими = информационный шум. Executive-аудитория = сдержанная палитра + плотный, но чистый контент. **Требования доступности** (WCAG AA) — обязательны для mid-market + enterprise закупок; библиотека компонентов повторно используется для будущих decks (Product Review Q3 и т.д.) — инвестиция накапливается.