Архитектура, логика и бизнес-процессы в одном месте.
Документация хранится текстом в открытых форматах. ArchMap показывает её человеку как интерактивные схемы и отдаёт агенту через MCP-сервер.
Объекты, связи и ссылки на код описаны в YAML. Алгоритмы обработчиков и воркеров нарисованы в Mermaid. Проект целиком выгружается архивом и загружается обратно.
nodes: - name: Сервис заказов shape: service children: - name: Order API technology: Python/FastAPI source: repo: github.com/yarmarka/orders
flowchart TD
A[Принять состав корзины]
A --> B{Позиций не больше лимита?}
B -- Нет --> C[422: слишком много позиций]Любой контейнер можно раскрыть прямо на схеме или открыть как отдельный уровень, а связи между уровнями остаются видны. Архитектуру собирают в редакторе схем, процессы в редакторе диаграмм последовательности.
Как устроена вложенность →
Один запрос ищет по всему проекту: объекты, схемы логики, спецификации OpenAPI, структуру БД, каналы брокера, конфигурацию и процессы. Агент подкрепляет свой пересказ ссылками на конкретные объекты и документы.
Агент как помощник в заполнении →# запрос агента archmap_search( project="Ярмарка", query="422 too many items in order") # ответ: где это встречается Order API › Создание заказа Конфигурация › MAX_ITEMS_PER_ORDER Процесс «Оформление заказа» › шаг 3
В C4 слой контейнеров один. В большой системе контейнеры вложены друг в друга: платформа состоит из продуктов, продукт из сервисов, сервис из модулей. C4 отлично подходит для общей картины, но не рассчитан на то, чтобы сервис на пятом уровне был описан так же подробно, как система на первом.
Четыре фиксированных уровня. Контейнер внутри контейнера описать нельзя.
Контейнер может содержать контейнеры. Уровней столько, сколько их в вашей системе.
Сервис, который встречается на нескольких схемах, существует в одном экземпляре. Переименуйте его один раз, и он обновится везде.
Под каждый уровень принято рисовать отдельную схему: контекст, затем контейнеры на новом холсте, затем компоненты. Одни и те же объекты повторяются на нескольких схемах, и каждую приходится обновлять вручную.
В ArchMap схема одна. Раскройте систему, и диаграмма контекста станет диаграммой контейнеров. Раскройте контейнер, и она станет диаграммой компонентов. Попробуйте сами.
Контейнер раскрывается в рамку и показывает содержимое, соседи остаются на экране. Раскрывать можно до двух уровней вглубь, чтобы схема оставалась читаемой.
У каждого контейнера есть собственная схема: свои объекты, связи и раскладка. Путь виден над схемой, вернуться наверх можно одним кликом.
Связь можно провести между объектами с разных уровней. На схеме родителя она показывается от ближайшего предка, а объект с другого уровня отображается как внешний.
Стрелки обходят объекты, пересечения рисуются мостиками, подписи ставятся в свободные места. Вы расставляете объекты, остальное считает движок.
Любой узел схемы хранит свою документацию: схемы логики, спецификацию OpenAPI, структуру базы, каналы брокера с полями сообщений, параметры конфигурации и ссылку на репозиторий. Всё открывается прямо со схемы.
Процесс описывается диаграммой последовательности. Конструктор позволяет её составить из участников, которые уже описаны в архитектуре. Если по ходу процесса возникает вопрос, как именно сервис выполняет конкретный шаг, из схемы процесса можно одной кнопкой перейти в схему логики этого сервиса и увидеть алгоритм целиком.
У объекта три состояния: работает, проектируется, выводится. Цвет показывает, что уже в проде, что только планируется и что скоро исчезнет. Держать разные версии диаграммы не нужно.
Есть в проде. Описан по коду: ссылка на репозиторий, спецификация, схемы логики.
Место на схеме и связи уже есть, кода ещё нет. Будущее состояние видно рядом с текущим.
Устаревший путь отправки SMS. Его функцию перенимает другой воркер, этот удалят после переключения.
Документацию в ArchMap пишет человек. Но если расписывать всё с нуля не хочется, черновик может собрать ваш агент по готовым промптам из ArchMap.
Сам ArchMap к репозиторию и AI-провайдерам не подключается: вы запускаете промпт своим агентом в своём репозитории, а полученные файлы вставляете в ArchMap.
В нём порядок обследования репозитория, правила именования и чек-лист самопроверки. Рассчитан и на слабые модели.
Claude Code, Cursor или любой другой агент с доступом к коду. Если репозиториев несколько, тот же промпт запускается в каждом.
Файлы из разных репозиториев сливаются в один проект. Если они противоречат друг другу, ArchMap показывает, в каком файле проблема, и ничего не записывает до вашего решения.
Повторный прогон не перезаписывает схему, а показывает план правок: что появилось, изменилось или пропало.
Результат нужно проверять. Промпты выверены до запятой. Но агенты не дают детерминированного результата, так что их схемы могут быть неточными. Зато править готовый черновик обычно быстрее, чем описывать систему с нуля.
Импорт файлов от нескольких агентов. Если файлы не сливаются в проект идеально, ArchMap подскажет, как их объединить.
ArchMap открыт и ставится на свой сервер. Данные хранятся в вашей PostgreSQL.
заглушка адрес репозитория, лицензию и точную команду запуска подставим после публикации репозитория.