Автоматизация

От промпта к архитектуре: архитектурная диаграмма из текста с помощью ИИ

Практический разбор: опишите систему одним предложением, сгенерируйте черновую архитектурную диаграмму из текста, а затем доведите её до того, что действительно можно положить в дизайн-документ.

Труднее всего нарисовать первый блок. Вы примерно представляете систему в голове, но чтобы превратить это в фигуры на холсте, нужно принять десятки мелких решений, прежде чем появится хоть что-то, на что можно реагировать. Именно здесь архитектурная диаграмма из текста по-настоящему меняет процесс: вы сначала описываете систему словами и получаете черновик за секунды, а с черновиком спорить гораздо проще, чем с пустым местом.

Вот весь цикл от начала до конца на реальном примере. Цель не волшебная готовая диаграмма, а достаточно хороший первый вариант, который вы потом доводите до правильного состояния вручную.

Шаг 1: напишите одно честное предложение

Не усложняйте промпт. Опишите систему так, как описали бы новому коллеге. Назовите части и то, как они связаны.

промпт
A web app with a CDN in front, a load balancer,
two stateless API servers, a Postgres primary
with one read replica, a Redis cache, and a
background worker reading from a queue.

В этом предложении есть всё, что нужно первому черновику: компоненты, разветвление (два API-сервера), слой данных (основная база плюс реплика) и асинхронный путь (воркер плюс очередь). Вы не просите инструмент быть изобретательным. Вы просите его расставить то, что уже сказали.

Шаг 2: получите диаграмму архитектуры, созданную ИИ

Вставьте это в диалог генерации, и вы получите разложенную диаграмму из настоящих редактируемых фигур. Ценность здесь в скорости и полноте: каждый названный компонент оказывается на холсте, примерно в правильных отношениях, за то время, пока вы читали предложение.

CDN balancer api 1 api 2 primary replica redis worker
Всё из предложения расставлено. Теперь начинается настоящая работа: сделать диаграмму правильной.

Шаг 3: исправьте то, что машина угадала

Этот шаг отличает полезный инструмент от фокуса. Черновик это догадка, а догадки ошибаются в мелочах. Может быть, кэш должен стоять перед базой данных, а не рядом с ней. Может быть, к реплике обращается только один API-сервер. Поскольку результат состоит из редактируемых фигур, исправление сводится к перетаскиванию и кликам, а не к тому, чтобы начинать заново.

  • Переместите части, которые раскладка поставила не туда.
  • Нарисуйте пропущенную связь или удалите выдуманную.
  • Выделите важный путь (скажем, путь записи), чтобы взгляд читателя сразу попадал туда.
  • Сгруппируйте части, относящиеся к одному сервису или одной команде.

Промпт приводит вас к черновику. Ваши правки приводят к истине. Человек нужен только на одном из этих шагов, и это второй.

Шаг 4: уточняйте просьбами, а не только перетаскиванием

Не обязательно делать всё вручную. Если форма системы в целом верна, но нужен вариант, просто попросите: "добавь объектное хранилище для загрузок" или "поставь API-шлюз перед сервисами". Используйте диалог как быстрый способ получить следующий черновик, а затем возвращайтесь к редактированию. Два режима, разговор и перетаскивание, усиливают друг друга.

Совет. Делайте промпты маленькими и итеративными. Одно чёткое изменение на запрос лучше абзаца инструкций. Его проще проверить и проще отменить, если модель ошиблась.

Шаг 5: превратите её в настоящий артефакт

Диаграмма, которая живёт только у вас в голове, никому не помогает. Когда картинка верна, поместите её туда, где ей будут пользоваться. Экспортируйте в PNG, SVG или PDF для дизайн-документа. Встройте в README как представление только для чтения. Или экспортируйте в Mermaid или D2, чтобы текстовая версия попала в pull request и прошла ревью как код.

Вот полный цикл: предложение становится черновиком, черновик становится правильным благодаря вашим правкам, а правильная диаграмма становится тем, чем команда действительно может пользоваться. ИИ убрал самую медленную и наименее ценную часть (расстановку блоков) и оставил вам ту, что требует суждения. Опишите свою следующую систему одним предложением и посмотрите, как далеко вас продвинет первый черновик.

Опишите систему и получите диаграмму для доработки

Напишите одно предложение, получите черновую архитектуру из редактируемых фигур и сделайте её своей за минуты.

Открыть LetDraw бесплатно