Разработка 4 мин чтения

Stack Diagram: ИИ рисует схему системы, но её надо сверять

Stack Diagram по одной фразе строит схему стека с логотипами. Я прочитал репозиторий и объясняю, чем схема по описанию отличается от реальной системы и что сверить перед ТЗ, приёмкой и передачей проекта.

Stack Diagramархитектурная схемапередача проектаТЗ
Коротко. Stack Diagram (репозиторий caru-ini/stack-diagram, лицензия MIT, создан 1 ноября 2026 года) это навык для ИИ-помощника: вы пишете одной фразой, из чего состоит стек, и получаете схему с логотипами в виде HTML-файла, PNG или React-компонента. Работает с Claude Code, Codex и Cursor. Схема строится по вашему описанию, а не по коду и серверам, поэтому показывает задуманное. Перед тем как класть её в ТЗ, КП или акт передачи, её нужно сверить с реальностью по пяти пунктам ниже.
Хотите внедрить это у себя?

Сделаю под ключ: разберу задачу, назову срок и цену. Чтобы начать, напишите в Telegram одной фразой.

Технический IT-аудит со сверкой схемы

Красивая схема в КП и другая система на сервере

Представьте типичную ситуацию. Студия сдаёт проект бота: в приложении к договору красивая схема, на ней Telegram, сервер, база, очередь, мониторинг и резервные копии. Через полгода выясняется, что очереди нет, мониторинг выключен, а копии лежат на том же сервере, что и база. Её нарисовали по описанию, и она показывала, как было задумано.

Такая картинка нужна в четырёх местах: в ТЗ (как составить ТЗ на сайт или бота), в КП, при приёмке и при передаче проекта другой команде. Получить её теперь можно за минуты, а вот верить ей можно не всегда.

Что за проект и что я проверил

Проверял 18.11.2026 по репозиторию caru-ini/stack-diagram и его файлам. Описание авторов: навык агента, который по фразе о стеке строит архитектурную схему с официальными логотипами. Создан 1 ноября 2026, не архивирован, около 2,6 тысячи звёзд и 140 форков. Шесть релизов, от v0.1.0 (1 ноября) до v0.6.0 (13 ноября), последний коммит 16 ноября. Около 34 коммитов, пять авторов, но почти всё сделал владелец. Открыт один issue. Проекту три недели, версии нулевые.

Лицензия MIT на код и документацию, шрифты (Geist, JetBrains Mono) под SIL OFL 1.1. Подключение по README: команда npx skills add caru-ini/stack-diagram, работает с Claude Code, Codex, Cursor и другими агентами, которые поддерживают навыки. Саму установку я не запускал.

Вход: текстовое описание стека. В SKILL.md шаг первый называется «Content», узлы берутся «из списка технологий пользователя». Скриптов, которые читают код, Docker-файлы, Terraform или сервер, в репозитории нет: только fetch_icons.py, build.py, render_png.py и share.py. Выход: один самодостаточный HTML-файл (основной), из него PNG в светлой и тёмной теме и React-компонент без зависимостей. Файл можно править руками, но координаты расставлены вручную, так что правки проще поручить агенту. Экспорта в draw.io или Visio я не нашёл.

Логотипы: откуда берутся и что с правами

Логотипы в навык не встроены. По README и коду fetch_icons.py они скачиваются при сборке из svgl, devicon, gilbarbara/logos, а для AWS, Google Cloud, Azure и Kubernetes из официальных наборов вендоров. Это я проверил запуском: иконки для моего примера скачались с svgl.app, GitHub и jsdelivr. Туда уходят названия технологий из вашего описания. После сборки всё вшито в HTML, и файл открывается без сети. Публикация в галерею stacks.caru.moe по описанию в SKILL.md только после двух явных «да» и показа содержимого.

Про товарные знаки я сверил то, что смог открыть. Страница AWS Architecture Icons разрешает клиентам и партнёрам использовать иконки в диаграммах, а также в whitepaper, презентациях, описаниях продукта и плакатах. Страница Microsoft разрешает Azure-иконки в архитектурных диаграммах, обучающих материалах и документации, просит не обрезать, не отражать, не искажать их и не использовать для обозначения своего продукта. Условия Google Cloud я не подтвердил: страница не открылась целиком. Правила Telegram, PostgreSQL, Python и остальных не проверял. Практическое правило для КП: логотип ставится только у того продукта, который он обозначает, и не изображает партнёрство. Это моя практика, не юридический вывод.

Пример: бот в Telegram со всей обвязкой

Я описал типичный стек: пользователь пишет в Telegram, бот на Python работает на сервере в Docker, данные в PostgreSQL, задачи в очереди на Redis, мониторинг на Prometheus и Grafana, резервные копии по расписанию. Проект я не запускал как навык в агенте: скрипты fetch_icons и build отработали у меня, раскладку по правилам SKILL.md сделал сам. Встроенный рендер PNG в моей среде не стартовал (Chromium не запустился), снимок получил через Edge.

Получилось восемь узлов, рамка сервера, подписанные стрелки и легенда, выглядит как чертёж. У очереди и копий брендового знака нет, они стали пиктограммами. Кириллица шла запасным шрифтом, встроенные шрифты латинские. Теперь о том, чего на схеме нет: версий, портов, адресов, способа получения сообщений от Telegram (я написал «обновления» и сознательно не уточнил), места хранения копий, владельцев аккаунтов, срока хранения. И всё это выглядит так же уверенно, как проверенное.

Чек-лист: что сверить со схемой

Перед тем как схема попадёт в договор или акт, пройдите пять пунктов:

  • Процессы. Список контейнеров и служб на сервере против узлов схемы. Лишние и недостающие записать.
  • Конфиги. Реальные адреса, переменные окружения и режим связи с Telegram (webhook или опрос) против подписей на стрелках.
  • Сервер. Где физически работает система, какие порты открыты, что доступно снаружи.
  • Данные и копии. Где лежит база, куда уходят копии, и было ли хоть одно восстановление из копии.
  • Доступы и владельцы. На кого оформлены аккаунты, кто получает уведомления мониторинга, где хранятся ключи.

Схему по готовому коду строит oh-my-mermaid, но и там связи надо проверять.

Где это не сработает

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

Что можно сделать уже сейчас

  1. Попросите текущего подрядчика описать стек одной фразой и сравните с тем, что видите на сервере. Расхождения уже ответ.
  2. Получите схему этим навыком или любым другим способом и отметьте на ней карандашом, что проверено, а что нет.
  3. Пройдите пять пунктов чек-листа и запишите результат рядом со схемой: дата, кто проверял.
  4. Положите схему и протокол сверки в приложение к ТЗ или акту передачи. Про остальное прочтите в статьях про граф знаний по чужому коду при передаче проекта и про доступы и документацию.

Частые вопросы

Схема по описанию считается документацией проекта?

Только после сверки. Без неё это рисунок намерений. В акт лучше вписать дату сверки и список того, что проверено.

Нужно ли платить за инструмент?

Сам навык бесплатный, MIT. Платить придётся за ваш ИИ-помощник и за время того, кто проверит схему. Сумму за сверку по вашей системе обсудим отдельно.

Можно ли свериться автоматически?

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

Коротко о главном

Stack Diagram быстро даёт читаемую схему с логотипами по одной фразе, бесплатно и без своего сервера. Но схема показывает намерение: она не знает, что запущено, где лежат копии и кто владеет аккаунтами. Сверка с кодом, конфигами и сервером превращает картинку в документ, который можно приложить к ТЗ и акту.

Нужна схема для ТЗ, сверка перед приёмкой или документы для передачи проекта? Технический аудит включает такую сверку. Напишите мне в Telegram, MAX или VK кодовое слово «ПОДМАСТЕРЬЕ», и я скажу, что проверять у вас.

Обсудим вашу задачу

Что я делаю для бизнеса

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

  • Боты в Telegram, MAX, VK
  • Автоматизация процессов и CRM
  • Аналитика и дашборды
  • Сайты и лендинги под ключ
Пишу о разработке, ИИ и законах для бизнеса

Разборы, кейсы и практика — без воды. Выходит регулярно, читать 3–5 минут.

Готовые решения под ключTurnkey solutionsSoluciones llave en mano交钥匙解决方案Түлхүүр гардуулах шийдэл 451 готовых IT-решений для бизнеса451 ready-made IT solutions for business451 soluciones IT listas para empresas451 个面向企业的现成 IT 解决方案Бизнест зориулсан 451 бэлэн IT шийдэл Автоматизация, боты, AI, 152-ФЗ и платформы · бесплатная консультацияAutomation, bots, AI, data privacy and platforms · free consultationAutomatización, bots, IA, privacidad de datos y plataformas · consulta gratis自动化、机器人、AI、数据合规与平台 · 免费咨询Автоматжуулалт, бот, AI, өгөгдлийн хамгаалалт ба платформ · үнэгүй зөвлөгөө Смотреть каталогView catalogVer catálogo查看目录Каталог үзэх