2.625 estrellas en ocho días: Floorplan, un plugin para Claude Code y Codex creado el 27 de octubre de 2026, pide al agente que lea tu código y dibuje un mapa interactivo de la aplicación, con cada parte, fichero y endpoint HTTP nombrado en lenguaje llano y conectado por sus imports y sus llamadas. Va por la versión 0.6.3, tiene licencia MIT y cero dependencias, y su documentación de seguridad es más detallada que la de muchos plugins con años de vida.
Qué hace
La skill floorplan se activa cuando pides visualizar, mapear o documentar un codebase, entender cómo se conecta el frontend con el backend o actualizar un mapa existente. El reparto de trabajo es lo interesante: unos scripts de Node hacen la parte mecánica (encontrar repos, parsear imports y rutas, casar cada petición HTTP del frontend con el endpoint que la atiende, también entre repos distintos, y maquetar el grafo), y el agente hace lo que solo puede hacer un lector: decidir qué es cada pieza y describirla en una línea.
El resultado es floorplan/index.html en la raíz del proyecto, un mapa con varios niveles de zoom (sistema, parte, grupo de ficheros, fichero y endpoints). Encima trae un Health check que busca claves en el código, tablas de Supabase abiertas, reglas de Firebase permisivas, webhooks de Stripe sin verificar y endpoints sin autenticación; una vista de trabajo reciente que resalta lo que el agente acaba de tocar y por qué; y una barra para preguntar al mapa ("¿qué se rompe si cambio la tabla de usuarios?"). Detecta rutas de Express, Fastify, Next.js, Flask, FastAPI, Django, Spring, Gin, chi, Axum y Firebase Cloud Functions, entre otros.
Cuando el mapa ya existe, refresh.mjs compara huellas de contenido con la última versión y solo pide al agente describir lo nuevo o lo que ha cambiado de interfaz, así que las actualizaciones gastan pocos tokens. Con más de unos 150 ficheros, la skill reparte las descripciones entre subagentes en paralelo.
Cómo instalarla
claude plugin marketplace add haydenschmitty/floorplan
claude plugin install floorplan@floorplanEn Codex, codex plugin marketplace add haydenschmitty/floorplan y codex plugin add floorplan@floorplan. Necesita Node 18 o superior y funciona con tu plan de Claude o ChatGPT, sin claves de API. Después basta con pedir "Make me a floorplan of this app" en una sesión nueva. Hay una demo navegable sin instalar nada.
Riesgos y límites
El SKILL.md declara en allowed-tools ocho comandos que se ejecutan sin pedir permiso mientras la skill está activa, todos node sobre sus propios scripts (build.mjs, describe.mjs, open.mjs, plan.mjs, recent.mjs, refresh.mjs, scan.mjs y status.mjs); el resto pasa por tus permisos habituales. Según su página "Is it safe to install?", no tiene hooks, servidores MCP, dependencias ni scripts de instalación, no usa eval y un test de cadena de suministro lo comprueba en cada cambio. Los programas que lanza son git en solo lectura, node, el abridor del navegador y claude -p o codex exec --sandbox read-only cuando preguntas al mapa.
Lo que sí hace y hay que saber:
- Un servidor local (
floorplan/serve.mjs) escucha en127.0.0.1con un token que solo recibe la página del mapa. - Una sola petición saliente, opcional: la lista de espera de Floorplan Cloud, si escribes tu email en el mapa.
- El Health check decodifica en base64 los tokens que encuentra para clasificarlos; no guarda ni muestra el valor.
- Incluye un fichero minificado de 1,6 MB, el motor de layout elkjs 0.9.3, con su SHA-256 publicado para que lo compares con el paquete de npm.
- Si aceptas, añade un bloque a
CLAUDE.local.mdpara que futuras sesiones consulten el mapa; cambia cómo trabajan esas sesiones, por eso lo ofrece y no lo hace solo.
El límite de fondo es el de cualquier plugin: una actualización trae lo que contenga la última release. El autor publica CHECKSUMS.txt en cada versión y un script para comparar tu copia instalada; en un equipo, fijar la versión y verificarla antes de actualizar es lo razonable. Y el código que el agente lee para describirlo viaja a Anthropic u OpenAI con tu cuenta, como en cualquier otra tarea.
Frente a lo que ya había
El propio README se compara con Archify, que dibuja diagramas pulidos de diez tipos para documentos y presentaciones, y con Understand Anything, que construye un grafo de conocimiento a nivel de función para estudiar codebases grandes. Floorplan se queda en medio: menos detalle que un grafo de funciones, pero con las conexiones reales entre frontend y backend, el Health check y la vista de cambios recientes. Está escrito pensando en quien construye con IA y no lee el código; para un ingeniero, el interés está en la vista de desarrollador, en el mapa entre repos y en usarlo para revisar qué ha tocado el agente tras una tarea larga. Frente a mantener a mano un diagrama en Mermaid, su ventaja es que se regenera solo; su desventaja, que las descripciones son del modelo y hay que revisarlas.
Fuentes
- haydenschmitty/floorplan (GitHub)
- SKILL.md de floorplan (GitHub)
- Is it safe to install? (GitHub)
- Demo de Floorplan (Floorplan)