Перейти к содержимому

Архитектура

Ориентируйтесь в коде, который писали не вы.

Откройте репозиторий, и Panolayer построит карту его архитектуры: модули, функции, классы, вызывающий код и зависимости. Карта строится разбором исходного кода, а не генерируется моделью, поэтому один и тот же код всегда даёт одну и ту же карту. С ней работаете вы, ваши агенты и Panolayer Verification Engine.

Скачать PanolayerЧитать документацию

Публичная бета для macOS. Бесплатный старт, банковская карта не нужна.

Архитектура

Вы на три уровня углубились в сервис и пытаетесь понять, что его вызывает.

Дерево файлов показывает, где лежит код, но не показывает, что от него зависит. Ещё сложнее, когда код написал агент и у вас есть только diff на тысячу строк. Panolayer строит карту зависимостей, поэтому вы перемещаетесь по системе визуально — по тому, что что вызывает, а не по папкам.

Что с этим можно делать

01 / Архитектура

Начните со всей системы

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

Начните со всей системы

02 / Архитектура

Углубляйтесь до нужного уровня

Откройте сервис, чтобы увидеть его модули, затем модуль — чтобы увидеть его функции. Представления в виде диаграммы, колонок и путей показывают одну и ту же структуру тремя способами, так что можно выбрать самое наглядное для кода, с которым вы работаете.

03 / Архитектура

Читайте любую функцию в контексте

Откройте getPrice() и увидите, что она делает, что принимает и возвращает, что её вызывает, от чего она зависит, какие правила к ней применяются и проходит ли она сейчас проверку. Иначе всё это пришлось бы собирать по пяти файлам и через поиск.

Читайте любую функцию в контексте

04 / Архитектура

Узнайте, куда дойдёт изменение

Прежде чем просить агента перевести getPrice() с центов на доллары, проверьте, что её вызывает: страница товара, корзина и оформление заказа. Panolayer следует по графу зависимостей от любой функции, поэтому вы знаете, что может затронуть изменение, ещё до того, как его кто-то внесёт.

05 / Архитектура

Ваши агенты видят ту же карту

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

06 / Архитектура

Документация, которая не отстаёт

Живые документы создаются на основе архитектуры и синхронизируются с ней по мере изменения кода, поэтому документация описывает систему такой, какая она сейчас, а не такой, какой она была при последнем обновлении.

Panolayer помнит ваш проект

Каждый новый сеанс агента начинается с нуля. Вы снова объясняете те же соглашения, те же ограничения и ту же причину, по которой никто не трогает ту самую миграцию. Panolayer хранит структурированную память о вашем проекте между сеансами: принятые решения, соглашения и ограничения, историю миграций и то, как исправлялись прошлые ошибки. Чем дольше вы работаете с кодовой базой в Panolayer, тем реже приходится повторяться.

Вопросы

Диаграмму генерирует LLM?

Нет. Она строится разбором исходного кода. По вашему запросу модели могут добавлять описания простым языком, но структуру они не определяют.

Можно ли пользоваться картой архитектуры, не запуская агентов?

Да. Откройте репозиторий и используйте карту, чтобы ориентироваться в коде, который писали не вы.

Какие языки поддерживаются?

TypeScript, JavaScript, Python, Go, Rust, Java и другие. Динамические вызовы и сгенерированный код сложнее отследить, и они могут требовать более внимательной проверки.

Поддерживаемые языки
Работает ли это с монорепозиторием?

Да.

Попробуйте Panolayer на своей кодовой базе.

Скачать PanolayerЧитать документацию

Публичная бета для macOS. Бесплатный старт, банковская карта не нужна.

Далее: Создание