Floorplan — интерактивная карта вашего приложения, которую рисует Claude или Codex

· 6 мин чтения
skills claude-code codex architecture visualization
📂 Исходный код на GitHub

Floorplan (v0.8.0, MIT) — плагин для Claude Code и Codex, который читает кодовую базу и собирает интерактивную карту приложения в одном HTML-файле: части, файлы, экраны и эндпоинты с понятными названиями, связи между репозиториями, Health check типичных ошибок ИИ-приложений, режим недавних изменений и чертежи из PRD. Скрипты на чистом Node без зависимостей, всё работает локально.

Floorplan — интерактивная карта вашего приложения, которую рисует Claude или Codex

Floorplan — скилл-плагин для Claude Code и Codex. Вы просите агента «нарисовать план приложения», он читает кодовую базу и через несколько минут выдаёт интерактивную карту: каждая часть системы, файл и веб-запрос получают понятное название и короткое описание, а все связи между ними показаны на схеме. Карта сохраняется в проект как один самодостаточный HTML-файл и открывается в браузере.

Проект написан на JavaScript с нулевой зависимостью, распространяется по лицензии MIT и меньше чем за месяц собрал больше 4000 звёзд на GitHub. Есть живое демо с картой вымышленного кофейного сервиса и видео-обзор.

Зачем это нужно

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

Floorplan рисует ту схему, которую никто не нарисовал. Автор описывает три сценария:

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

Что вы получаете

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

Понятные названия вместо жаргона. Вместо «обёртка Stripe API» — «принимает оплату картой при оформлении заказа». Технические термины объясняются при наведении, а одним переключателем карта переводится в вид для разработчика.

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

Вход от экрана. Выбираете знакомую страницу и видите всё, что за ней стоит: её части, запросы, серверный код, данные и внешние сервисы.

Вопросы к карте. Спрашиваете «как возврат доходит до карты клиента?» — получаете ответ, мини-карту задействованных частей и пошаговый разбор.

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

Дополнительно: экспорт карты в один HTML-файл для отправки коллегам, вёрстка для телефонов и планшетов с перетаскиванием и щипком, поиск, горячие клавиши и действия по правому клику на каждой карточке.

Health check

Отдельная проверка ловит классические ошибки приложений, собранных с ИИ:

  • ключи API в коде или отправляемые в браузер;
  • таблицы Supabase, доступные для чтения кому угодно;
  • незакрытые правила безопасности Firebase;
  • Stripe-вебхуки, которые можно подделать;
  • эндпоинты без проверки входа в систему.

Каждая находка сопровождается готовым промптом для исправления в один клик. Авторы подчёркивают: это проверка, а не полноценный аудит.

Чертёж вместо кода

Floorplan рассчитан на уже написанный код, но умеет планировать и то, чего ещё нет. Поделитесь PRD, спецификацией или просто описанием задуманного — скилл нарисует чертёж: такую же карту будущих частей, файлов, эндпоинтов и экранов. Карточки помечены пунктиром, вместо Health check вы получаете разбор того, что план не решает, а у каждой части есть готовый запрос «построй это с Claude». План можно менять прямо с карты («добавь ещё и возвраты»), а когда код появится, чертёж превращается в карту реального приложения.

Как это устроено

Конвейер простой:

Кодовая база → Скан (файлы, импорты, маршруты, запросы)
            → Claude или Codex (называет части, описывает файлы)
            → Сборка карты, health check, экранов, недавней работы
            → floorplan/index.html в браузере

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

Внутри скилла — набор скриптов (scan, describe, refresh, build и другие) и три файла данных: architecture.json с частями и потоками, descriptions/*.json с названиями файлов и маршрутов, а также сгенерированные graph.json и index.html. При обновлении карты заново читаются только изменившиеся файлы: скрипт сравнивает отпечатки содержимого, переносит описания к переименованным файлам и помечает то, что требует повторного просмотра. Открытая карта перезагружается сама.

Поддерживаемые технологии:

Что распознаётся
Языки TypeScript, JavaScript, Python, Go, Rust, Java, Kotlin, Scala, плюс Vue, Svelte и Astro
Эндпоинты Express, Fastify, Koa, Hono, Next.js, Firebase Cloud Functions, Flask, FastAPI, Django, net/http, Gin, Echo, chi, Actix, Axum, Spring и таблицы маршрутов вида "GET /api/orders": listOrders
Экраны Next.js, React Router, Vue, SvelteKit, Remix, Nuxt, Astro, Expo, Angular, TanStack

В проект добавляется только папка floorplan/, а в Claude Code — по вашему согласию — ещё короткий раздел в CLAUDE.local.md. И то и другое исключено из git: ваш .gitignore и другие отслеживаемые файлы не трогаются.

Установка и быстрый старт

Нужны Node.js 18+ и Claude Code или Codex. Скилл работает на вашем текущем тарифе, без отдельных API-ключей.

Claude Code (в десктоп-приложении или CLI):

claude plugin marketplace add haydenschmitty/floorplan
claude plugin install floorplan@floorplan

Codex — в приложении через раздел Plugins («Add a marketplace» → haydenschmitty/floorplan) или из терминала:

codex plugin marketplace add haydenschmitty/floorplan
codex plugin add floorplan@floorplan

Дальше откройте проект и попросите: «Make me a floorplan of this app» (в Codex можно набрать $floorplan). Карта откроется сама и начнётся короткий тур. После работы над кодом скажите «Update the floorplan» — перечитается только изменённое.

Примеры запросов от авторов:

Агенту Карте
«Сделай план этого приложения» «Что происходит, когда кто-то оформляет заказ?»
«Обнови план» «Где мы обращаемся к Stripe?»
«Исправь важные находки из Health check» «Если поменять таблицу users, что сломается?»
«Добавь поток регистрации нового пользователя» «Какие файлы отвечают за вход?»
«Перепиши план для разработчиков» «Что мы изменили ради возвратов?»
«Экспортируй план, чтобы отправить команде»

Есть и режим работы без сессии агента — в CI или собственных скриптах, с любой моделью.

Floorplan, Archify или Understand Anything?

Все три инструмента превращают код в картинку, но отвечают на разные вопросы:

Floorplan Archify Understand Anything
Вопрос Как устроено приложение, которое я собрал, и о чём стоит волноваться? Как наглядно это показать? Как устроена большая кодовая база, до функций?
Для кого Для тех, кто строит с ИИ и не читает код Для всех, кто объясняет систему, процесс или идею Для разработчиков, осваивающих крупный проект
Результат Масштабируемая карта приложения: части, файлы, эндпоинты, экраны, запросы между фронтендом и бэкендом, внешние сервисы Готовая диаграмма одного из 10 типов или одностраничное объяснение Граф знаний по каждому файлу, функции и классу, с турами и доменным видом
Только здесь Health check, недавняя работа агента, чертежи из PRD 10 типов диаграмм, экспорт в картинку и видео, диаграммы не только кода Оценка влияния изменений, дашборд под роль, графы базы знаний

Короткое правило из README: Floorplan — чтобы понять и проверить своё приложение, Archify — чтобы нарисовать диаграмму для документа или доклада, Understand Anything — чтобы штудировать чужую кодовую базу функцию за функцией.

Приватность и безопасность

  • Скан, карта и её локальный сервер работают на вашей машине; сервер принимает соединения только с вашего же компьютера.
  • Карта работает офлайн: движок раскладки и шрифты встроены.
  • Никаких зависимостей, установочных скриптов и аналитики; единственный внешний запрос — добровольная подписка на новости Floorplan Cloud.
  • Вопросы из карты идут через ваш аккаунт в Claude Code CLI или Codex: агент может читать код, но не менять его.
  • Health check никогда не показывает и не сохраняет сами значения секретов — только их расположение.

Подробности — в документации о приватности, а страница «Безопасно ли ставить?» перечисляет всё, что скилл делает на компьютере, и объясняет, как проверить целостность установленной копии.

Источник: https://github.com/haydenschmitty/floorplan