Architecture Documentation

Понимает основные типы архитектурной документации: system overview, component diagrams, sequence diagrams, deployment diagrams. Знает нотацию C4 model на базовом уровне. Умеет документировать простые архитектурные решения по шаблону.

Самостоятельно применяет модель C4 и arc42 для документирования архитектуры сервисов команды и их интеграций. Составляет ADR, чётко фиксирующие контекст, решение и последствия технических выборов. Понимает компромиссы между инструментами diagram-as-code (Structurizr, PlantUML) и визуальными редакторами. Поддерживает документацию в соответствии с CI/CD-пайплайнами и топологией деплоя.

Самостоятельно инициирует создание ADR для ключевых продуктовых решений с техническим обоснованием. Ревьюит архитектурную документацию на соответствие продуктовым требованиям. Ведёт актуальный реестр технических решений.

Создаёт полноценную архитектурную документацию совместно с архитекторами: system context, container diagrams, component diagrams (C4). Документирует data flows, интеграции со внешними системами, deployment topology. Поддерживает документацию в актуальном состоянии.

Проектирует сквозную архитектурную документацию на всех четырёх уровнях C4 — от контекста системы до кода. Создаёт комплексную документацию arc42, охватывающую требования к качеству, представления времени выполнения и сценарии деплоя. Менторит инженеров по написанию эффективных ADR, фиксирующих архитектурные драйверы, рассмотренные альтернативы и анализ компромиссов. Масштабирует практики документирования на несколько доменов решений с использованием шаблонов и автоматизированной валидации.

Проектирует стратегию архитектурной документации для сложных мультисервисных систем с использованием C4 и arc42. Устанавливает конвенции ADR, включая нумерацию, состояния жизненного цикла и правила замещения. Менторит разработчиков по созданию содержательных диаграмм компонентов и контейнеров вместо поверхностных обзоров. Интегрирует генерацию документации в CI-пайплайны с использованием Structurizr DSL или аналогичных инструментов diagram-as-code.

Формирует процесс архитектурного документирования для продукта, включая RFC и design docs. Определяет шаблоны технических спецификаций с учётом бизнес-контекста. Обеспечивает трассируемость от бизнес-требований к архитектурным решениям.

Проектирует структуру и процесс ведения архитектурной документации для крупных систем. Внедряет diagrams-as-code подход (Mermaid, PlantUML, Structurizr DSL). Обеспечивает связность между ADR, архитектурными диаграммами и API-документацией.

Определяет стратегию архитектурной документации на уровне продукта и портфолио с использованием C4 и arc42 как канонических фреймворков. Устанавливает управление документацией, включая контрольные точки ревью, политики актуальности и стандарты согласованности между командами. Проводит архитектурные ревью, обеспечивая фиксацию точек интеграции, сценариев атрибутов качества и ограничений деплоя. Продвигает внедрение ADR как основного механизма фиксации и коммуникации архитектурных решений.

Определяет стратегию архитектурной документации на уровне команды и продукта, выбирая подходящую глубину C4 и разделы arc42 в зависимости от критичности сервиса. Устанавливает лучшие практики создания ADR, включая шаблоны, рабочие процессы статусов и привязку к PR реализации. Проводит регулярные ревью архитектурной документации для предотвращения расхождений между диаграммами и реальным состоянием системы. Продвигает культуру documentation-as-code с автоматизированным рендерингом и пайплайнами публикации.

Определяет стандарты архитектурной документации для подразделения. Внедряет culture of writing — design docs, RFCs, post-mortems как обязательные артефакты. Интегрирует архитектурные решения в product roadmap.

Определяет стандарты архитектурной документации для организации: обязательные артефакты, уровни детализации, процесс review. Координирует архитектурную документацию между командами, обеспечивая единую картину системного ландшафта.

Определяет стратегию архитектурной документации на уровне организации, устанавливая корпоративные стандарты C4 и arc42 для всех доменов решений. Создаёт федеративную модель управления документацией, обеспечивающую автономию команд при сохранении архитектурной согласованности на уровне предприятия. Формирует репозитории ADR со сквозным поиском, анализом влияния и управлением архитектурными знаниями. Менторит лидов и архитекторов по развитию практик документирования для поддержки масштабирования организации, интеграции при M&A и согласования с technology radar.

Определяет стратегию архитектурной документации на уровне организации, стандартизируя использование C4 и arc42 по всем инженерным подразделениям. Устанавливает корпоративное управление ADR с централизованными реестрами, межсменным связыванием и автоматическим обнаружением устаревания. Продвигает внедрение инструментальных цепочек архитектурной документации (Structurizr, Backstage, функции архитектурной пригодности) в масштабе. Менторит лидов и архитекторов по построению самоподдерживающихся экосистем документации, сохраняющих точность по мере развития организации.

Формирует enterprise-подход к управлению архитектурными знаниями. Определяет governance-процесс для cross-team архитектурных решений, строит базу знаний по техническим trade-offs на уровне организации.

Формирует стратегию архитектурных знаний компании: единый architecture knowledge base, связь с enterprise architecture, governance процессы. Определяет как архитектурная документация поддерживает принятие стратегических технических решений.