Код есть, схемы нет: ИИ рисует архитектуру проекта

Код есть, схемы нет

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

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

Что это за инструмент и как он работает

Репозиторий oh-my-mermaid (команда называется omm) создан 22 марта 2026 года. На 10 октября у него 2618 звёзд и 215 форков. Лицензия MIT, я проверил по файлу LICENSE: можно использовать, в том числе в коммерческих проектах, и менять.

Ставится так: npm install -g oh-my-mermaid, затем omm setup. Нужен Node.js 18 или новее. Команда setup подключает инструмент к тем ИИ-помощникам, которые найдёт на компьютере. В README их пять: Claude Code, Codex, Cursor, OpenClaw и Antigravity. Дальше в самом помощнике запускают команду /omm-scan, а результат смотрят командой omm view в браузере на своём компьютере.

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

Схемы он строит по «ракурсам». В инструкции их двенадцать: общая архитектура, путь запроса, потоки данных, карта зависимостей, внешние интеграции, переходы состояний, карта страниц, хранилища и другие. У каждого узла до семи полей, среди них описание, ограничения, риски и «что доделать».

Вот пример формата. Это несколько строк из схемы, которую инструмент построил для самого себя (файл .omm/overall-architecture/diagram.mmd в репозитории):

graph LR
    cli["CLI Dispatcher\nsrc/cli.ts"]
    commands["Commands\nsrc/commands/"]
    store["Store\nsrc/lib/store.ts"]
    cloud["Cloud Client\nsrc/lib/cloud.ts"]
    cli -->|"dispatches args to"| commands
    commands -->|"read/write .omm/"| store
    commands -->|"push/pull via REST"| cloud

Блоки с названиями папок и стрелки с подписью, зачем они связаны. Файлы лежат текстом, их можно передать вместе с кодом.

Куда уходит код

В пакете инструмента нет ни модели, ни ключей доступа: из зависимостей только библиотека разбора YAML. Файлы проекта читает ваш ИИ-помощник и отправляет их своему провайдеру. Если это Claude Code, код уходит в Anthropic. Если Codex, обычно в OpenAI. Cursor отправляет файлы выбранной в нём облачной модели. Для закрытого проекта заказчика это третья сторона, и согласия на неё в договоре со студией может не быть.

Есть и второй канал, необязательный. Команды omm login, link и push отправляют содержимое папки .omm (схемы и текстовые описания) на сервис ohmymermaid.com. По README проект там приватный по умолчанию. Исходники при этом не передаются, это я проверил по коду команды push. Но в описаниях лежат пути к файлам и заметки о рисках, то есть готовая карта слабых мест. Если схема не должна покидать компанию, эту команду не запускают.

Можно ли пустить инструмент на локальной модели, README не говорит. Зависит от помощника, но задача многошаговая, и со слабой локальной моделью я бы ждал мусора. Это моё предположение, не проверенное. Про безопасность помощников с ИИ я собрал восемь вопросов подрядчику, а про разбор кода без облака есть отдельная статья.

Что важно учесть

ИИ придумывает связи. Он читает код, но не запускает его, поэтому может нарисовать стрелку, которой нет, или не заметить настоящую, которая идёт через базу или очередь. Проверка синтаксиса в инструменте убеждается только в том, что Mermaid нарисуется. Верность схемы никто не проверяет, это работа человека, который знает проект.

Проект молодой и держится на одном человеке. В основной ветке 17 коммитов, 14 из них у одного автора, остальные три разовые. Последний коммит 7 апреля 2026 года, последний релиз 0.2.0 от 25 марта. В трекере открыты несколько исправлений без слияния, среди них поддержка Windows. Есть и жалоба, что setup на Windows не находит установленный Claude Code. Развития можно не дождаться.

Про большие проекты автор пишет честно: параллельный скан и обновление только изменённых частей стоят в планах (docs/ROADMAP.md). Пока скан идёт одной длинной сессией помощника. Сколько он занимает времени и токенов на репозитории в сотни тысяч строк, я не измерял, цифр в проекте нет. И сам omm на чужом проекте я не запускал, всё выше взято из репозитория.

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

Принимаете проект от студии. Добавьте в акт передачи схему системы и попросите указать, чем она получена. Если сгенерирована, пусть студия сверит её со своим знанием проекта.

Хотите сначала понять, что купили. Попросите нового подрядчика прогнать скан на копии проекта без файлов с паролями и ключами (.env и им подобных) и показать результат. Это входит в технический аудит, например в IT-аудит.

Код закрытый. Сначала спросите, какой ИИ-помощник у исполнителя и куда он отправляет файлы, и проверьте, что договор на разработку это допускает.

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

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

Нужен ли отдельный ключ или подписка для omm?

Нет. У инструмента своей модели нет, он работает с вашим ИИ-помощником и тратит его лимиты. Если у вас есть Claude Code, Codex или Cursor, дополнительно платить за omm не нужно.

Что с правами на схемы?

Лицензия MIT относится к самому инструменту. Схемы описывают ваш код, а права на код определяет договор с подрядчиком.

Не страшно, что проект не обновляется с апреля?

Для разовой генерации нет. Результат это текстовые файлы, они откроются в любом редакторе с поддержкой Mermaid и не зависят от сервиса. Для регулярной работы в команде риск есть: чинить Windows и новые версии помощников придётся самим.

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

oh-my-mermaid делает то, что обычно не успевают сделать при сдаче проекта: показывает на схеме, из чего состоит система. Лицензия MIT, ставится за минуту. Цена вопроса: код читает облачная модель вашего ИИ-помощника, а в схеме могут оказаться выдуманные связи.

Принимаете проект, который никто не описал, или хотите проверить, что отдаёт студия? Напишите мне в Telegram слово «ДИАГРАММА». Скажу, как получить схему на вашем коде, не отдав его лишним людям, и кто её сверит.