Floorplan — интерактивная карта вашего приложения, которую рисует Claude или Codex
📂 Исходный код на GitHubFloorplan (v0.8.0, MIT) — плагин для Claude Code и Codex, который читает кодовую базу и собирает интерактивную карту приложения в одном HTML-файле: части, файлы, экраны и эндпоинты с понятными названиями, связи между репозиториями, Health check типичных ошибок ИИ-приложений, режим недавних изменений и чертежи из PRD. Скрипты на чистом Node без зависимостей, всё работает локально.
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 никогда не показывает и не сохраняет сами значения секретов — только их расположение.
Подробности — в документации о приватности, а страница «Безопасно ли ставить?» перечисляет всё, что скилл делает на компьютере, и объясняет, как проверить целостность установленной копии.