Домен
Документация
Профиль навыка
Диаграммы как код: Mermaid, PlantUML, D2, diagram versioning, auto-generation
Ролей
8
где встречается этот навык
Грейдов
5
сформированная дорожка роста
Обязательных требований
27
ещё 9 — необязательные
Документация
Docs-as-Code
17.03.2026
Выберите текущий грейд и сравните ожидания. Карточки ниже покажут, что нужно закрыть для следующего уровня.
Таблица показывает, как меняется глубина владения навыком от Junior до Principal.
| Роль | Обязательность | Описание |
|---|---|---|
| Game Designer | Создаёт простые диаграммы игровых систем: flowchart core loop, схемы взаимодействия механик, mind maps игрового контента. Использует Miro, draw.io или Figma для визуализации game design идей. Понимает основные нотации для описания игровых потоков. | |
| Product Manager | Обязателен | Создаёт диаграммы для визуализации product concepts: user flows, wireframes, process maps. Использует Miro, Figma, draw.io. |
| Security Analyst | Понимает основы Diagramming. Применяет базовые практики в повседневной работе. Следует рекомендациям команды. | |
| Technical Product Manager | Обязателен | Умеет читать и создавать базовые диаграммы: flowcharts, sequence diagrams, user flows. Использует Miro, Lucidchart или draw.io для визуализации продуктовых процессов. Понимает нотацию UML на базовом уровне. |
| Technical Writer | Обязателен | Владеет базовыми инструментами диаграммирования: draw.io, Lucidchart, Miro. Умеет создавать простые диаграммы: блок-схемы, sequence diagrams, mind maps. Знает основные нотации: UML basics, flowcharts, network diagrams. |
| Роль | Обязательность | Описание |
|---|---|---|
| Engineering Manager | Использует Mermaid, PlantUML или D2 для создания схем процессов, оргструктур и визуализации роадмапов. Понимает, когда применять sequence- или flowchart-диаграммы. Самостоятельно документирует рабочие процессы команды. | |
| Game Designer | Создаёт детальные диаграммы игровых систем: state machines для AI-поведения, flow диаграммы progression, схемы экономического цикла (sink/source). Визуализирует зависимости между игровыми системами. Использует UML для описания сложных взаимодействий. | |
| Product Manager | Обязателен | Создаёт комплексные визуализации: service blueprints, system maps, impact maps. Использует диаграммы для stakeholder communication. |
| Security Analyst | Применяет Mermaid, PlantUML или D2 для построения диаграмм моделей угроз, базовых деревьев атак и карт сетевой топологии. Понимает компромиссы между форматами диаграмм для ИБ-документации. Самостоятельно создаёт визуализации инцидентов. | |
| Technical Lead | Использует Mermaid, PlantUML или D2 для технических дизайн-документов, диаграмм компонентов и визуализации потоков данных. Выбирает подходящий тип диаграммы для моделирования взаимодействий. Самостоятельно создаёт архитектурные эскизы для команды. | |
| Technical Product Manager | Обязателен | Создаёт технические диаграммы для продуктовых спецификаций: sequence diagrams для API-взаимодействий, data flow diagrams, state machines. Использует C4-модель для документирования архитектуры на разных уровнях. |
| Technical Writer | Обязателен | Создаёт сложные технические диаграммы: C4 model (все 4 уровня), data flow diagrams, state machines, ER-диаграммы. Использует diagrams-as-code инструменты (Mermaid, PlantUML). Следит за визуальной consistency и читаемостью диаграмм. |
| Роль | Обязательность | Описание |
|---|---|---|
| Engineering Manager | Обязателен | Проектирует комплексные системы визуализации процессов и роадмапов с помощью Mermaid, PlantUML или D2. Создаёт стандартизированные шаблоны оргструктур и коммуникаций. Менторит команду по эффективному использованию диаграмм для презентаций и кросс-командного согласования. |
| Game Designer | Проектирует комплексные визуализации игровых систем: системные диаграммы всей игры, dependency graphs между механиками, data flow для live-ops pipeline. Создаёт интерактивные схемы для презентации game design решений stakeholders. Документирует архитектуру системно. | |
| Product Manager | Обязателен | Мастерски визуализирует сложные концепции. Создаёт стратегические визуализации: wardley maps, ecosystem maps, opportunity landscapes. |
| Security Analyst | Обязателен | Проектирует production-grade диаграммы моделей угроз, многоуровневые деревья атак и детальные карты сетевой топологии с помощью Mermaid, PlantUML или D2. Оптимизирует сложность диаграмм для плейбуков реагирования на инциденты. Менторит аналитиков по практикам ИБ-диаграммирования. |
| Solutions Architect | Обязателен | Проектирует production-grade диаграммы модели C4, визуализации интеграционных паттернов и карты архитектуры развёртывания с помощью Mermaid, PlantUML или D2. Оптимизирует слои диаграмм для разных аудиторий. Менторит команды по стандартам архитектурного диаграммирования. |
| Technical Lead | Обязателен | Проектирует production-grade диаграммы компонентов, детальные визуализации потоков данных и sequence-диаграммы сложных систем с помощью Mermaid, PlantUML или D2. Оптимизирует техдокументацию многоуровневыми диаграммами. Менторит инженеров по практикам дизайн-документации. |
| Technical Product Manager | Обязателен | Проектирует комплексные архитектурные диаграммы для cross-team alignment: system context, container и component level. Создаёт dynamic diagrams для сложных workflows. Определяет стандарты визуализации для команд. |
| Technical Writer | Обязателен | Проектирует visual language и стандарты диаграммирования для проекта. Внедряет diagrams-as-code подход: Mermaid/PlantUML в Git, автогенерация из кода, CI-валидация. Создаёт интерактивные диаграммы для developer portal (clickable architecture maps). |
| Роль | Обязательность | Описание |
|---|---|---|
| Engineering Manager | Обязателен | Определяет стратегию диаграммирования для командных коммуникаций, документирования процессов и визуализации роадмапов. Устанавливает стандарты ведения оргструктур, диаграмм рабочих процессов и визуалов для отчётности. Проводит ревью качества диаграмм в рамках продуктового направления. |
| Game Designer | Определяет стандарты визуального документирования для game design команды. Формирует библиотеку шаблонов диаграмм: economy flows, system architectures, player journey maps. Обучает команду эффективной визуальной коммуникации game design решений. | |
| Product Manager | Обязателен | Стандартизирует визуальные стандарты для подразделения. Определяет diagramming guidelines и templates. |
| Security Analyst | Обязателен | Определяет стратегию диаграммирования для моделирования угроз, визуализации поверхности атак и документирования реагирования на инциденты. Устанавливает стандарты ИБ-архитектурных диаграмм, карт топологии и визуалов комплаенса. Проводит ревью точности и полноты ИБ-диаграмм. |
| Solutions Architect | Обязателен | Определяет стратегию диаграммирования системной архитектуры, внедрения модели C4 и документирования интеграционных паттернов на уровне продукта. Устанавливает стандарты диаграмм развёртывания, визуалов инфраструктуры и ADR. Проводит ревью консистентности архитектурных диаграмм. |
| Technical Lead | Обязателен | Определяет стратегию диаграммирования для технической дизайн-документации, моделирования компонентов и визуализации потоков данных на уровне команды. Устанавливает стандарты sequence-диаграмм, визуалов API-взаимодействий и карт границ систем. Проводит ревью ясности и точности техдиаграмм. |
| Technical Product Manager | Обязателен | Определяет стандарты и шаблоны диаграмм для продуктового подразделения. Внедряет diagrams-as-code подход (Mermaid, PlantUML) с версионированием. Обучает команды эффективной визуальной коммуникации архитектурных решений. |
| Technical Writer | Обязателен | Определяет организационные стандарты визуализации технической информации: нотации, инструменты, color schemes, шаблоны. Координирует создание unified system landscape diagrams, объединяющих знания разных команд. Обучает технике визуализации. |
| Роль | Обязательность | Описание |
|---|---|---|
| Engineering Manager | Обязателен | Определяет стратегию диаграммирования на уровне организации для документирования процессов, визуалов кросс-командных коммуникаций и презентации стратегических роадмапов. Устанавливает корпоративные стандарты диаграмм процессов и оргструктур. Менторит лидов по визуальной коммуникации для руководства. |
| Game Designer | Формирует культуру визуальной коммуникации на уровне студии. Создаёт методологию документирования сложных игровых систем через диаграммы. Определяет enterprise-инструменты и стандарты для визуализации game design на уровне нескольких проектов. | |
| Product Manager | Обязателен | Использует strategic visual tools для corporate-level communication. Визуализирует portfolio strategy. |
| Security Analyst | Обязателен | Определяет стратегию диаграммирования на уровне организации для корпоративного моделирования угроз, документирования ИБ-архитектуры и визуалов комплаенс-отчётности. Устанавливает корпоративные подходы к картированию поверхности атак и диаграммированию реагирования. Менторит лидов и архитекторов по стандартам ИБ-визуализации. |
| Solutions Architect | Обязателен | Определяет стратегию диаграммирования на уровне организации для корпоративной архитектуры, управления моделью C4 и стандартизации интеграционных паттернов. Устанавливает корпоративные подходы к диаграммам развёртывания и инфраструктуры. Менторит лидов и архитекторов по зрелости архитектурной визуализации. |
| Technical Lead | Обязателен | Определяет стратегию диаграммирования на уровне организации для технической дизайн-документации, стандартов моделирования компонентов и паттернов визуализации потоков данных. Устанавливает корпоративные подходы к sequence-диаграммам и картированию границ систем. Менторит лидов и архитекторов по качеству техдиаграммирования. |
| Technical Product Manager | Обязателен | Формирует enterprise-подход к визуальной документации архитектуры. Определяет catalog of diagram types для разных stakeholders. Интегрирует диаграммы в developer portal и architecture repository организации. |
| Technical Writer | Обязателен | Формирует стратегию визуализации технических знаний на уровне компании. Определяет инструментарий и подходы к автоматизации диаграммирования. Обеспечивает, чтобы визуальная документация была living documentation, отражающей реальное состояние систем. |