Диаграммы как код (Diagrams as Code) · diagrams-as-code
АрхитектураЧастота употребления: средняя· Сложность: 3/5· Актуальность: 5/5· Тренд: растёт
Подход, при котором диаграммы описываются текстом в репозитории и рендерятся автоматически.
Подробно
Diagrams as Code — практика, когда схема задаётся не в графическом редакторе, а текстовым описанием (например, на Mermaid), которое хранится рядом с кодом и версионируется. Это позволяет ревьюить изменения диаграмм через pull request, получать диффы вместо картинок и автоматически обновлять документацию в CI. Подход применяется в архитектурной документации, описании потоков данных и последовательностей вызовов. Проект archify использует эту идею в связке с ИИ-агентами: описание идеи, плана или кодовой базы превращается в интерактивную диаграмму автоматически.
Примеры употребления
- sequenceDiagram в README рендерится GitHub автоматически — отдельный редактор не нужен.
- Изменение схемы пришло в pull request диффом на 10 строк Mermaid.
- В CI настроили проверку, что Mermaid-схемы в docs/ валидны.
- Archify генерирует diagrams-as-code из существующей кодовой базы.