Дата публикации: 27 октября 2026 года

Разработчик Хейден Смит (Hayden Smith) открыл исходный код Floorplan. Инструмент помогает как индивидуальным разработчикам, так и командам получить более наглядное и детальное представление о кодовой базе. Floorplan показывает, как компоненты связаны между собой и как работает приложение в целом.

Установка

Floorplan реализован как плагин для Claude. Установка занимает около 30 секунд и требует двух команд. Команды выводятся на экран и приведены в файле readme репозитория на GitHub.

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

• командой;
• запросом внутри Claude, например: «Make me a floorplan».

Генерация схемы занимает несколько минут.

Принцип работы

На этапе генерации Claude выполняет две задачи:

1. Структурный анализ. Предустановленные скрипты картируют всю кодовую базу и выявляют основную часть связей между компонентами.
2. Семантический анализ. Claude определяет назначение компонентов системы, причины их взаимосвязей, характер этих связей и функции блоков кода в приложении.

По завершении генерации Floorplan запускает веб-сервер с интерфейсом, построенным на основе кодовой базы пользователя.

Обзор интерфейса

В качестве примера приведена гипотетическая компания-разработчик программного обеспечения Brewline.

Общий вид (Overview)

На вкладке Overview отображается наиболее абстрагированная карта системы. В примере показаны:

• интернет-магазин (online shop);
• приложение для сотрудников (staff app);
• основной сервер (main server);
• сервисы, с которыми связан основной сервер.

В левом нижнем углу расположена экскурсия Start here. Она последовательно знакомит с основными частями приложения и описывает характер связей между ними.

Панель деталей

Правая боковая панель отображает детали выбранного элемента. На вкладке Overview она содержит общее описание системы. При выборе сервера, например основного сервера, панель показывает детали компонентов, входящих в этот сервер.

Подсветка изменений

Компоненты с недавними изменениями в кодовой базе помечаются зелёным индикатором. При генерации схемы Claude анализирует последние изменения и сообщает:

• почему изменён компонент;
• что именно изменено;
• как изменение влияет на приложение в целом.

Детали изменений доступны в карточках. В примере у основного сервера зафиксировано несколько изменений.

Верхняя панель

Вкладка Recent work

Вкладка Recent work содержит сводный список недавних изменений с указанием их расположения в приложении. Если в проекте есть фронтенд, элементы группируются по экранам.

В примере выбрана страница подписок (subscriptions page). Для неё отображаются:

• взаимодействие между фронтендом и бэкендом;
• маршруты (routes), их связи и расположение;
• имя каждого маршрута.

По правому клику на карточке доступны:

• просмотр подробных сведений;
• копирование имени конечной точки (endpoint name);
• копирование имени;
• открытие файла в выбранном редакторе кода.

Потоки данных (Flows)

Claude автоматически генерирует потоки (flows), то есть наиболее значимые пользовательские сценарии и потоки данных в приложении. По умолчанию создаются три потока. Пользователь может запросить создание нового потока, если какой-либо сценарий остаётся непонятным. Claude построит карту для запрошенного потока.

В примере показан поток отправки подарочной подписки (sending gift subscription). Шаги потока отображаются в верхней части экрана. Страницы магазина (shop pages) связаны с базовыми блоками (building blocks). Переход по шагам сопровождается пояснением того, как поток реализован в коде приложения.

Детализация

Двойной щелчок по элементу открывает более глубокий уровень. В примере открывается внутренняя структура основного сервера. На этом уровне отображаются:

• входные данные;
• компоненты, которые используют данную логику;
• основные компоненты логики;
• компоненты, которые использует данный элемент.

Детализацию можно продолжать на любом уровне.

Хранение данных и зависимости

• Все карты хранятся локально. Данные не передаются за пределы компьютера пользователя.
• Работа выполняется через существующую подписку на Claude Code.
• Floorplan не имеет внешних зависимостей. Внешние API-ключи не требуются.

Вопросы к системе

При наличии Claude Code CLI пользователь может задавать вопросы о системе. Например, простой запрос explain на обзорной странице запускает изолированный экземпляр Claude Code. Его контекст формируется через вызовы функций, которые обращаются к построенной карте кода.

Экземпляр выполняет вызовы функций и поиск, после чего формирует:

• визуальное представление наиболее значимых элементов;
• текстовое описание.

Пользователь может выбрать конкретный компонент и задать вопрос о нём. Это сужает поиск до интересующей области.

Обновление схемы

Схему можно создать заново или обновить. Для обновления достаточно попросить Claude обновить схему для репозитория. Claude выявляет изменения и обрабатывает только те части приложения, которые требуют обновления.

Схему также можно адаптировать под терминологию команды. Например, запрос на переименование элемента «main server» в «back end server» изменяет название в схеме. Приведённый пример является простым, но иллюстрирует принцип.

Общий доступ и хранение файлов

Созданные файлы можно передавать другим участникам команды. Папка floorplan добавляется в .gitignore автоматически, поэтому в репозиторий она не попадает. Все файлы находятся в одной папке floorplan.

Итоги

• Floorplan распространяется бесплатно, с открытым исходным кодом, по лицензии MIT.
• Установка выполняется двумя командами и занимает около 30 секунд.
• Генерация схемы занимает несколько минут.
• Инструмент применим к любым существующим проектам.